产品简介
高德地图道路动态信息洞察服务服务，主要目的是在客户的安全、风控、定责等场景，通过对历史路况&事件的查询，辅助判断当时的驾驶行为是否合理，以达到安全监督、责任判定等效果。本服务支持以驾驶轨迹点、时间来进行查询历史路况&事件。
请求地址
URL | https://tsapi.amap.com/v1/logistics/road/tmcstatus?key=<用户key> |
请求方式 | post |
特别注意：该接口是物流API服务收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。
请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
time | 时间戳 | 查询指定时间下的路况，格式：Unix时间戳，支持90天内任意时间，精确到秒。 | 是 | 无 |
dataRange | 查询数据范围 | 查询数据范围： 1：路况数据。（路况支持查90天以内）（默认） 2：事件数据。（事件支持查30天以内） 3：路况&事件数据。 | 是 | 1 |
points | 轨迹点 | 填入规则：X,Y，经纬度之间采用","分隔，不同点位之间采用“;”分隔。例如“ 117.500244, 40.417801 ; 117.500244, 40.417801;117.500244, 40.417801 ”。 1、points应在5-1000个点范围内，超出1000点时，会截取前1000个点进行计算。 2、单次请求的总里程不超过5km，超过则截取前5km的道路返回结果。 | 是 | 无 |
请求示例
curl --location 'https://tsapi.amap.com/v1/logistics/road/tmcstatus?key=simple_key' \
--header 'Content-Type: application/json' \
--data '{
"points": "116.383503,39.907081;116.384485,39.907107;116.385655,39.90714;116.386607,39.907163;116.387873,39.907198"
,"time": 1729503960,
,"dataRange": 3
}'
返回结果
参数 | 含义 | 字段类型 | 说明 |
errcode | 返回结果状态码 | | |
errdetail | 返回结果描述 | | |
errmsg | 返回结果状态码描述 | | |
data | | | |
| tmcTime | 时间批次 | int | |
polyline | 分路段坐标点串 | string | 两点间用“;”分隔。此坐标点是经过纠偏后的坐标点，与入参坐标不同。 |
tmsStatus | 路况信息 | string | 各路况取值见附录 相同的状态的点位进行聚合。用位置标记来表达。例如：“0-23,0;23-65,1”代表0-23点，路况状态为0；23-65点路况状态为1。 0和5都代表了没有路况状态。 |
roadClass | 道路等级 | string | 各道路等级取值见附录 相同类型的点位进行聚合，用位置标记来表达，例如："0-19,9;19-23,10;23-27,8;27-65,7" |
roadName | 道路名 | string | 相同名称的的道路聚合，用位置标记来表达，例如：“23-45,长江路;45-54,白马湖路;54-65,江虹南路” |
events | 事件 | jsonArray | |
| eventId | 事件id | int | |
daySel | 时间重复类型 | int | 取值规则见附录 |
startDate | 开始日期 | int | 秒级时间戳 |
endDate | 结束日期 | int | 秒级时间戳 |
timeSlot | 时间片 | jsonArray | |
| startTime | 开始时间 | int | 开始时间(从一天0点开始算起的秒级时间戳) |
endTime | 结束时间 | int | 结束时间(从一天0点开始算起的秒级时间戳) |
updateTime | 事件更新时间 | int | 毫秒级时间戳 |
headLine | 事件标题 | string | |
newDesc | 新描述 | string | |
eventDesc | 事件描述 | string | |
brief | 事件简介 | string | |
eventType | 事件类型 | int | 取值规则见附录 |
eventName | 事件名称 | string | |
roadName | 道路名称 | string | |
reliability | 事件可信度 | int | 取值0～10 >=8 表示高可信 |
eventForm | 事件形态 | int | 1-点事件；2-线事件； 3-面事件；4-多线事件 |
geoCoord | 事件坐标 | string | |
附件1：事件时间规则说明
daySel = 0
表示持续，开始时间=startDate+timeSlot[0].startTime；结束时间=endDate+timeSlot[0].endTime
daySel > 0
表示在startDate到endDate范围内指定的星期数，每天都在timeSlot指定的startTime到endTime时间内生效
daySel | 64 | 32 | 16 | 8 | 4 | 2 | 1 |
星期 | 周日 | 周一 | 周二 | 周三 | 周四 | 周五 | 周六 |
127 表示每一天(127=1+2+4+8+16+32+64)
附件2：路况取值对照表
status | desc |
0 | 未知 |
1 | 畅通 |
2 | 缓行 |
3 | 拥堵 |
4 | 严重拥堵 |
5 | 无交通流 |
附件3：道路等级取值对照表
roadClass | desc |
0 | 高速 |
1 | 国道 |
2 | 省道 |
3 | 县道 |
4 | 乡道 |
5 | 县乡村内部路 |
6 | 主要大街、城市快速路 |
7 | 主要道路 |
8 | 次要道路 |
9 | 普通道路 |
10 | 小路、非导航道路 |
附件4：事件类型
类别 | 事件 | 代码 |
事故 | 一般交通事故 | 101 |
施工 | 道路施工 | 201 |
管制 | 交通管制 | 301 |
道路关闭 | 302/*302 |
路面 | 路面积水 | 501 |
路面积雪 | 502 |
路面有障碍物 | 505 |
