创建应用,发布应用版本方法参 见:更新应用版本状态。
1.1.12 长期交通事件管理
1.1.12.3 查询长期交通事件
功能介绍
查询长期交通事件
URI
GET /v1/{project_id}/traffic-events/{event_id}
表1-205 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明:项目ID。获取方法请 参见 获取项目ID。
取值范围:仅支持数字,a到f的 小写字母组合,长度32。
正则匹配:^[0-9a-f]{32}$
event_id 是 String 参数说明:事件ID,创建事件后 获得。方法参见 新增交通事
件。
最小长度:0 最大长度:255
请求参数
表1-206 请求 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-207 响应 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-208 EventLocation
参数 参数类型 描述
lat Number 参数说明:定义纬度数值,北纬为正,南纬为 负,单位°,精度小数点后7位。
最小值:-90 最大值:90
表1-209 EventReferencePath
参数 参数类型 描述
active_path Array of EventLocatio n objects
参数说明:激活路径。
path_radius Integer 参数说明:事件的影响区域半径,可选,单位为 分米。用半径表示影响区域边界离中心线的垂直
GET https://{endpoint}/v1/{project_id}/traffic-events/{event_id}
Content-Type:application/json
{ "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"
}
状态码
状态码 描述
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
错误码
请参见错误码。