创建应用，发布应用版本方法参 见：更新应用版本状态。
1.1.12 长期交通事件管理
1.1.12.2 创建长期交通事件
功能介绍
创建长期交通事件时，平台根据事件的起始时间和结束时间确定当前长期交通事件的 状态。对于活跃状态的交通事件会立即下发给在事件影响范围内的RSU，对于未来事 件则是在事件开始时间点下发到在事件影响范围内的RSU，过期事件不会下发。
URI
POST /v1/{project_id}/traffic-events
表1-197 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
请求参数
表1-198 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
表1-199 请求 Body 参数
参数 是否必选 参数类型 描述
event_source_
type 是 String 参数说明：事件来源类型列表,
支持事件来源。
取值范围：
● unknown：未知数据
● police：警方数据
● government：政府数据
● meteorological：气象数据
● internet：互联网数据
● detection：检测器检测到的 数据
● v2xServer：平台上报数据
● rsu：RSU上报数据
● obu：车载终端上报数据 正则匹配：^(unknown|police|
government|meteorological|
internet|detection|v2xServer|
rsu|obu)$
event_source_
id 否 String 参数说明：事件来源的ID，由用
户自定义。
最小长度：0 最大长度：255
参数 是否必选 参数类型 描述
event_class 是 String 参数说明：事件类型，参照附录
《国标交通事件及标志列表》文
event_type 是 Integer 参数说明：事件类型，参照附录
《国标交通事件及标志列表》文
件。最小值：0 最大值：1000
area_code 是 Integer 参数说明：区域码，参考区域码
查询。
最小值：100000 最大值：999999
event_level 否 Integer 参数说明：事件优先级，0-7越 大优先级越高。
最小值：0 最大值：7 event_params 否 Map<String,St
ring> 参数说明：事件附加信息，由用 户自定义。
event_positio
n 是 EventLocatio
n object 参数说明：事件位置。
n_name 是 String 参数说明：事件所在位置。
最小长度：0 最大长度：255
参数 是否必选 参数类型 描述
start_time 是 String 参数说明：开始时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
正则匹配：^\d{4}-\d{2}-\d{2}T
\d{2}:\d{2}:\d{2}Z$
end_time 是 String 参数说明：结束时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
最小长度：0 最大长度：255
正则匹配：^\d{4}-\d{2}-\d{2}T
\d{2}:\d{2}:\d{2}Z$
note 否 String 参数说明：备注。
最小长度：0 最大长度：255 event_confide
nce 否 Integer 参数说明：事件可信度。
最小值：0 最大值：1000
表1-200 EventLocation
参数 是否必选 参数类型 描述
lat 否 Number 参数说明：定义纬度数值，北纬
为正，南纬为负，单位°，精度 小数点后7位。
最小值：-90 最大值：90
lon 否 Number 参数说明：定义经度数值。东经
为正，西经为负，单位°，精度 小数点后7位。
最小值：-180 最大值：180
表1-201 EventReferencePath
参数 是否必选 参数类型 描述
active_path 否 Array of EventLocatio n objects
参数说明：激活路径。
path_radius 否 Integer 参数说明：事件的影响区域半 径，可选，单位为分米。用半径 表示影响区域边界离中心线的垂 直距离，反映该区域的宽度以覆 盖实际路段。
最小值：0
最大值：2147483647 缺省值：1000
响应参数
状态码： 201
表1-202 响应 Body 参数
参数 参数类型 描述
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上报数据
● obu：车载终端上报数据 event_source_
id String 参数说明：事件来源的ID，由用户自定义。
最小长度：0 最大长度：255
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-203 EventLocation
参数 参数类型 描述
lat Number 参数说明：定义纬度数值，北纬为正，南纬为 负，单位°，精度小数点后7位。
最小值：-90 最大值：90
表1-204 EventReferencePath
参数 参数类型 描述
active_path Array of EventLocatio n objects
参数说明：激活路径。
path_radius Integer 参数说明：事件的影响区域半径，可选，单位为 分米。用半径表示影响区域边界离中心线的垂直
POST https://{endpoint}/v1/{project_id}/traffic-events Content-Type:application/json
X-Auth-Token:********
Instance-Id:********
{ "note" : "note", "event_source_id" : "11",
"event_source_type" : "unknown", "area_code" : 440300,
"event_description" : "123",
"end_time" : "2022-01-05T21:25:14Z", "event_confidence" : 1,
"reference_paths" : [ { "path_radius" : 1000,
"event_params" : {
"user_defined_param1" : "10"
}, "event_position_name" : "深圳市龙岗区坂田华为基地F4", "event_position" : {
"lon" : 12.123654789, "lat" : 12.123654789
}, "start_time" : "2021-12-30T21:25:14Z", "event_type" : 100,
"event_class" : "AbnormalTraffic", "event_level" : 1
}
响应示例
状态码： 201 Created
{ "status" : "Active",
"event_id" : "bdd0da88-a22c-4259-8679-947b772512a3", "event_source_type" : "v2xServer",
"event_source_id" : 301,
"event_class" : "AbnormalVehicle", "event_type" : 903,
"area_code" : 440330, "event_level" : 0, "event_params" : { "additionalProp1" : "50", "additionalProp2" : "50", "additionalProp3" : "50"
}, "event_position" : { "lat" : 22.123456, "lon" : 114.123456
}, "event_description" : "qCSYD6jdXBLlm65GB9TguIV1ra80Mc0k", "reference_paths" : [ {
"active_path" : [ {
"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 }
状态码
状态码 描述
201 Created 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 409 Conflict
429 Too Many Requests 500 Internal Server Error