接口说明
车联网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 } ] } ] } ] }