near-cinema”的版本间的差异

来自Wiki
跳转至: 导航搜索
接口说明
 
第1行: 第1行:
 
{{car-sidebar}}
 
{{car-sidebar}}
==接口说明==
 
  
根据中心点坐标、检索半径、影院关键字查找周边影院、影讯信息。
+
== 接口说明 ==
接口示例
+
<span style="color:red;">&nbsp;&nbsp;&nbsp;&nbsp;车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。</span>
  
http://api.map.baidu.com/telematics/v3/movie?qt=nearby_cinema&location=116.307852,40.057023&ak=E4805d16520de693a3fe707cdc962045
+
根据中心点坐标、检索半径、影院关键字查找周边影院、影讯信息。 接口示例
 +
 
 +
[http://api.map.baidu.com/telematics/v3/movie?qt=nearby_cinema&location=116.307852,40.057023&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/movie?qt=nearby_cinema&location=116.307852,40.057023&ak=E4805d16520de693a3fe707cdc962045]
 +
 
 +
== 接口参数说明 ==
  
==接口参数说明==
 
 
{|
 
{|
 +
|-
 
! width="80" | 参数类型
 
! width="80" | 参数类型
 
! width="80" | 参数名称
 
! width="80" | 参数名称
 
! width="80" | 是否必须
 
! width="80" | 是否必须
!width="380" | 具体描述
+
! width="380" | 具体描述
 
|-
 
|-
|String
+
| String
|ak
+
| ak
|true
+
| true
|开发者密钥
+
| 开发者密钥
 
|-
 
|-
|String
+
| String
|sn
+
| sn
|false
+
| false
|若用户所用ak的校验方式为sn校验时该参数必须。([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
+
| 若用户所用ak的校验方式为sn校验时该参数必须。([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
 
|-
 
|-
|String
+
| String
|location
+
| location
|true
+
| true
|搜索的坐标,如: location=116.305145,39.982368。
+
| 搜索的坐标,如: location=116.305145,39.982368。
 
|-
 
|-
|String
+
| String
|radius
+
| radius
|false
+
| false
|搜索的范围半径,默认为3000m。
+
| 搜索的范围半径,默认为3000m。
 
|-
 
|-
|Int
+
| Int
|sort_rule
+
| sort_rule
|false
+
| false
|返回结果中的POI点与中心点的直线距离排序规则,取值如下:0:从近到远,1:从远到近。
+
| 返回结果中的POI点与中心点的直线距离排序规则,取值如下:0:从近到远,1:从远到近。
 
|-
 
|-
|Int
+
| Int
|pn
+
| pn
|false
+
| false
|获取指定页面的数据,例如:pn=1。
+
| 获取指定页面的数据,例如:pn=1。
 
|-
 
|-
|Int
+
| Int
|rn
+
| rn
|false
+
| false
|单页上所获取的数据的数目,默认为10条数据,单页最多可输出20条数据。
+
| 单页上所获取的数据的数目,默认为10条数据,单页最多可输出20条数据。
 
|-
 
|-
|String
+
| String
|output
+
| output
|false
+
| false
|输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
+
| 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
 
|-
 
|-
|String
+
| String
|coord_type
+
| coord_type
|false
+
| false
|请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。
+
| 请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。
 
|-
 
|-
|String
+
| String
|out_coord_type
+
| out_coord_type
|false
+
| false
|返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。
+
| 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。
 
|-
 
|-
|String
+
| String
|callback
+
| callback
|false
+
| false
|请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
+
| 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
 
|}
 
|}
  
==返回结果==
+
== 返回结果 ==
 +
 
 
{|
 
{|
 
|-
 
|-
 
! width="200" | 参数名称
 
! width="200" | 参数名称
 
! width="180" | 含义
 
! width="180" | 含义
!width="150" | 说明
+
! width="150" | 说明
 
|-
 
|-
|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.item.distance
+
| result.item.distance
|poi与中心点直线距离
+
| poi与中心点直线距离
|
+
|  
 
+
 
|-
 
|-
|result.location
+
| result.location
|当前poi坐标(经纬度)
+
| 当前poi坐标(经纬度)
|
+
|  
 
+
 
|-
 
|-
|result.location.lng
+
| result.location.lng
|经度
+
| 经度
|
+
|  
 
+
 
|-
 
|-
|result.location.lat
+
| result.location.lat
|纬度
+
| 纬度
|
+
|  
 
+
 
|-
 
|-
|result.item.review.item.content
+
| result.item.review.item.content
|评论内容
+
| 评论内容
|
+
|  
 
|-
 
|-
|result.item.review.item.date
+
| result.item.review.item.date
|评论时间
+
| 评论时间
|
+
|  
 
|-
 
|-
|result.item.movies
+
| result.item.movies
|影片信息集合
+
| 影片信息集合
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_name
+
| result.item.movies.item.movie_name
|影片名称
+
| 影片名称
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_type
+
| result.item.movies.item.movie_type
|影片类型
+
| 影片类型
|如 3D
+
| 如 3D
 
|-
 
|-
|result.item.movies.item.movie_release_date
+
| result.item.movies.item.movie_release_date
|影片上映时间
+
| 影片上映时间
|
+
|  
 
|-
 
|-
|result.item.movies.item.movie_nation
+
| result.item.movies.item.movie_nation
|影片所属国家
+
| 影片所属国家
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_starring
+
| result.item.movies.item.movie_starring
|影片演员
+
| 影片演员
|
+
|  
 
|-
 
|-
|result.item.movies.item.movie_length
+
| result.item.movies.item.movie_length
|影片时长
+
| 影片时长
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_picture
+
| result.item.movies.item.movie_picture
|影片图片地址
+
| 影片图片地址
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_score
+
| result.item.movies.item.movie_score
|影片评分
+
| 影片评分
|
+
|  
 
+
 
|-
 
|-
|result.item.movies.item.movie_director
+
| result.item.movies.item.movie_director
|影片导演
+
| 影片导演
|
+
|  
 
|-
 
|-
|result.item.movies.item.movie_tags
+
| result.item.movies.item.movie_tags
|影片所属类型
+
| 影片所属类型
|
+
|  
 
|-
 
|-
|result.item.movies.item.movie_message
+
| result.item.movies.item.movie_message
|影片概要信息
+
| 影片概要信息
|
+
|  
               
+
 
|-
 
|-
|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.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>
第271行: 第263行:
 
</pre>
 
</pre>
  
==返回json格式的数据==
+
== 返回json格式的数据 ==
<pre>
+
<pre>{
{
+
 
     "error": 0,
 
     "error": 0,
 
     "status": "Success",
 
     "status": "Success",

2020年1月14日 (二) 08:30的最后版本


接口说明

    车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。

根据中心点坐标、检索半径、影院关键字查找周边影院、影讯信息。 接口示例

http://api.map.baidu.com/telematics/v3/movie?qt=nearby_cinema&location=116.307852,40.057023&ak=E4805d16520de693a3fe707cdc962045

接口参数说明

参数类型 参数名称 是否必须 具体描述
String ak true 开发者密钥
String sn false 若用户所用ak的校验方式为sn校验时该参数必须。(sn生成算法
String location true 搜索的坐标,如: location=116.305145,39.982368。
String radius false 搜索的范围半径,默认为3000m。
Int sort_rule false 返回结果中的POI点与中心点的直线距离排序规则,取值如下:0:从近到远,1:从远到近。
Int pn false 获取指定页面的数据,例如:pn=1。
Int 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 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。

返回结果

参数名称 含义 说明
status 返回结果状态信息 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
results 返回结果
result.item.name poi名称 如 星美(清河店)
result.item.uid pid id
result.item.address poi地址
result.item.telephone poi电话
result.item.distance 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>2e00c5dde9607d05d7851f50</uid>
<name>星美国际影城(回龙观店)</name>
<telephone>(010)80771188</telephone>
<location>
<lng>116.3195501408</lng>
<lat>40.075986688038</lat>
</location>
<address>回龙观西大街111号华联商场3楼(近华联商厦)</address>
<distance>2314</distance>
<rating>3.5</rating>
<review>
<item>
<content>回龙观附近比较好的一家影院了,经常有团购活动,非周末还不错人不多,硬件条件也挺好~</content>
<date>13-09-17 00:00:00</date>
</item>
<item>
<item>
<content>和朋友去过几次,总体来说还不错</content>
<date>14-02-03 13:01:02</date>
</item>
<item>
<content>环境不错,周边华联设施齐全,票价还行</content>
<date>14-01-09 07:27:33</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-13</movie_release_date>
<movie_picture>http://Img.wangpiao.com/NewsImage/20142/6637409e-5e63-4bfd-8ab9-ba0df9e48f11.jpg</movie_picture>
<movie_length>121分钟</movie_length>
<movie_description>80后北漂沈彦(佟丽娅 饰)和陈锋(陈思成 饰)未婚先孕,正当筹划结婚之际,前男友方洪江(耿乐 饰)却突然出现,满足了沈彦多年的心愿。陈锋的好哥们,情场圣手吴峥(王学兵 饰) 与妻子张蕾(余男 饰)的生活一直风平浪静,而当张蕾得知老公出轨的事实后,她拨通了老板刘辉(梁家辉 饰)的电话。天堂希腊, 佳玲(刘嘉玲 饰)与刘辉在圣托里尼正在大玩偷情游戏,在真心话大冒险的游戏里,彼此突然被问到了内心最深的秘密。 <br/>  处在不同人生阶段的情侣们,面临着各自的爱情困扰,在北京这座最熟悉又最让人陌生的城市里,当梦想照进现实,爱情,也正在遭遇最残酷的现实。 </movie_description>
<movie_score>0.0</movie_score>
<movie_message>献礼情人节,用爱情打败现实,明星阵容升级</movie_message>
<movie_tags>爱情</movie_tags>
<time_table>
<item>
<time>16:30</time>
<date>2014-02-13</date>
<lan>普通话</lan>
<type>数字</type>
<price>80</price>
</item>
</time_table>
</movies>
</result>
</telematics>

返回json格式的数据

{
    "error": 0,
    "status": "Success",
    "date": "2014-02-13",
    "result": [
        {
            "uid": "2e00c5dde9607d05d7851f50",
            "name": "星美国际影城(回龙观店)",
            "telephone": "(010)80771188",
            "location": {
                "lng": 116.3195501408,
                "lat": 40.075986688038
            },
            "address": "回龙观西大街111号华联商场3楼(近华联商厦)",
            "distance": 2314,
            "rating": "3.5",
            "review": [
                     {
                    "content": "回龙观附近比较好的一家影院了,经常有团购活动,非周末还不错人不多,硬件条件也挺好~",
                    "date": "13-09-17 00:00:00"
                },
                {
                    "content": "呵呵看3D还要多加钱",
                    "date": "14-02-10 22:48:38"
                },
                {
                    "content": "和朋友去过几次,总体来说还不错",
                    "date": "14-02-03 13:01:02"
                },
                {
                    "content": "环境不错,周边华联设施齐全,票价还行",
                    "date": "14-01-09 07:27:33"
                }
            ],
            "movies": [
                {
                    "movie_name": "北京爱情故事",
                    "movie_type": "普通",
                    "movie_nation": "中国大陆",
                    "movie_director": "陈思诚",
                    "movie_starring": "梁家辉/刘嘉玲/陈思诚/佟丽娅/余男/王学兵/斯琴高娃/王庆祥/金燕玲/耿乐/郭京飞",
                    "movie_release_date": "2014-02-13",
                    "movie_picture": "http://Img.wangpiao.com/NewsImage/20142/6637409e-5e63-4bfd-8ab9-ba0df9e48f11.jpg",
                    "movie_length": "121分钟",
                    "movie_description": "  80后北漂沈彦(佟丽娅 饰)和陈锋(陈思成 饰)未婚先孕,正当筹划结婚之际,前男友方洪江(耿乐 饰)却突然出现,满足了沈彦多年的心愿。陈锋的好哥们,情场圣手吴峥(王学兵 饰) 与妻子张蕾(余男 饰)的生活一直风平浪静,而当张蕾得知老公出轨的事实后,她拨通了老板刘辉(梁家辉 饰)的电话。天堂希腊, 佳玲(刘嘉玲 饰)与刘辉在圣托里尼正在大玩偷情游戏,在真心话大冒险的游戏里,彼此突然被问到了内心最深的秘密。 
  处在不同人生阶段的情侣们,面临着各自的爱情困扰,在北京这座最熟悉又最让人陌生的城市里,当梦想照进现实,爱情,也正在遭遇最残酷的现实。 ",
                    "movie_score": "0.0",
                    "movie_message": "献礼情人节,用爱情打败现实,明星阵容升级",
                    "movie_tags": "爱情",
                    "time_table": [
                        {
                            "time": "16:30",
                            "date": "2014-02-13",
                            "lan": "普通话",
                            "type": "数字",
                            "price": 80
                        }
            ]
        }
    ]
}