(以“{{car-sidebar}} ==接口说明== 用户可根据影片名称/影片id为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上...”为内容创建页面) |
|||
(未显示3个用户的19个中间版本) | |||
第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="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 | ||
+ | | 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函数名)。 | ||
|} | |} | ||
+ | |||
+ | == 返回结果 == | ||
+ | |||
+ | {| | ||
+ | |- | ||
+ | ! width="220" | 参数名称 | ||
+ | ! width="160" | 含义 | ||
+ | ! width="120" | 说明 | ||
+ | |- | ||
+ | | 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格式的数据 == | ||
+ | <pre><?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> | ||
+ | </pre> | ||
+ | |||
+ | == 返回json格式的数据 == | ||
+ | <pre>{"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 | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | </pre> |
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 } ] } ] } ] }