(以“{{car-sidebar}} ==接口说明== 根据城市,返回相应的交通事件信息。 ==接口示例== http://api.map.baidu.com/telematics/v3/trafficEvent?locati...”为内容创建页面) |
|||
(未显示1个用户的7个中间版本) | |||
第1行: | 第1行: | ||
{{car-sidebar}} | {{car-sidebar}} | ||
− | ==接口说明== | + | |
+ | == 接口说明 == | ||
+ | |||
+ | <span style="color:red;"> 车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。</span> | ||
根据城市,返回相应的交通事件信息。 | 根据城市,返回相应的交通事件信息。 | ||
− | ==接口示例== | + | == 接口示例 == |
− | http://api.map.baidu.com/telematics/v3/trafficEvent?location=北京&output=json&ak= | + | [http://api.map.baidu.com/telematics/v3/trafficEvent?location=北京&output=json&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/trafficEvent?location=北京&output=json&ak=E4805d16520de693a3fe707cdc962045] |
− | ==接口参数说明== | + | == 接口参数说明 == |
{| | {| | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | ! width="100" | 参数类型 |
− | | | + | ! width="100" | 参数名称 |
− | | | + | ! width="100" | 是否必须 |
− | + | ! 具体描述 | |
|- | |- | ||
− | |String | + | | String |
− | | | + | | ak |
− | | | + | | true |
− | | | + | | 开发者密钥 |
|- | |- | ||
− | |String | + | | String |
− | | | + | | sn |
− | | | + | | false |
− | | | + | | 若用户所用ak的校验方式为sn校验时该参数必须。 |
|- | |- | ||
− | |String | + | | String |
− | | | + | | location |
− | | | + | | true |
− | | | + | | 输入城市名或经纬度,经纬度格式为 lng,lat |
|- | |- | ||
− | |String | + | | String |
− | | | + | | output |
− | |false | + | | false |
− | | | + | | 输出的数据格式,默认为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 | ||
+ | | out_coord_type | ||
+ | | false | ||
+ | | 返回结果输出时的坐标类型,默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标。 | ||
+ | |- | ||
+ | | String | ||
+ | | callback | ||
+ | | false | ||
+ | | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。 | ||
|} | |} | ||
− | ==返回结果== | + | == 返回结果 == |
{| | {| | ||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | ! width="200" | 参数名称 |
− | | | + | ! width="200" | 含义 |
− | + | ! 说明 | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
− | | | + | | status |
− | | | + | | 返回结果状态信息 |
− | | | + | | 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。 |
|- | |- | ||
− | | | + | | currentCity |
− | | | + | | 当前城市 |
− | | | + | | 返回城市名 |
|- | |- | ||
− | | | + | | datetime |
− | | | + | | 当前时间 |
− | |格式 年/月/日/时/分/秒 | + | | 格式 年/月/日/时/分/秒 |
|- | |- | ||
− | |results. | + | | results.startTime |
− | | | + | | 事件开始时间 |
− | | | + | | 格式 年/月/日/时/分/秒 |
|- | |- | ||
− | |results. | + | | results.endTime |
− | | | + | | 事件结束时间 |
− | | | + | | 格式 年/月/日/时/分/秒 |
|- | |- | ||
− | |results. | + | | results.title |
− | | | + | | 事件名称 |
− | | | + | | |
|- | |- | ||
− | |results. | + | | results.description |
− | | | + | | 事件描述 |
− | + | | | |
− | + | ||
− | + | ||
− | + | ||
− | | | + | |
|- | |- | ||
− | |results.type | + | | results.location |
− | |事件类型 | + | | 事件位置(经纬度) |
− | |0管制、1事故、2施工、3管制 | + | | |
+ | |- | ||
+ | | results.location.lng | ||
+ | | 经度 | ||
+ | | | ||
+ | |- | ||
+ | | results.location.lat | ||
+ | | 纬度 | ||
+ | | | ||
+ | |- | ||
+ | | results.type | ||
+ | | 事件类型 | ||
+ | | 0管制、1事故、2施工、3管制 | ||
|} | |} | ||
− | ==返回xml格式的数据== | + | == 返回xml格式的数据 == |
− | + | <pre><TrafficEventResponse> | |
− | <pre> | + | |
− | <TrafficEventResponse> | + | |
<status>success</status> | <status>success</status> | ||
<currentCity>北京</currentCity> | <currentCity>北京</currentCity> | ||
第133行: | 第141行: | ||
</pre> | </pre> | ||
− | ==返回json格式的数据== | + | == 返回json格式的数据 == |
− | + | <pre>{ | |
− | <pre> | + | |
− | { | + | |
error: 0, | error: 0, | ||
status: "success", | status: "success", |
2022年11月14日 (一) 11:05的最后版本
接口说明
车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。
根据城市,返回相应的交通事件信息。
接口示例
http://api.map.baidu.com/telematics/v3/trafficEvent?location=北京&output=json&ak=E4805d16520de693a3fe707cdc962045
接口参数说明
参数类型 | 参数名称 | 是否必须 | 具体描述 |
---|---|---|---|
String | ak | true | 开发者密钥 |
String | sn | false | 若用户所用ak的校验方式为sn校验时该参数必须。 |
String | location | true | 输入城市名或经纬度,经纬度格式为 lng,lat |
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,如果失败返回其他数字,详细见状态码附录。 |
currentCity | 当前城市 | 返回城市名 |
datetime | 当前时间 | 格式 年/月/日/时/分/秒 |
results.startTime | 事件开始时间 | 格式 年/月/日/时/分/秒 |
results.endTime | 事件结束时间 | 格式 年/月/日/时/分/秒 |
results.title | 事件名称 | |
results.description | 事件描述 | |
results.location | 事件位置(经纬度) | |
results.location.lng | 经度 | |
results.location.lat | 纬度 | |
results.type | 事件类型 | 0管制、1事故、2施工、3管制 |
返回xml格式的数据
<TrafficEventResponse> <status>success</status> <currentCity>北京</currentCity> <dateTime>2013/07/23/18/32/41</dateTime> <results> <result> <startTime>2013/03/08/10/51/00</startTime> <endTime>2013/10/08/12/00/00</endTime> <title>东四西大街1车道限行(长期)</title> <description>东四西大街因为道路施工,导致1车道限行。</description> <location> <lng>116.420497</lng> <lat>39.930511</lat> </location> <type>2</type> </result> <result> <startTime>2013/01/01/00/00/00</startTime> <endTime>2013/12/31/23/59/00</endTime> <title>清华东路3车道限行(长期)</title> <description>清华东路因为道路施工,导致3车道限行。</description> <location> <lng>116.37618</lng> <lat>40.007609</lat> </location> <type>2</type> </result> </results> </TrafficEventResponse>
返回json格式的数据
{ error: 0, status: "success", currentCity: "北京", dateTime: "2013/07/23/18/33/46", results: [ { startTime: "2013/03/08/10/51/00", endTime: "2013/10/08/12/00/00", title: "东四西大街1车道限行(长期)", description: "东四西大街因为道路施工,导致1车道限行。", location: { lng: 116.420497, lat: 39.930511 }, type: "2" } ] }