开发 Web服务 API 开发指南 基础 API 文档 交通事件

交通事件 最后更新时间: 2023年04月28日

产品介绍

说明:交通事件接口属于商业化接口,如需申请请通过工单进行商务咨询。

使用API前您需先申请Key,若无高德地图API账号需要先申请账号。交通事件查询接口可以获取授权城市有效事件,包括事故、施工、管制等信息。与导航结合为用户提供智能化的出行方案、避让问题路段;语音播报提升行车安全,让路径动态尽在其掌控。主要用于事件图层渲染、统计、融合计算等场景。支持全国360+城市,更新频率2分钟。

使用限制

使用城市/区域授权+时间包年方式,有每日访问量/QPS限制

使用说明

第一步,申请”Web服务API接口”密钥(Key)

第二步,如需申请请通过工单进行商务咨询

第三步,根据授权文档进行动态鉴权访问

交通事件查询

API查询地址:

URL

https://et-api.amap.com/event/queryByAdcode

请求方式

http协议,GET方法,不支持JSONP/callback参数

  • 请求参数

参数名

说明

必填

备注

adcode

城市代码

授权城市ADCODE(城市级)

clientKey

请求服务权限标识

用户在高德开放平台官网申请Web服务API类型KEY

timestamp

时间戳

秒时间,例如1621243952 单位秒

digest

鉴权动态密钥

根据授权密钥计算出的动态鉴权信息

eventType

事件类型

仅获取对应类型事件,多个;分割

isExpressway

只获取高速

仅获取高速类事件。1-是   0-否

  • 返回结果参数说明

返回结果为JSON格式

参数名称

二级参数

描述与取值说明

备注

code+msg 


调用成功,常见代码:

0:Successful.   成功


data





brief

事件标题



endTime

事件预计结束时间



eventDesc

事件描述



eventID

事件id



eventType

事件类型码



expressway

是否高速

1-是

0-否



lines

线路坐标



nickName

发布方名称



offcial

是否权威发布

0-官方

1-权威

2-UGC



picture

事件图片链接



roadName

道路名称



source

数据源编号



startTime

事件开始时间



updateTime

事件最后更新时间



x

经度坐标



y

维度坐标


  • 服务示例
//以下为json格式代码
{
    "code": 1,
    "data": [
    {
        "brief": "张河高速服务区附近南向北正在施工。",  // 事件标题
        "endTime": "2018-05-13 8:11:0",          // 事件预计结束时间
        "eventDesc":                             // 事件描述
                     "张河高速施工:张河高速南向北施工,2018年04月28日08:11到2018年05月13日08:11",
        "eventID": 5366913,                     // 事件id
        "eventType": 201,                       // 事件类型码
        "expressway": 1,                        // 是否高速
        "lines":                                // 线路坐标
                 "102.0647958,35.6291286;102.0652033,35.6301692;102.0665325,35.6332136",
        "nickName": "高德交通",               // 发布方名称
        "offcial": 1,                          //  是否权威发布
        "picture": "",                         // 事件图片链接
        "roadName": "张河高速",                 // 道路名称
        "source": 262,                        //  数据源编号
        "startTime": "2018-04-28 8:11:0",     //  事件开始时间
        "updateTime": "2018-05-07 22:47:18",  //  事件最后更新时间
        "x": 102.0648,                        //  经度坐标
        "y": 35.62913                         // 纬度坐标
    },
    {
        "brief": "张河高速服务区附近北向南正在施工。",
        "endTime": "2018-05-13 8:11:0",
        "eventDesc": "张河高速施工:张河高速北向南施工,2018年04月28日08:11到2018年05月13日08:11",
        "eventID": 5366911,
        "eventType": 201,
        "expressway": 1,
        "lines": "102.0665169,35.6333375;102.0651394,35.6301856;102.0647158,35.6290914",
        "nickName": "高德交通",
        "offcial": 1,
        "picture": "",
        "roadName": "张河高速",
        "source": 262,
        "startTime": "2018-04-28 8:11:0",
        "updateTime": "2018-05-07 22:46:47",
        "x": 102.06652,
        "y": 35.63334
    }]
}
返回顶部 示例中心 常见问题 智能客服 公众号
二维码