接口说明
车联网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校验时该参数必须。 |
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米。" } ] } ] } ] } }