(未显示1个用户的6个中间版本) | |||
第1行: | 第1行: | ||
{{car-sidebar}} | {{car-sidebar}} | ||
− | < | + | |
− | + | == 接口说明 == | |
+ | <span style="color:red;"> 车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。</span> | ||
+ | |||
用户可根据影片名称/影片id为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。 | 用户可根据影片名称/影片id为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。 | ||
− | ==接口示例== | + | == 接口示例 == |
− | + | ||
− | http://api.map.baidu.com/telematics/v3/movie?qt=search_movie&wd= | + | [http://api.map.baidu.com/telematics/v3/movie?qt=search_movie&wd=大话西游&location=北京&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/movie?qt=search_movie&wd=大话西游&location=北京&ak=E4805d16520de693a3fe707cdc962045] |
− | + | ||
+ | |||
接口参数说明 | 接口参数说明 | ||
+ | |||
{| | {| | ||
− | ! width="80"| 参数类型 | + | |- |
+ | ! width="80" | 参数类型 | ||
! width="80" | 参数名称 | ! width="80" | 参数名称 | ||
− | ! width="80" |是否必须 | + | ! width="80" | 是否必须 |
! width="320" | 具体描述 | ! width="320" | 具体描述 | ||
|- | |- | ||
− | |String | + | | String |
+ | | ak | ||
+ | | true | ||
+ | | 开发者密钥 | ||
|- | |- | ||
− | |String | + | | String |
+ | | sn | ||
+ | | false | ||
+ | | 若用户所用ak的校验方式为sn校验时该参数必须。 ([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法]) | ||
|- | |- | ||
− | |String | + | | String |
+ | | wd | ||
+ | | true | ||
+ | | 输入影片名称或影片uid,例如:泰坦尼克、变形金刚。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | location | ||
+ | | true | ||
+ | | 输入城市名或经纬度,城市名称如:北京或者131,经纬度格式为lng,lat坐标如: location=116.305145,39.982368。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | pn | ||
+ | | false | ||
+ | | 获取指定页面的数据,例如:pn=1。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | rn | ||
+ | | false | ||
+ | | 单页上所获取的数据的数目,默认为10条数据,单页最多可输出20条数据。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | output | ||
+ | | false | ||
+ | | 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | coord_type | ||
+ | | false | ||
+ | | 请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | out_coord_type | ||
+ | | false | ||
+ | | 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。 | ||
|- | |- | ||
− | |String | + | | String |
+ | | callback | ||
+ | | false | ||
+ | | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。 | ||
|} | |} | ||
− | ==返回结果== | + | == 返回结果 == |
{| | {| | ||
|- | |- | ||
− | !width="220" | 参数名称 | + | ! width="220" | 参数名称 |
− | !width="160" | 含义 | + | ! width="160" | 含义 |
− | !width="120" | 说明 | + | ! width="120" | 说明 |
|- | |- | ||
− | |status | + | | status |
− | |返回结果状态信息 | + | | 返回结果状态信息 |
− | |请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。 | + | | 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。 |
|- | |- | ||
− | |results | + | | results |
− | |返回结果 | + | | 返回结果 |
− | | | + | | |
|- | |- | ||
− | |result.item.name | + | | result.item.name |
− | |poi名称 | + | | poi名称 |
− | |如 星美(清河店) | + | | 如 星美(清河店) |
|- | |- | ||
− | |result.item.uid | + | | result.item.uid |
− | |pid id | + | | pid id |
− | | | + | | |
|- | |- | ||
− | |result.item.address | + | | result.item.address |
− | |poi地址 | + | | poi地址 |
− | | | + | | |
|- | |- | ||
− | |result.item.telephone | + | | result.item.telephone |
− | |poi电话 | + | | poi电话 |
− | | | + | | |
|- | |- | ||
− | |result.location | + | | result.location |
− | |当前poi坐标(经纬度) | + | | 当前poi坐标(经纬度) |
− | | | + | | |
|- | |- | ||
− | |result.location.lng | + | | result.location.lng |
− | |经度 | + | | 经度 |
− | | | + | | |
|- | |- | ||
− | |result.location.lat | + | | result.location.lat |
− | |纬度 | + | | 纬度 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table | + | | result.item.time_table |
− | |电影放映信息集合 | + | | 电影放映信息集合 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table.item.time | + | | result.item.time_table.item.time |
− | |影片放映时间 | + | | 影片放映时间 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table.item.date | + | | result.item.time_table.item.date |
− | |影片放映日期 | + | | 影片放映日期 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table.item.lan | + | | result.item.time_table.item.lan |
− | |影片语言 | + | | 影片语言 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table.item.price | + | | result.item.time_table.item.price |
− | |影片价格 | + | | 影片价格 |
− | | | + | | |
|- | |- | ||
− | |result.movie.item.movie_length | + | | result.movie.item.movie_length |
− | |影片时长 | + | | 影片时长 |
− | | | + | | |
|- | |- | ||
− | |result.item.time_table.item.type | + | | result.item.time_table.item.type |
− | |影片类型 | + | | 影片类型 |
− | | | + | | |
|} | |} | ||
− | ==返回xml格式的数据== | + | == 返回xml格式的数据 == |
− | <pre> | + | <pre><?xml version="1.0" encoding="utf-8"?> |
− | <?xml version="1.0" encoding="utf-8"?> | + | |
<telematics> | <telematics> | ||
<error>0</error> | <error>0</error> | ||
第149行: | 第183行: | ||
</pre> | </pre> | ||
− | ==返回json格式的数据== | + | == 返回json格式的数据 == |
− | <pre> | + | <pre>{"error": 0, |
− | {"error": 0, | + | |
"status": "Success", | "status": "Success", | ||
"date": "2014-02-13", | "date": "2014-02-13", |
2020年1月14日 (二) 16:30的最后版本
接口说明
车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。
用户可根据影片名称/影片id为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。
接口示例
接口参数说明
参数类型 | 参数名称 | 是否必须 | 具体描述 |
---|---|---|---|
String | ak | true | 开发者密钥 |
String | sn | false | 若用户所用ak的校验方式为sn校验时该参数必须。 (sn生成算法) |
String | wd | true | 输入影片名称或影片uid,例如:泰坦尼克、变形金刚。 |
String | location | true | 输入城市名或经纬度,城市名称如:北京或者131,经纬度格式为lng,lat坐标如: location=116.305145,39.982368。 |
String | pn | false | 获取指定页面的数据,例如:pn=1。 |
String | rn | false | 单页上所获取的数据的数目,默认为10条数据,单页最多可输出20条数据。 |
String | output | false | 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。 |
String | coord_type | false | 请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。 |
String | out_coord_type | false | 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。 |
String | callback | false | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。 |
返回结果
参数名称 | 含义 | 说明 |
---|---|---|
status | 返回结果状态信息 | 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。 |
results | 返回结果 | |
result.item.name | poi名称 | 如 星美(清河店) |
result.item.uid | pid id | |
result.item.address | poi地址 | |
result.item.telephone | poi电话 | |
result.location | 当前poi坐标(经纬度) | |
result.location.lng | 经度 | |
result.location.lat | 纬度 | |
result.item.time_table | 电影放映信息集合 | |
result.item.time_table.item.time | 影片放映时间 | |
result.item.time_table.item.date | 影片放映日期 | |
result.item.time_table.item.lan | 影片语言 | |
result.item.time_table.item.price | 影片价格 | |
result.movie.item.movie_length | 影片时长 | |
result.item.time_table.item.type | 影片类型 |
返回xml格式的数据
<?xml version="1.0" encoding="utf-8"?> <telematics> <error>0</error> <status>Success</status> <date>2014-02-13</date> <result> <item> <uid>e6bb5f781fdcec46d2f49eda</uid> <name>星空影城(大兴店)</name> <telephone>4006452099</telephone> <location> <lng>116.33367447525</lng> <lat>39.800797380027</lat> </location> <address>大兴区京良路10号乐家购物中心3楼(近兴海公园)</address> <rating>4.0</rating> <time_table> <item> <time>15:20</time> <date>2014-02-13</date> <lan>国语</lan> <type>2D</type> <price>80</price> </item> <item> <time>17:15</time> <date>2014-02-13</date> <lan>国语</lan> <type>2D</type> <price>80</price> </item> </time_table> </item> </result> </telematics>
返回json格式的数据
{"error": 0, "status": "Success", "date": "2014-02-13", "result": [ { "uid": "e6bb5f781fdcec46d2f49eda", "name": "星空影城(大兴店)", "telephone": "4006452099", "location": { "lng": 116.33367447525, "lat": 39.800797380027 }, "address": "大兴区京良路10号乐家购物中心3楼(近兴海公园)", "rating": "4.0", "time_table": [ { "time": "15:20", "date": "2014-02-13", "lan": "国语", "type": "2D", "price": 80 }, { "time": "17:15", "date": "2014-02-13", "lan": "国语", "type": "2D", "price": 80 } ] } ] } ] }