tourism”的版本间的差异

来自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/travel_city?location=北京&ak=E4805d16520de693a3fe707cdc962045
+
   [http://api.map.baidu.com/telematics/v3/travel_city?location=北京&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/travel_city?location=北京&ak=E4805d16520de693a3fe707cdc962045]
  
==接口参数说明==
+
== 接口参数说明 ==
  
 
{|
 
{|
!width="100"| 参数类型
 
!width="100"| 参数名称
 
!width="100"| 是否必须
 
!具体描述
 
 
|-
 
|-
|String
+
! width="100" | 参数类型
|ak
+
! width="100" | 参数名称
|true
+
! width="100" | 是否必须
|开发者密钥
+
! 具体描述
 
|-
 
|-
|String
+
| String
|sn
+
| ak
|false
+
| true
|若用户所用ak的校验方式为sn校验时该参数必须。 ([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
+
| 开发者密钥
 
|-
 
|-
|String
+
| String
|location
+
| sn
|true
+
| false
|输入城市名或经纬度,城市名称如:北京或者131,经纬度格式为lng,lat坐标如: location=116.305145,39.982368。
+
| 若用户所用ak的校验方式为sn校验时该参数必须。 ([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
 
|-
 
|-
|String
+
| String
|day
+
| location
|false
+
| true
|输入游玩天数,例如day=3代表三日游,全部旅游路线为day=all。
+
| 输入城市名或经纬度,城市名称如:北京或者131,经纬度格式为lng,lat坐标如: location=116.305145,39.982368。
 
|-
 
|-
|String
+
| String
|output
+
| day
|false
+
| false
|输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
+
| 输入游玩天数,例如day=3代表三日游,全部旅游路线为day=all。
 
|-
 
|-
|String
+
| String
|coord_type
+
| output
|false
+
| false
|请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。
+
| 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
 
|-
 
|-
|String
+
| String
|out_coord_type
+
| coord_type
|false
+
| false
|返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。
+
| 请求参数坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。
 
|-
 
|-
|String
+
| String
|callback
+
| out_coord_type
|false
+
| false
|将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。
+
| 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。
 +
|-
 +
| String
 +
| callback
 +
| false
 +
| 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。
 
|}
 
|}
  
==返回结果==
+
== 返回结果 ==
  
 
{|
 
{|
!width="200"| 参数名称
 
!width="200"| 含义
 
!说明
 
 
|-
 
|-
|status
+
! width="200" | 参数名称
|返回结果状态信息
+
! width="200" | 含义
|请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
+
! 说明
|-
+
|results
+
|返回结果
+
|
+
|-
+
|result.url
+
|详情页地址
+
|如http://lvyou.baidu.com/beijing
+
 
|-
 
|-
|result.location
+
| status
|当前城市坐标(经纬度)
+
| 返回结果状态信息
|
+
| 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
|-
+
|result.location.lng
+
|经度
+
|
+
|-
+
|result.location.lat
+
|纬度
+
|
+
 
|-
 
|-
|result.abstract
+
| results
|城市印象摘要
+
| 返回结果
|
+
|  
 
|-
 
|-
|result.desncriptio
+
| result.url
|城旅游介绍
+
| 详情页地址
|
+
| 如http://lvyou.baidu.com/beijing
 
|-
 
|-
|result.itineraries.item
+
| result.location
|旅游路市线
+
| 当前城市坐标(经纬度)
|如:北京2日游详细路线
+
|  
 
|-
 
|-
|result.itineraries.item. detail
+
| result.location.lng
|旅游路线中景点详情
+
| 经度
|如:北京2日游详细路线,包含故宫,可通过detail得知故宫详情
+
|
 +
|-
 +
| result.location.lat
 +
| 纬度
 +
|
 +
|-
 +
| result.abstract
 +
| 城市印象摘要
 +
|
 +
|-
 +
| result.desncriptio
 +
| 城旅游介绍
 +
|
 +
|-
 +
| result.itineraries.item
 +
| 旅游路市线
 +
| 如:北京2日游详细路线
 +
|-
 +
| result.itineraries.item. detail
 +
| 旅游路线中景点详情
 +
| 如:北京2日游详细路线,包含故宫,可通过detail得知故宫详情
 
|}
 
|}
  
==返回xml格式的数据==
+
== 返回xml格式的数据 ==
 
+
<pre><?xml version="1.0" encoding="utf-8"?>
<pre>
+
<?xml version="1.0" encoding="utf-8"?>
+
 
<telematics>
 
<telematics>
 
<error>0</error>
 
<error>0</error>
第156行: 第158行:
 
</pre>
 
</pre>
  
==返回json格式的数据==
+
== 返回json格式的数据 ==
 
+
<pre>{
<pre>
+
{
+
 
     "error": 0,
 
     "error": 0,
 
     "status": "Success",
 
     "status": "Success",

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


接口说明

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

根据城市名称、城市代码、坐标查询城市旅游路线,同时旅游天数可作为筛选条件。

接口示例

 http://api.map.baidu.com/telematics/v3/travel_city?location=北京&ak=E4805d16520de693a3fe707cdc962045

接口参数说明

参数类型 参数名称 是否必须 具体描述
String ak true 开发者密钥
String sn false 若用户所用ak的校验方式为sn校验时该参数必须。 (sn生成算法
String location true 输入城市名或经纬度,城市名称如:北京或者131,经纬度格式为lng,lat坐标如: location=116.305145,39.982368。
String day false 输入游玩天数,例如day=3代表三日游,全部旅游路线为day=all。
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.url 详情页地址 如http://lvyou.baidu.com/beijing
result.location 当前城市坐标(经纬度)
result.location.lng 经度
result.location.lat 纬度
result.abstract 城市印象摘要
result.desncriptio 城旅游介绍
result.itineraries.item 旅游路市线 如:北京2日游详细路线
result.itineraries.item. detail 旅游路线中景点详情 如:北京2日游详细路线,包含故宫,可通过detail得知故宫详情

返回xml格式的数据

<?xml version="1.0" encoding="utf-8"?>
<telematics>
<error>0</error>
<status>Success</status>
<date>2014-02-13</date>
<result>
<cityid>131</cityid>
<cityname>北京</cityname>
<location>
<lng>116.3975010526</lng>
<lat>39.908546091554</lat>
</location>
<star>5</star>
<url>http://lvyou.baidu.com/beijing</url>
<abstract>表面上它是现代大都会,但内心却有抹不去的古朴和怀旧。闲庭信步在逐渐少去的胡同里,走进那热气腾腾的涮肉店,那才是真正的北京.</abstract>
<description>北京,中国首都。每个人心中,都有一个“我爱北京天安门”的北京情结,都曾梦想着生活在传说中的紫禁城;梦想着穿梭在王朔笔下的胡同和大院;也梦想着爬上万里长城,大喊:我是好汉!在每个人心中,都一个人属于自己的北京。北京是一座包容万象、海纳百川的城市。三千年的历史,六朝故都,这里荟萃了自元明清以来的中华文化,荟萃了众多名胜古迹和人文景观。这里汇聚了八方来客,宗教、文化、语言在这里融合,兼容并蓄。如果想准确的描绘出北京的模样,无异于痴人说梦,北京在红宫墙外的宁静小路上,在胡同儿的转弯拐角儿,在国贸的匆匆路旁,也在未名湖边的石砖小径。只有用心去感受,去聆听,才能听到北京的内心独白。在我的心里,北京表面上它是现代大都会,但是内心却有抹不去的古朴和怀旧。闲庭信步在逐渐少去的胡同里,走进那热气腾腾的涮肉店,那才是真正的北京。有许多著名的学府如清华、北大等也汇聚于此,可以漫步校园中想象朱自清、胡适等昔日大师在校任教时的情景。还有许多闻名遐迩的自然景观,如红叶迷人的香山公园、竹林遍地的紫竹院、环境幽雅的玉渊潭……</description>
<itineraries>
<item>
<name>二日游</name>
<description>如果只有一天时间,建议只在城区内活动。早上逛逛故宫感受历史,下午在后海边晒晒太阳喝喝茶文艺一下,晚上到三里屯放松心情。</description>
<itineraries>
<item>
<path>
<item>
<name>故宫</name>
<detail>http://api.map.baidu.com/telematics/v3/travel_attractions?id=gugong& ak=E4805d16520de693a3fe707cdc962045</detail>
</item>
<item>
<name>后海</name>
<detail>http://api.map.baidu.com/telematics/v3/travel_attractions?id=houhai&ak=E4805d16520de693a3fe707cdc962045</detail>
</item>
<item>
<name>三里屯</name>
<detail>http://api.map.baidu.com/telematics/v3/travel_attractions?id=sanlitun&ak=E4805d16520de693a3fe707cdc962045</detail>
</item>
</path>
<description>故宫推荐只走中轴线,大概3个来小时可逛完。从南门进北门出,中午可在景山附近吃个饭。下午沿胡同闲逛至后海,逛累了,随便找一家喜欢的咖啡馆坐在什刹海边晒晒太阳,喝喝茶。后海就在鼓楼附近,鼓楼一带最能体现老北京的味道。晚上去著名的三里屯逛逛。三里屯除了酒吧街还有Village等商业区,Village南区的品牌相对亲民,北区的品牌多为奢侈品。</description>
<dinning>从鼓楼东大街坐107路公交可到簋街。簋街是北京著名的餐饮一条街,街两旁挂满红灯笼,热闹非常。主要有川菜、烤串、馋嘴蛙、香辣蟹、火锅等等。</dinning>
<accordination>鼓韵青年旅舍地址:北京市西城区旧鼓楼大街51号特色:2011年重新装修过,服务员都是热情的藏族小姑娘!离鼓楼、后海步行只有5-10分钟。价格:单人间170元,二人间240元,三人间260元,四人间65元/人,六人间55元/人。电话:010-64037702/64039907 怎么去:地铁2号线到鼓楼大街站B口出站,往南走300米。</accordination>
</item>
</itineraries>
</item>
<item>
</itineraries>
</result>
</telematics>

返回json格式的数据

{
    "error": 0,
    "status": "Success",
    "date": "2014-02-13",
    "result": {
        "cityid": 131,
        "cityname": "北京",
        "location": {
            "lng": 116.3975010526,
            "lat": 39.908546091554
        },
        "star": "5",
        "url": "http://lvyou.baidu.com/beijing",
        "abstract": "表面上它是现代大都会,但内心却有抹不去的古朴和怀旧。闲庭信步在逐渐少去的胡同里,走进那热气腾腾的涮肉店,那才是真正的北京.",
        "description": "北京,中国首都。每个人心中,都有一个“我爱北京天安门”的北京情结,都曾梦想着生活在传说中的紫禁城;梦想着穿梭在王朔笔下的胡同和大院;也梦想着爬上万里长城,大喊:我是好汉!在每个人心中,都一个人属于自己的北京。
北京是一座包容万象、海纳百川的城市。三千年的历史,六朝故都,这里荟萃了自元明清以来的中华文化,荟萃了众多名胜古迹和人文景观。这里汇聚了八方来客,宗教、文化、语言在这里融合,兼容并蓄。如果想准确的描绘出北京的模样,无异于痴人说梦,北京在红宫墙外的宁静小路上,在胡同儿的转弯拐角儿,在国贸的匆匆路旁,也在未名湖边的石砖小径。只有用心去感受,去聆听,才能听到北京的内心独白。
在我的心里,北京表面上它是现代大都会,但是内心却有抹不去的古朴和怀旧。闲庭信步在逐渐少去的胡同里,走进那热气腾腾的涮肉店,那才是真正的北京。
有许多著名的学府如清华、北大等也汇聚于此,可以漫步校园中想象朱自清、胡适等昔日大师在校任教时的情景。
还有许多闻名遐迩的自然景观,如红叶迷人的香山公园、竹林遍地的紫竹院、环境幽雅的玉渊潭……",
        "itineraries": [
            {
                "name": "二日游",
                "description": "如果只有一天时间,建议只在城区内活动。早上逛逛故宫感受历史,下午在后海边晒晒太阳喝喝茶文艺一下,晚上到三里屯放松心情。",
                "itineraries": [
                    {
                        "path": [
                            {
                                "name": "故宫",
                                "detail": "http://api.map.baidu.com/telematics/v3/travel_attractions?id=gugong&output=json&ak=E4805d16520de693a3fe707cdc962045"
                            },
                            {
                                "name": "后海",
                                "detail": "http://api.map.baidu.com/telematics/v3/travel_attractions?id=houhai&output=json&ak=E4805d16520de693a3fe707cdc962045"
                            },
                            {
                                "name": "三里屯",
                                "detail": "http://api.map.baidu.com/telematics/v3/travel_attractions?id=sanlitun&output=json&ak=E4805d16520de693a3fe707cdc962045"
                            }
                        ],
                        "description": "故宫推荐只走中轴线,大概3个来小时可逛完。从南门进北门出,中午可在景山附近吃个饭。下午沿胡同闲逛至后海,逛累了,随便找一家喜欢的咖啡馆坐在什刹海边晒晒太阳,喝喝茶。后海就在鼓楼附近,鼓楼一带最能体现老北京的味道。晚上去著名的三里屯逛逛。三里屯除了酒吧街还有Village等商业区,Village南区的品牌相对亲民,北区的品牌多为奢侈品。",
                        "dinning": "从鼓楼东大街坐107路公交可到簋街。簋街是北京著名的餐饮一条街,街两旁挂满红灯笼,热闹非常。主要有川菜、烤串、馋嘴蛙、香辣蟹、火锅等等。",
                        "accordination": "鼓韵青年旅舍\n地址:北京市西城区旧鼓楼大街51号
特色:2011年重新装修过,服务员都是热情的藏族小姑娘!离鼓楼、后海步行只有5-10分钟。
价格:单人间170元,二人间240元,三人间260元,四人间65元/人,六人间55元/人。
电话:010-64037702/64039907\n怎么去:地铁2号线到鼓楼大街站B口出站,往南走300米。"
                    }
                ]
            }
                 ]
            }
        ]
    }
}