创建应用，发布应用版本方法参 见：更新应用版本状态。
1.1.12 长期交通事件管理
1.1.12.1 查询长期交通事件列表
功能介绍
条件查询交通事件
URI
GET /v1/{project_id}/traffic-events
表1-190 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
表1-191 Query 参数
参数 是否必选 参数类型 描述
offset 否 Integer 参数说明：查询事件列表的页
参数 是否必选 参数类型 描述
limit 否 Integer 参数说明：查询时每页显示的记
录数。
最小值：1 最大值：20 缺省值：10
area_code 否 Integer 参数说明：区域码，参考区域码
查询。
最小值：0 最大值：999999
status 否 String 参数说明：事件状态。
取值范围：
● Invalid：为过期事件，事件 结束时间（end_time）在当 前时间之前。
● Active：为活动事件，事件 开始时间（start_time）在当 前时间之前，并且事件结束 时间（end_time）在当前时 间之后。
● Future：为未来事件，事件 开始时间（start_time）在当 前时间之前。
缺省值：all
正则匹配：(all|Future|Active|
Invalid)
event_type 否 Integer 参数说明：事件类型，参照附录
《国标交通事件及标志列表》文
件。当填写event_type时，event_class为必选。
最小值：0 最大值：1000
参数 是否必选 参数类型 描述 event_source_
type 否 Array 参数说明：事件来源类型列表,
支持事件来源。
取值范围：
● unknown：未知数据
● police：警方数据
● government：政府数据
● meteorological：气象数据
● internet：互联网数据
● detection：检测器检测到的 数据
● v2xServer：平台上报数据
● rsu：RSU上报数据
● obu：车载终端上报数据 event_class 否 String 参数说明：事件类型，参照附录
《国标交通事件及标志列表》文
件。当填写event_type时，event_class为必选。
最小长度：0 最大长度：255
event_id 否 String 参数说明：事件ID，创建事件后 获得。方法参见 新增交通事
件。
最小值：0 最大值：255
from_time 否 String 参数说明：查询事件上报时间段 的起始时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z'。
例如 2020-09-01T01:37:01Z。
正则匹配：^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:
[0-9]{2}.[0-9]{3}Z$
to_time 否 String 参数说明：查询事件上报时间段
的结束时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z'。
参数 是否必选 参数类型 描述
sort_key 否 String 参数说明：按照哪一个字段排
序,默认按事件开始时间。
最小长度：0 最大长度：255 枚举值：
● start_time
● end_time
● created_time
● last_modified_time
sort_dir 否 String 参数说明：升序或降序，升序为
ASC, 降序为DESC，默认降序。
枚举值：
● ASC
● DESC
请求参数
表1-192 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
取Instance-Id。
取值范围：仅支持数字，小写字 母和横杠（-）的组合，长度 36。
正则匹配：^[a-z0-9-]{36}$
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
响应参数
状态码： 200
表1-193 响应 Body 参数
参数 参数类型 描述
count Long 参数说明：返回条目总数量。
最小值：0
最大值：2147483647 events Array of
TrafficEvent DTO objects
参数说明：事件列表。
表1-194 TrafficEventDTO
参数 参数类型 描述
status String 参数说明：事件状态。
取值范围：
● Invalid：为过期事件，事件结束时间
（end_time）在当前时间之前。
● Active：为活动事件，事件开始时间
（start_time）在当前时间之前，并且事件结 束时间（end_time）在当前时间之后。
● Future：为未来事件，事件开始时间
（start_time）在当前时间之前。
event_id String 参数说明：事件ID，创建事件后获得。方法参见
新增交通事件。
最小长度：0 最大长度：255 event_source_
type String 参数说明：事件来源类型列表,支持事件来源。
取值范围：
● unknown：未知数据
● police：警方数据
● government：政府数据
● meteorological：气象数据
● internet：互联网数据
● detection：检测器检测到的数据
● v2xServer：平台上报数据
● rsu：RSU上报数据
参数 参数类型 描述
event_class String 参数说明：事件类型，参照附录《国标交通事件
及标志列表》文件。当填写event_type时，
event_class为必选。
event_type Integer 参数说明：事件类型，参照附录《国标交通事件
及标志列表》文件。
最小值：0 最大值：1000
area_code Integer 参数说明：区域码，参考区域码查询。
最小值：0 最大值：999999
event_level Integer 参数说明：事件优先级，0-7越大优先级越高。
最小值：0 最大值：7 event_params Map<String,St
ring> 参数说明：事件附加信息，由用户自定义。
event_positio
n EventLocatio
n object 参数说明：事件位置。
event_descript
ion String 参数说明：事件描述。
最大长度：255
正则匹配：^[^\u4e00-\u9fa5_]{0,255}$
reference_pat
hs Array of EventReferen
n_name String 参数说明：事件所在位置。
最小长度：0 最大长度：255
start_time String 参数说明：开始时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
end_time String 参数说明：结束时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
note String 参数说明：备注。
最小长度：0 最大长度：255
参数 参数类型 描述 event_confide
nce Integer 参数说明：事件可信度。
最小值：0 最大值：1000
created_time String '参数说明：创建时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
last_modified
_time String 参数说明：最后修改的时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
表1-195 EventLocation
参数 参数类型 描述
lat Number 参数说明：定义纬度数值，北纬为正，南纬为 负，单位°，精度小数点后7位。
最小值：-90 最大值：90
lon Number 参数说明：定义经度数值。东经为正，西经为 负，单位°，精度小数点后7位。
最小值：-180 最大值：180
表1-196 EventReferencePath
参数 参数类型 描述
active_path Array of EventLocatio n objects
参数说明：激活路径。
path_radius Integer 参数说明：事件的影响区域半径，可选，单位为 分米。用半径表示影响区域边界离中心线的垂直 距离，反映该区域的宽度以覆盖实际路段。
最小值：0
最大值：2147483647 缺省值：1000
e_type={event_source_type}&event_class={event_class}&event_id={event_id}&from_time={from_time}&to_ti
"event_id" : "bdd0da88-a22c-4259-8679-947b772512a3", "event_source_type" : "v2xServer",
"event_source_id" : 301,
"event_class" : "AbnormalVehicle", "event_type" : 903,
"event_description" : "qCSYD6jdXBLlm65GB9TguIV1ra80Mc0k", "reference_paths" : [ {
"event_position_name" : "F4(V2X 办公区域) ", "start_time" : "2021-12-23T08:32:51.618Z", "end_time" : "2021-12-23T08:32:51.618Z", "note" : "note",
"event_confidence" : 100,
"created_time" : "2021-12-23T08:32:51.618Z", "last_modified_time" : "2021-12-23T08:32:51.618Z"
} ] }
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed
状态码 描述 409 Conflict
429 Too Many Requests 500 Internal Server Error
错误码
请参见错误码。