(→返回结果) |
|||
(未显示3个用户的17个中间版本) | |||
第1行: | 第1行: | ||
{{car-sidebar}} | {{car-sidebar}} | ||
− | ==接口说明== | + | |
+ | == 接口说明 == | ||
+ | <span style="color:red;"> 车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。</span> | ||
+ | |||
用户可根据影院名称/影院uid为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。 | 用户可根据影院名称/影院uid为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。 | ||
− | 接口示例 | + | == 接口示例 == |
− | + | ||
− | http://api.map.baidu.com/telematics/v3/movie?qt=search_cinema&wd=华星&location=北京&ak= | + | [http://api.map.baidu.com/telematics/v3/movie?qt=search_cinema&wd=华星&location=北京&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/movie?qt=search_cinema&wd=华星&location=北京&ak=E4805d16520de693a3fe707cdc962045] |
− | + | ||
+ | == 接口参数说明 == | ||
− | |||
{| | {| | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | ! width="80" | 参数类型 | |
− | | | + | ! width="80" | 参数名称 |
+ | ! width="80" | 是否必须 | ||
+ | ! width="380" | 具体描述 | ||
|- | |- | ||
− | |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 | ||
+ | | 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获取的坐标。 | bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。 | ||
+ | |||
+ | |- | ||
+ | | String | ||
+ | | out_coord_type | ||
+ | | false | ||
+ | | 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。 | ||
|- | |- | ||
− | |String | | + | | String |
+ | | callback | ||
+ | | false | ||
+ | | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。 | ||
|} | |} | ||
− | ==返回结果== | + | |
+ | == 返回结果 == | ||
{| | {| | ||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | ! width="300" | 参数名称 |
− | | | + | ! width="200" | 含义 |
− | | | + | ! width="100" | 说明 |
|- | |- | ||
− | | | + | | status |
+ | | 返回结果状态信息 | ||
+ | | 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。 | ||
|- | |- | ||
− | | | + | | results |
− | | | + | | 返回结果 |
− | + | | | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
− | |result. | + | | result.item.name |
− | | | + | | poi名称 |
− | | | + | | 如 星美(清河店) |
|- | |- | ||
− | |result.item. | + | | result.item.uid |
+ | | pid id | ||
+ | | | ||
|- | |- | ||
− | |result.item. | + | | result.item.address |
+ | | poi地址 | ||
+ | | | ||
|- | |- | ||
− | |result.item. | + | | result.item.telephone |
+ | | poi电话 | ||
+ | | | ||
|- | |- | ||
− | |result. | + | | result.location |
+ | | 当前poi坐标(经纬度) | ||
+ | | | ||
|- | |- | ||
− | |result. | + | | result.location.lng |
+ | | 经度 | ||
+ | | | ||
|- | |- | ||
− | |result. | + | | result.location.lat |
− | | | + | | 纬度 |
− | + | | | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
− | |result.item. | + | | result.item.review.item.content |
+ | | 评论内容 | ||
+ | | | ||
|- | |- | ||
− | |result.item. | + | | result.item.review.item.date |
− | |- | + | | 评论时间 |
− | |result.item.time_table.item. | + | | |
− | |- | + | |- |
− | |result.item.time_table.item. | + | | result.item.movies |
− | |- | + | | 影片信息集合 |
− | |result.item.time_table.item.type | + | | |
+ | |- | ||
+ | | result.item.movies.item.movie_name | ||
+ | | 影片名称 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_type | ||
+ | | 影片类型 | ||
+ | | 如 3D | ||
+ | |- | ||
+ | | result.item.movies.item.movie_release_date | ||
+ | | 影片上映时间 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_nation | ||
+ | | 影片所属国家 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_starring | ||
+ | | 影片演员 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_length | ||
+ | | 影片时长 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_picture | ||
+ | | 影片图片地址 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_score | ||
+ | | 影片评分 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_director | ||
+ | | 影片导演 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_tags | ||
+ | | 影片所属类型 | ||
+ | | | ||
+ | |- | ||
+ | | result.item.movies.item.movie_message | ||
+ | | 影片概要信息 | ||
+ | | | ||
+ | |- | ||
+ | | 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.item.time_table.item.type | ||
+ | | 影片类型 | ||
+ | | | ||
|} | |} | ||
− | ==返回xml格式的数据== | + | == 返回xml格式的数据 == |
+ | <pre><?xml version="1.0" encoding="utf-8"?> | ||
+ | <telematics> | ||
+ | <error>0</error> | ||
+ | <status>Success</status> | ||
+ | <date>2014-02-13</date> | ||
+ | <result> | ||
+ | <item> | ||
+ | <uid>56f2f696939903990aa8d45d</uid> | ||
+ | <name>ume国际影城(华星店)</name> | ||
+ | <telephone>(010)82111601</telephone> | ||
+ | <location> | ||
+ | <lng>116.32575026093</lng> | ||
+ | <lat>39.967836985325</lat> | ||
+ | </location> | ||
+ | <address>北京市海淀区双榆树科学院南路44号(双安商场对面)</address> | ||
+ | <rating>4.4</rating> | ||
+ | <review> | ||
+ | <item> | ||
+ | <content>挺不错的,离学校近,环境音效都很好,电影比较多上映~</content> | ||
+ | <date>14-01-13 21:07:33</date> | ||
+ | </item> | ||
+ | <item> | ||
+ | <content>团购的,环境很好推荐</content> | ||
+ | <date>14-01-16 16:19:43</date> | ||
+ | </item> | ||
+ | <item> | ||
+ | <content>环境非常好!IMAX尤其效果好,感觉人在其中,身临其境!</content> | ||
+ | <date>14-01-13 17:34:10</date> | ||
+ | </item> | ||
+ | </review> | ||
+ | <movies> | ||
+ | <item> | ||
+ | <movie_name>谁说我们不会爱</movie_name> | ||
+ | <movie_type>普通</movie_type> | ||
+ | <movie_nation>中国大陆</movie_nation> | ||
+ | <movie_director>刘宝贤</movie_director> | ||
+ | <movie_starring>杜淳/颖儿/陈廷嘉/高健/张然</movie_starring> | ||
+ | <movie_release_date>2014-02-14</movie_release_date> | ||
+ | <movie_picture>http://Img.wangpiao.com/NewsImage/20141/905327e5-4860-4abc-b92b-bbcc8e5dc44e.jpg</movie_picture> | ||
+ | <movie_length>96分钟</movie_length> | ||
+ | <movie_description> 工体摇曳的霓虹夜色,一群不甘寂寞的青年男女:辛小野、苏小暖以及夏泽成、于左左、钱碎碎、海歌、米粒、戴飞等身份各异的人,因为一场宿醉而彼此纠葛,这种纠葛由酒精催化,也因酒精而升华,彼此在最后都收获了一份感动和认知的爱情故事。 <br/> 伪富二代与文艺女青年的情乱情迷、拜金女与玩物丧志的漫画家梦醒梦碎、强颜欢笑的女领班与青年才俊之间的哀怨纠结,女爷们与伪娘的性情演绎……这并不是命运的阴差阳错,而是深潜在当代年轻人心底的真情爆发。他们伪装,他们放纵,然而当内心深处那份真爱被触动,他们情归原始,万劫不复…… </movie_description> | ||
+ | <movie_score>0.0</movie_score> | ||
+ | <movie_message>不对的时间,不对的地点,遇到了对的人</movie_message> | ||
+ | <movie_tags>爱情,剧情</movie_tags> | ||
+ | <time_table> | ||
+ | <item> | ||
+ | <time>9:50</time> | ||
+ | <date>2014-02-14</date> | ||
+ | <lan>中文</lan> | ||
+ | <type>2D</type> | ||
+ | <price>60</price> | ||
+ | </item> | ||
+ | </movies> | ||
+ | </item> | ||
+ | </time_table> | ||
+ | </result> | ||
+ | </telematics> | ||
+ | </pre> | ||
+ | |||
+ | == 返回json格式的数据 == | ||
+ | <pre>{ | ||
+ | "error": 0, | ||
+ | "status": "Success", | ||
+ | "date": "2014-02-13", | ||
+ | "result": [ | ||
+ | { | ||
+ | "uid": "56f2f696939903990aa8d45d", | ||
+ | "name": "ume国际影城(华星店)", | ||
+ | "telephone": "(010)82111601", | ||
+ | "location": { | ||
+ | "lng": 116.32575026093, | ||
+ | "lat": 39.967836985325 | ||
+ | }, | ||
+ | "address": "北京市海淀区双榆树科学院南路44号(双安商场对面)", | ||
+ | "rating": "4.4", | ||
+ | "review": [ | ||
+ | { | ||
+ | "content": "挺不错的,离学校近,环境音效都很好,电影比较多上映~", | ||
+ | "date": "14-01-13 21:07:33" | ||
+ | }, | ||
+ | { | ||
+ | "content": "团购的,环境很好推荐", | ||
+ | "date": "14-01-16 16:19:43" | ||
+ | }, | ||
+ | { | ||
+ | "content": "环境非常好!IMAX尤其效果好,感觉人在其中,身临其境!", | ||
+ | "date": "14-01-13 17:34:10" | ||
+ | } | ||
+ | ], | ||
+ | "movies": [ | ||
+ | { | ||
+ | "movie_name": "谁说我们不会爱", | ||
+ | "movie_type": "普通", | ||
+ | "movie_nation": "中国大陆", | ||
+ | "movie_director": "刘宝贤", | ||
+ | "movie_starring": "杜淳/颖儿/陈廷嘉/高健/张然", | ||
+ | "movie_release_date": "2014-02-14", | ||
+ | "movie_picture": "http://Img.wangpiao.com/NewsImage/20141/905327e5-4860-4abc-b92b-bbcc8e5dc44e.jpg", | ||
+ | "movie_length": "96分钟", | ||
+ | "movie_description": " 工体摇曳的霓虹夜色,一群不甘寂寞的青年男女:辛小野、苏小暖以及夏泽成、于左左、钱碎碎、海歌、米粒、戴飞等身份各异的人,因为一场宿醉而彼此纠葛,这种纠葛由酒精催化,也因酒精而升华,彼此在最后都收获了一份感动和认知的爱情故事。 | ||
+ | 伪富二代与文艺女青年的情乱情迷、拜金女与玩物丧志的漫画家梦醒梦碎、强颜欢笑的女领班与青年才俊之间的哀怨纠结,女爷们与伪娘的性情演绎……这并不是命运的阴差阳错,而是深潜在当代年轻人心底的真情爆发。他们伪装,他们放纵,然而当内心深处那份真爱被触动,他们情归原始,万劫不复…… ", | ||
+ | "movie_score": "0.0", | ||
+ | "movie_message": "不对的时间,不对的地点,遇到了对的人", | ||
+ | "movie_tags": "爱情,剧情", | ||
+ | "time_table": [ | ||
+ | { | ||
+ | "time": "9:50", | ||
+ | "date": "2014-02-14", | ||
+ | "lan": "中文", | ||
+ | "type": "2D", | ||
+ | "price": 60 | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | </pre> |
2020年1月14日 (二) 16:30的最后版本
接口说明
车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。
用户可根据影院名称/影院uid为关键字,城市名称、城市代码、经纬度坐标为区域范围,检索出正在上映的影片信息。
接口示例
http://api.map.baidu.com/telematics/v3/movie?qt=search_cinema&wd=华星&location=北京&ak=E4805d16520de693a3fe707cdc962045
接口参数说明
参数类型 | 参数名称 | 是否必须 | 具体描述 |
---|---|---|---|
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.review.item.content | 评论内容 | |
result.item.review.item.date | 评论时间 | |
result.item.movies | 影片信息集合 | |
result.item.movies.item.movie_name | 影片名称 | |
result.item.movies.item.movie_type | 影片类型 | 如 3D |
result.item.movies.item.movie_release_date | 影片上映时间 | |
result.item.movies.item.movie_nation | 影片所属国家 | |
result.item.movies.item.movie_starring | 影片演员 | |
result.item.movies.item.movie_length | 影片时长 | |
result.item.movies.item.movie_picture | 影片图片地址 | |
result.item.movies.item.movie_score | 影片评分 | |
result.item.movies.item.movie_director | 影片导演 | |
result.item.movies.item.movie_tags | 影片所属类型 | |
result.item.movies.item.movie_message | 影片概要信息 | |
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.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>56f2f696939903990aa8d45d</uid> <name>ume国际影城(华星店)</name> <telephone>(010)82111601</telephone> <location> <lng>116.32575026093</lng> <lat>39.967836985325</lat> </location> <address>北京市海淀区双榆树科学院南路44号(双安商场对面)</address> <rating>4.4</rating> <review> <item> <content>挺不错的,离学校近,环境音效都很好,电影比较多上映~</content> <date>14-01-13 21:07:33</date> </item> <item> <content>团购的,环境很好推荐</content> <date>14-01-16 16:19:43</date> </item> <item> <content>环境非常好!IMAX尤其效果好,感觉人在其中,身临其境!</content> <date>14-01-13 17:34:10</date> </item> </review> <movies> <item> <movie_name>谁说我们不会爱</movie_name> <movie_type>普通</movie_type> <movie_nation>中国大陆</movie_nation> <movie_director>刘宝贤</movie_director> <movie_starring>杜淳/颖儿/陈廷嘉/高健/张然</movie_starring> <movie_release_date>2014-02-14</movie_release_date> <movie_picture>http://Img.wangpiao.com/NewsImage/20141/905327e5-4860-4abc-b92b-bbcc8e5dc44e.jpg</movie_picture> <movie_length>96分钟</movie_length> <movie_description> 工体摇曳的霓虹夜色,一群不甘寂寞的青年男女:辛小野、苏小暖以及夏泽成、于左左、钱碎碎、海歌、米粒、戴飞等身份各异的人,因为一场宿醉而彼此纠葛,这种纠葛由酒精催化,也因酒精而升华,彼此在最后都收获了一份感动和认知的爱情故事。 <br/> 伪富二代与文艺女青年的情乱情迷、拜金女与玩物丧志的漫画家梦醒梦碎、强颜欢笑的女领班与青年才俊之间的哀怨纠结,女爷们与伪娘的性情演绎……这并不是命运的阴差阳错,而是深潜在当代年轻人心底的真情爆发。他们伪装,他们放纵,然而当内心深处那份真爱被触动,他们情归原始,万劫不复…… </movie_description> <movie_score>0.0</movie_score> <movie_message>不对的时间,不对的地点,遇到了对的人</movie_message> <movie_tags>爱情,剧情</movie_tags> <time_table> <item> <time>9:50</time> <date>2014-02-14</date> <lan>中文</lan> <type>2D</type> <price>60</price> </item> </movies> </item> </time_table> </result> </telematics>
返回json格式的数据
{ "error": 0, "status": "Success", "date": "2014-02-13", "result": [ { "uid": "56f2f696939903990aa8d45d", "name": "ume国际影城(华星店)", "telephone": "(010)82111601", "location": { "lng": 116.32575026093, "lat": 39.967836985325 }, "address": "北京市海淀区双榆树科学院南路44号(双安商场对面)", "rating": "4.4", "review": [ { "content": "挺不错的,离学校近,环境音效都很好,电影比较多上映~", "date": "14-01-13 21:07:33" }, { "content": "团购的,环境很好推荐", "date": "14-01-16 16:19:43" }, { "content": "环境非常好!IMAX尤其效果好,感觉人在其中,身临其境!", "date": "14-01-13 17:34:10" } ], "movies": [ { "movie_name": "谁说我们不会爱", "movie_type": "普通", "movie_nation": "中国大陆", "movie_director": "刘宝贤", "movie_starring": "杜淳/颖儿/陈廷嘉/高健/张然", "movie_release_date": "2014-02-14", "movie_picture": "http://Img.wangpiao.com/NewsImage/20141/905327e5-4860-4abc-b92b-bbcc8e5dc44e.jpg", "movie_length": "96分钟", "movie_description": " 工体摇曳的霓虹夜色,一群不甘寂寞的青年男女:辛小野、苏小暖以及夏泽成、于左左、钱碎碎、海歌、米粒、戴飞等身份各异的人,因为一场宿醉而彼此纠葛,这种纠葛由酒精催化,也因酒精而升华,彼此在最后都收获了一份感动和认知的爱情故事。 伪富二代与文艺女青年的情乱情迷、拜金女与玩物丧志的漫画家梦醒梦碎、强颜欢笑的女领班与青年才俊之间的哀怨纠结,女爷们与伪娘的性情演绎……这并不是命运的阴差阳错,而是深潜在当代年轻人心底的真情爆发。他们伪装,他们放纵,然而当内心深处那份真爱被触动,他们情归原始,万劫不复…… ", "movie_score": "0.0", "movie_message": "不对的时间,不对的地点,遇到了对的人", "movie_tags": "爱情,剧情", "time_table": [ { "time": "9:50", "date": "2014-02-14", "lan": "中文", "type": "2D", "price": 60 } ] } ] } ] }