开发 物流服务API 开发指南 数据查询服务 道路动态信息洞察服务

道路动态信息洞察服务 最后更新时间: 2024年12月03日

产品简介

高德地图道路动态信息洞察服务服务,主要目的是在客户的安全、风控、定责等场景,通过对历史路况&事件的查询,辅助判断当时的驾驶行为是否合理,以达到安全监督、责任判定等效果。本服务支持以驾驶轨迹点、时间来进行查询历史路况&事件。

请求地址

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

point

轨迹点

填入规则:X,Y,经纬度之间采用","分隔,不同点位之间采用“;”分隔。例如“ 117.500244, 40.417801 ; 117.500244, 40.417801;117.500244,   40.417801 ”。

1、points应在5-500点,超出则返回错误。2、单次请求的整体总里程不超过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

严重交通事故

102

故障车

103

施工

道路施工

201

施工影响出行

202

施工不建议穿行

203

施工在建

201399

管制

交通管制

301

道路关闭

302

天气

大风

401

403

大雾

404

405

大雨

406

雨夹雪

407

408

大雪

409

冰雹

410

台风

419

暴雨

430

大暴雨

431

特大暴雨

432

中雪

434

暴雪

435

路面

路面积水

501

路面积雪

502

路面薄冰

503

路面沉陷

504

路面有障碍物

505

活动

博览会

601

国家重大活动

602

集会

603

大型会议

604

体育活动

605

文艺活动

606

节假日

607

其他

公告

901

事故&道路关闭

一般交通事故&道路关闭

101302

严重交通事故&道路关闭

102302

施工&道路关闭

道路施工&道路关闭

201302

天气&道路关闭

大雾&道路关闭

404302

大雨&道路关闭

406302

大雪&道路关闭

409302

冰雹&道路关闭

410302

路面&道路关闭

路面积水&道路关闭

501302

路面积雪&道路关闭

502302

路面薄冰&道路关闭

503302

路面沉陷&道路关闭

504302

路面有障碍物&道路关闭

505302

严重火灾&道路关闭

506302

活动&道路关闭

博览会&道路关闭

601302

国家重大活动&道路关闭

602302

集会&道路关闭

603302

大型会议&道路关闭

604302

体育活动&道路关闭

605302

文艺活动&道路关闭

606302

节假日&道路关闭

607302

灾害&道路关闭

洪水&道路关闭

701302

地震&道路关闭

702302

岩崩&道路关闭

703302

坍坡&道路关闭

704302

泥石流&道路关闭

705302

返回顶部 示例中心 常见问题 智能客服 公众号
二维码