百度地图车联网APIv3.0 接口说明文档.docx

文档名称：车联网API V3.0接口文档 车联网V3.0API文档目录Geocoding3反Geocoding4兴趣点检索6周边检索9驾车检索12测距18天气查询19交通事件查询26途经路段查询29Geocoding接口说明将地址转换成坐标的功能，将详细的地址描述传给百度车联网服务如：北京市上地十街十号百度大厦,返回经纬度坐标。接口示例/telematics/v3/geocoding?keyWord=北京市上地十街十号百度大厦&cityName=131&out_coord_type=gcj02&ak=yourkey接口参数设置参数类型参数名称是否必须具体描述String keyWordtrue搜索的具体地址,建议按照省市/区县/街道、POI名称的方式完整填写，例如：北京市/海淀区/上地信息路甲9号/奎科科技大厦String cityNametrue城市名称，如cityName=北京Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringout_coord_typefalse返回结果输出时的坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。返回结果参数类型参数名及位置具体描述stringstatus请求状态，包括success，required parameter，sever error等多种状态；intprecise精准度，0为不够精准，1表示比较精准floatlng地点的经度floatlat地点的纬度1返回xml格式的数据Success40.050743859593/当前点的经度坐标116.3017193083/当前点对应的纬度坐标12返回json格式的数据status:success,results:location:lng:116.3017193083,lat:40.050743859593,precise:1,反Geocoding接口说明将坐标转换成地址的功能，将经纬度信息传给百度车联网服务，服务返回详细的地址描述信息，如北京市上地十街十号百度大厦。接口示例/telematics/v3/reverseGeocoding?location=116.3017193083,40.050743859593&coord_type=gcj02 &ak=yourkey接口参数设置参数类型参数名称是否必须具体描述String locationtrue搜索地点的经纬度；如：location= 116.30171930,40.05074385953Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringcoord_typefalse请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标，wgs84表示gps获取的坐标。返回数据参数类型参数名及位置具体描述stringstatus请求状态，包括success，required parameter，sever error等多种状态；Stringdescription地点描述stringstreet所在街道stringzipCodeZip码stringdistrict所在街区的名称1返回xml格式的数据Success北京市海淀区上地十街10号北京市北京市海淀区上地十街2返回json格式的数据status:Success,description:北京市海淀区上地十街10号,province:北京市,city:北京市,district:海淀区,street:上地十街,street_number:10号zipCode: 兴趣点检索接口说明根据城市名或者城市编号，搜索关键字，返回当前城市包含该关键字信息的检索结果，如在“北京”或者城市代号131查询“苏州街”。接口示例/telematics/v3/point?keyWord=苏州街&cityName=北京&ak=yourkey接口参数设置参数类型参数名称是否必须具体描述String keyWordtrue搜索关键词，如百度大厦，苏州街Stringtagfalse基础分类，如：” 生活服务”，详细分类/map/static/doc/BaiduMap_tag.zipStringcityNametrue搜索的城市名，支持城市名，如:cityName=“北京”Intnumbertrue单页上所获取的数据的数目，默认为10条数据，单页最多可输出20条数据；Intpagetrue获取指定页面的数据Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringout_coord_typefalse返回结果输出时的坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。返回结果1.返回xml格式的数据Success3240/搜索到的相关信息的数目/搜索信息展示/第一条信息苏州街北京市116.3062773387639.975631599135地铁10号线;地铁10号线海淀区/该地点对应的其他信息味你湖区高技街30号(近花鸟市场)快餐简餐,翠苑交通设施地铁/轻轨地铁/轻轨站2 返回json格式的数据status: Success,total: 3143,poiList:name: 苏州街/海淀南路(路口),cityName: 北京市,location: lng: 116.30621687825,lat: 39.975659804623,address: 北京市海淀区,district: null,additionalInformation: name: 味你享,telepnone:address: 西湖区高技街30号(近花鸟市场),tag: 快餐简餐,翠苑,type: 交通设施交叉路口周边检索接口说明根据中心点坐标、检索半径、关键字查找周边信息，如苏州街周边3公里范围内的“酒店”。接口示例/telematics/v3/local?location=116.305145,39.982368&keyWord=酒店&output=xml&ak=yourkey接口的参数设置参数类型参数名称是否必须具体描述String keyWordtrue搜索关键词，如百度大厦，苏州街Floatlocationtrue搜索中心点坐标，如: location=116.305145,39.982368;Stringtagfalse基础分类，如：” 生活服务”，详细分类/map/static/doc/BaiduMap_tag.zipIntradiusfasle搜索的范围半径，默认为3000mStringcityNamefalse搜索的城市名，支持城市名，如:cityName=“北京”Intnumbertrue单页上所获取的数据的数目，默认为10条数据，单页最多可输出20条数据；Intpagetrue获取指定页面的数据Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringcoord_typefalse请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。Stringout_coord_typefalse返回结果输出时的坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。返回数据1返回xml格式的数据Success229/搜索到的相关信息的数目/搜索到的信息列表 /第一条数据北京大地花园酒店北京市北京市海淀区海淀大街35号（近海淀桥南侧，近中关村图书大厦）(010)82615588116.3060659415939.98276091062389海淀区/该地点的相关其他信息北京大地花园酒京市海淀区海淀大街35号（近海淀桥南侧，近中关村图书大厦）288.0/平均消费价格准三星酒店,中关村、上地2 返回json格式的数据status: Success,total: 229,pointList: name: 北京大地花园酒店,cityName: 北京市,location: lng: 116.30606594159,lat: 39.982760910623,address: 北京市海淀区海淀大街35号（近海淀桥南侧，近中关村图书大厦）,district: null,additionalInformation: name: 北京大地花园酒店,telepnone:address: 北京市海淀区海淀大街35号（近海淀桥南侧，近中关村图书大厦）,price: 288.0,tag: 准三星酒店,中关村、上地,link: name: 去哪儿,url: /city/beijing_city/dt-426/#ex_track=bd_ditu,name: 到到网,url:/Hotel_Review-g294212-d606460-Reviews-m13829-Beijing_Dadi_Garden_Hotel-Beijing.html,type: 宾馆星级宾馆酒店三星级驾车检索接口说明根据传入的起终点，查询驾车路线方案。接口示例/telematics/v3/navigation?origin=南京师范大学&destination=中国政法大学&origin_region=南京&destination_region=北京&ak=yourkey接口的参数设置参数类型参数名称是否必须具体描述String origintrue起点名称或经纬度Stringdestinationtrue终点名称或经纬度Stringregion同城搜索时必填城市名或县名，如：北京或者131，该参数设置后认为起点和终点都在同一城市，除非单独给定起点或终点的城市。Stringorigin_region跨城搜索时必填起点所在城市或县如：北京或者131，当region设置值后可以不设置该项，主要在跨城搜索中使用，同城搜索建议使用regionStringdestination_region跨城搜索时必填终点所在城市或县，如：北京或者131，当region设置值后可以不设置该项,主要在跨城搜索中使用，同城搜索建议使用regionStringroute_typefalse最优策略，0：最少时间1：最短路程2：不走高速，默认为0最少时间Stringwaypointsfalse奎科科技大厦|西单, 途经点集合，包括一个或多个用竖线字符 | 分隔的地址名称或经纬度。Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringcoord_typefalse请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。Stringout_coord_typefalse返回结果输出时的坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。返回结果1返回XML格式的数据注：当起点和终点不够具体时，（如，起点为南京师范大学，而南京师范大学有多个校区）往往不能直接搜索到起点和终点间的驾车信息，代之会返回地点和终点的相关信息；当搜索词为“青年路”，“民主路”等会出现在多个城市的地点时，也不能搜索到起点终点间的直接驾车路线，而会返回包含当前搜索词信息的城市列表；1.1 非直跳时显示起点和终点的信息或城市列表Success19/returnType为19时表示没有起点和终点之间直跳的驾车路线0/listType为0 表示，返回起点的详细信息南京市南京师范大学文澜路118.9148551795432.109151649066/ 终点的相关信息1/listType为1 表示返回包含终点信息的城市列表/起点信息在该城市中出现的次数。如，起点为：民主路。则此处代表海市含有48条和民主路相关的信息上海市75天津市31.2 直跳时显示路线和关键点的信息注：可以搜索到起点和终点之间的驾车路线Success20/ returnType值为20时，返回的是起点和终点之间的驾车路线538/ 起点和终点之间的距离单位：米（下同）123/ 所需要的时间，单位：秒（下同）/ 起点的经纬度坐标116.3081479303340.040481964898/ 终点的经纬度坐标116.3057472082640.044841627062/ 第一个路段的信息538 / 第一个路段的距离38/ 第一个路段需要的时间116.3081595339,40.040479415093;116.30830953575,40.040549141561;116.30662974093,40.043449004818;116.30573024708,40.044848917951/ 第一个路段的路线信息256从起点向东北方向出发,沿信息路行驶240米,过右侧的CPE大厦约300米后,到达终点/路线说明 / 第一个路段的起点的经纬度坐标116.3081479303340.040481964898从起点向东北方向出发 - 240米/第一个路段的起点说明/ 第一个路段终点的经纬度坐标116.3057472082640.044841627062到达终点/终点的说明/途中经过点/ 第一组经过点的相关信息CPE大厦/经过点的坐标116.3075195040740.042659383273106经过点的说明12返回json格式的数据2.1 非直跳时显示起点和终点的信息status: Success,returnType: 19,origin: cityName: 南京市,listType: 0,results: name: 南京师范大学,address: 文澜路,telephone: null,location: lng: 118.91485517954,lat: 32.109151649066,destination: cityName: 全国,listType: 1,results: name: 北京市,address: null,telephone: null,number: 553,name: 上海市,address: null,telephone: null,number: 3612.2 直跳时显示路线信息results: distance: 524,duration: 98,steps: area: 0,direction: 5,distance: 524,duration: 38,instructions: 从起点向东南方向出发,沿信息路行驶440米,过右侧的方正大厦约80米后,到达终点(在道路左侧),path: 116.3056498823,40.044799148654;116.30687944807,40.042709130558;116.30813989487,40.040479055788,pois: detail: instructions: ,position: 1,location: lng: 116.30732953173,lat: 40.040908962395,name: 方正大厦,type: 106,type: 3,stepOriginLocation: lng: 116.3056480976,lat: 40.044802568885,stepDestinationLocation: lng: 116.30813989487,lat: 40.040479055788,stepOriginInstruction: 从起点向东南方向出发 - 440米,stepDestinationInstruction: 到达终点,originLocation: lng: 116.30813989487,lat: 40.040479055788,destinationlocation: lng: 116.3056480976,lat: 40.044802568885,returnType: 20,status: Success测距接口说明测量多点之间的直线距离接口示例/telematics/v3/distance?waypoints=118.77147503233,32.054128923368;116.3521416286,39.965780080447;116.28215586757,39.965780080447&ak=yourkey接口的参数设置参数类型参数名称是否必须具体描述Stringwaypointstrue需要测距的点的经纬度坐标；需传入两个或更多的点。两个点之间用 “; ”进行分割开，单个点的经纬度用“,”分隔开；例如： waypoints=118.77147503233,32.054128923368;116.3521416286, 39.965780080447;116.28215586757,39.965780080447Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringcoord_typefalse请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。返回结果1 返回xml格式的数据Success906141.08502603/ 返回的第一个点和第二个点之间的距离，单位为米；5964.3883866308/ 返回的第二个点和第三个点之间的距离，单位为米；2返回json格式的数据 message:Success, content: 906141.08502603,/ 返回的第一个点和第二个点之间的距离，单位为米； 5964.3883866308/ 返回的第二个点和第三个点之间的距离，单位为米； 天气查询 接口说明根据经纬度/城市名查询天气的结果接口示例/telematics/v3/weather?location=北京&output=json&ak=yourkey接口的参数设置参数类型参数名称是否必须具体描述Stringlocationtrue输入城市名或经纬度，城市名称如:北京或者131，经纬度格式为lng,lat坐标如: location=116.305145,39.982368;全国值为all,返回省会城市自治区，港澳台天气情况多城市天气预报中间“|”分隔,location=116.305145,39.982368| 122.305145,36.982368|.Stringoutputfalse输出的数据格式，默认为xml格式，当output设置为json时，输出的为json格式的数据。Stringcoord_typefalse请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。返回结果参数名称含义说明currentCity当前城市返回城市名status返回结果状态信息date当前时间年-月-日results天气预报信息白天时候有3天的天气情况（今天、明天、后天）、晚上时候有4的天气情况（今天、明天、后天、大后天）results.currentCity当前城市results.weather_dataweather_data.date天气预报时间weather_data.dayPictureUrl白天的天气预报图片urlweather_data.nightPictureUrl晚上的天气预报图片urlweather_data.weather天气状况weather_data.wind风力weather_data.temperature温度1 返回xml格式的数据success2013-07-18北京市周三/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云微风23周四/images/weather/day/leizhenyu.png/images/weather/night/zhongyu.png雷阵雨转中雨微风2922周五/images/weather/day/yin.png/images/weather/night/duoyun.png阴转多云微风3123周六/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云微风3124合肥市周三/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云东风3-4级27周四/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云东北风3-4级3527周五/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云南风3527周六/images/weather/day/duoyun.png/images/weather/night/duoyun.png多云东风3427阵雨东北风3-4级182 返回json格式的数据error:0,status:success,date:2013-07-17,results:currentCity:北京市,weather_data:date:今天（周三）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:微风,temperature:23,date:明天（周四）,dayPictureUrl:/images/weather/day/leizhenyu.png,nightPictureUrl:/images/weather/night/zhongyu.png,weather:雷阵雨转中雨,wind:微风,temperature:2922,date:后天（周五）,dayPictureUrl:/images/weather/day/yin.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:阴转多云,wind:微风,temperature:3123,date:大后天（周六）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:微风,temperature:3124,currentCity:合肥市,weather_data:date:今天（周三）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:东风3-4级,temperature:27,date:明天（周四）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:东北风3-4级,temperature:3527,date:后天（周五）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:南风,temperature:3527,date:大后天（周六）,dayPictureUrl:/images/weather/day/duoyun.png,nightPictureUrl:/images/weather/night/duoyun.png,weather:多云,wind:东风,temperature:3427交通事件查询接口说明根据城市，返回相应的交通事件信息 接口示例/telematics/v3/trafficEvent?lo