adcode

区县级行政区划编码（adcode），可参考百度地图行政区划 adcode 映射表

110106

int

是

update_time

事件更新时间，查询此时间点之后的增量数据。UNIX 时间戳（秒），不支持未来时间。

不传：默认取“当前时间 - 5 分钟”，即返回最近 5 分钟内的增量事件。

传 0：返回全部当前未下线的事件（全量拉取），结果按事件创建时间排序。是否当前生效需结合 start_time 和 offline_time 判断。

传具体时间戳：返回该时间点之后有更新的事件（增量拉取），结果按事件更新时间排序。

增量同步建议：首次调用传上次同步完成的时间戳（或传 0 拉全量）；后续调用传上一次返回结果中最大的 update_time，而不是当前时间，避免遗漏数据。分页查询时，第 2、3…页的 update_time 必须与第 1 页保持一致。

示例：当前时间为 5，传 update_time=5，返回所有 update_time ≥ 5 的事件，假设结果中最大 update_time 为 9；下次查询时间为 10 时，应传 update_time=9，而不是 10。

0

int

否

road_type

按道路类型筛选，取值范围 1~9（见附录道路类别）。如设置 3，则只返回道路类型 ≤ 3 的事件

3

int

否

page_num

页码，从 1 开始。不传或传 0 时按第一页处理

1

int

否

page_size

单页返回记录数，默认 100，最大 500

100

int

否

output_geo_type

控制 geo_info 中地理信息的输出类型。可选值：

1：输出原始经纬度坐标

3：输出 linkid 及其相关参数（offset、length、heading、kind）

1

string

是

vehicle_type

按事件影响的车辆类型筛选，多个类型用英文逗号分隔。取值：1 小客车、2 货车、3 摩托车、4 关联客车、5 关联货车、6 关联摩托车。不传或传空表示不按车型过滤，返回所有事件

1,2

string

否

ak

开发者密钥，用于服务鉴权与配额统计

您的ak

string

是

status

int

状态码，0 表示成功，其他取值详见下方服务状态码

message

string

状态码对应的说明信息

total

int

满足查询条件的事件总数

size

int

本次返回的事件条数

events

array

事件列表。默认按事件更新时间排序；update_time 传 0 全量拉取时按事件创建时间排序

int

事件唯一标识

int

事件状态。6：正常发布；7：事件已下线

int

事件类型编码，取值见附录“type 与 type_desc 对应关系”

string

事件类型描述，与 type 的对应关系见附录

string

事件严重程度。1：一般；2：重要；3：轻微；4：严重（3、4 目前仅路面事件使用）

int

对道路通行能力的影响。0：影响未知；1：无影响；2：通行能力下降；3：完全阻断；4：交限阻断（禁左、禁右、禁调头）

string

事件影响的车辆类型列表，多个用英文逗号分隔。取值：1 小客车、2 货车、3 摩托车、4 关联客车、5 关联货车、6 关联摩托车。为空表示影响所有车辆类型

string

事件开始生效时间

string

事件失效时间

string

事件更新时间，可作为下一次增量查询的 update_time 入参

string

事件标题

string

事件内容

object

事件地理信息

adcode

int

行政区划编码，取值可参考百度地图行政区划 adcode 映射表

province

string

省份名称

city

string

城市名称

road_name

string

道路名称

road_type

int

道路类型，见附录道路类别

icon_location

string

事件显示坐标，格式为“经度,纬度”。坐标系为gcj02ll

geo_coordinates

object

地理坐标信息，由 output_geo_type 决定是否返回

locations

array

位置引用列表，一个事件可能影响多段道路

geo_type

int

几何类型。1：点；2：线

coordinates

string

位置坐标串，格式为“经度,纬度;经度,纬度;…”。坐标系为gcj02ll

linkid

string

道路 link 标识。单向通行的 link 末尾补 0；双向通行的 link 拆分为两条，正向末尾补 0，逆向末尾补 1

offset

int

事件起点距该 link 起点的长度，与 length 共同确定事件在 link 上的区间。由 output_geo_type 决定是否返回

length

int

事件在该 link 上的影响长度。由 output_geo_type 决定是否返回

heading

int

事件影响方向（相对 link 走向，起点→终点为“顺”）。1：双向；2：单向顺；3：单向逆。注意这是事件影响的方向而非道路通行方向，双向道路上的事件也可能只影响单向

kind

int

该 link 的道路等级，取值同 road_type（见附录道路类别）

0

正常

1

服务内部错误

2

参数非法：必填参数缺失或取值不合法，message 返回具体原因

1001

无数据访问权限：检索结果中存在当前 ak 未获授权的行政区划数据，此时不返回任何事件

其他

鉴权失败（如 ak 无效、未开通该服务）时，原样返回鉴权服务的状态码与说明，例如 240“APP 服务被禁用”