华为云用户手册

  • 响应示例 状态码: 200 OK { "forwarding_type" : "kafka", "kafka_config" : { "kafka_config_id" : "1234567890", "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "topic_prefix" : "abc", "status" : "ONLINE", "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-13T12:12:12Z" }, "mrs_kafka_config" : { "kafka_config_id" : null, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : null, "status" : null, "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" }}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 forwarding_type String 参数说明:转发配置的类型。 取值范围:当前仅支持“kafka、mrskafka”。 kafka_config_id String 参数说明:每一套Kafka配置的唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:1 最大长度:255 kafka_topics Array of strings 参数说明:kafka的主题列表。 取值范围: v2x-v1-tracks:edge上报的车辆轨迹数据 v2x-v1-bsm:车载T-BOX,mqtt协议接入rsu, websocket协议接入rsu上报的BSM消息数据 v2x-v1-rsi:mqtt协议接入rsu,edge上报的RSI消息数据 v2x-v1-rsm: mqtt协议接入rsu,edge上报的RSM消息数据 v2x-v1-spat:mqtt协议接入rsu, websocket协议接入rsu上报的SPAT消息数据 v2x-v1-edge-flow:edge上报的车流量统计信息数据 brokers Array of strings 参数说明:Kafka broker列表。 最小长度:1 最大长度:255 username String 参数说明:kafka用户名。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:1 最大长度:255 topic_prefix String 参数说明:Topic前缀。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:0 最大长度:255 status String 参数说明:一套kafka的连接状态。 取值范围: OFFLINE:离线 ONLINE:在线 枚举值: OFFLINE ONLINE authentication Boolean 参数说明:是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值:false created_time String 参数说明:创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z last_modified_time String 参数说明:修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z
  • 响应示例 状态码: 200 OK { "forwarding_type" : "kafka", "kafka_config_id" : 1234567890, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "topic_prefix" : "prefix", "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "status" : "OFFLINE", "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z"}
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和连接符(-)的组合,长度36。 X-Auth-Token 否 String 参数说明:用户Token,Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:1 最大长度:20000
  • URI DELETE /v1/{project_id}/forwarding-configs/{forwarding_config_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见 获取项目ID。 取值范围:仅支持数字,a到f的小写字母组合,长度32。 forwarding_config_id 是 String 参数说明:转发配置的唯一ID。 最小长度:1 最大长度:255 表2 Query参数 参数 是否必选 参数类型 描述 forwarding_type 是 String 参数说明:转发配置的类型。 取值范围:当前仅支持“kafka,mrskafka”。 最小长度:1 最大长度:255
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Integer 参数说明:满足查询条件的记录总数。 最小值:0 最大值:10000 forwarding_configs Array of ForwardingConfig objects 参数说明:转发配置的列表。 表5 ForwardingConfig 参数 参数类型 描述 forwarding_type String 参数说明:转发配置的类型。 取值范围:当前仅支持“kafka、mrskafka”。 kafka_config KafkaConfigResponseDTO object 参数说明:Kafka配置信息。 mrs_kafka_config MrsKafkaConfigResponseDTO object 参数说明:mrsKafka配置信息。 表6 KafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明:每一套Kafka配置的唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:1 最大长度:255 kafka_topics Array of strings 参数说明:kafka的主题列表。 取值范围: v2x-v1-tracks:edge上报的车辆轨迹数据 v2x-v1-bsm:车载T-BOX,mqtt协议接入rsu, websocket协议接入rsu上报的BSM消息数据 v2x-v1-rsi:mqtt协议接入rsu,edge上报的RSI消息数据 v2x-v1-rsm: mqtt协议接入rsu,edge上报的RSM消息数据 v2x-v1-spat:mqtt协议接入rsu, websocket协议接入rsu上报的SPAT消息数据 v2x-v1-edge-flow:edge上报的车流量统计信息数据 brokers Array of strings 参数说明:Kafka broker列表。 最小长度:1 最大长度:255 username String 参数说明:kafka用户名。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:1 最大长度:255 topic_prefix String 参数说明:Topic前缀。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:0 最大长度:255 status String 参数说明:一套kafka的连接状态。 取值范围: OFFLINE:离线 ONLINE:在线 枚举值: OFFLINE ONLINE created_time String 参数说明:创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z last_modified_time String 参数说明:修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z 表7 MrsKafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明:每一套Kafka配置的唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:1 最大长度:255 kafka_topics Array of strings 参数说明:kafka的主题列表。 取值范围: v2x-v1-tracks:edge上报的车辆轨迹数据 v2x-v1-bsm:车载T-BOX,mqtt协议接入rsu, websocket协议接入rsu上报的BSM消息数据 v2x-v1-rsi:mqtt协议接入rsu,edge上报的RSI消息数据 v2x-v1-rsm: mqtt协议接入rsu,edge上报的RSM消息数据 v2x-v1-spat:mqtt协议接入rsu, websocket协议接入rsu上报的SPAT消息数据 v2x-v1-edge-flow:edge上报的车流量统计信息数据 brokers Array of strings 参数说明:Kafka broker列表。 最小长度:1 最大长度:255 username String 参数说明:mrskafka用户名,若开启安全认证该参数必填。 取值范围:只允许字母、数字、下划线(_)、连接符(-)的组合。 最小长度:0 最大长度:255 status String 参数说明:一套kafka的连接状态。 取值范围: OFFLINE:离线 ONLINE:在线 枚举值: OFFLINE ONLINE authentication Boolean 参数说明:是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值:false created_time String 参数说明:创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z last_modified_time String 参数说明:修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如:2015-12-12T12:12:12Z
  • 响应示例 状态码: 200 OK { "count" : 1, "forwarding_configs" : [ { "forwarding_type" : "kafka", "kafka_config" : { "kafka_config_id" : "1234567890", "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "topic_prefix" : "abc", "status" : "ONLINE", "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-13T12:12:12Z" }, "mrs_kafka_config" : { "kafka_config_id" : null, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : null, "status" : null, "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" } } ]}
  • 响应示例 状态码: 200 OK { "edge_app_id" : "14414341626215826433476361010249", "version" : "1.0.2", "description" : "hello", "created_time" : "2020-05-28T11:31:29.740Z", "last_modified_time" : "2020-05-28T11:31:29.740Z", "state" : "DRAFT", "command" : [ "tets" ], "args" : [ "tets" ], "container_settings" : { "configs" : { "privileged" : false, "host_network" : true, "restart_policy" : "Always", "container_port_list" : [ { "container_port" : 2656, "host_port" : 2656, "host_ip" : "1.1.1.1" } ] }, "image_url" : "/sfwevwefw", "envs" : { "test" : "test" }, "volumes" : [ { "name" : "config", "type" : "LOG", "source" : "/iot/opt/test", "destination" : "/iot/opt/test", "read_only" : false } ], "resources" : { "limits" : { "cpu" : 2, "memory" : 2, "gpu" : 2, "npu" : 2 }, "requests" : { "cpu" : 4, "memory" : 4, "gpu" : 4, "npu" : 4 } }, "ext_devices" : null }, "publish_time" : "2020-05-28T11:31:29.740Z", "off_shelf_time" : "2020-05-28T11:31:29.740Z"}
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明:用户自定义应用唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)、美元符号($)的组合。 最小长度:0 最大长度:32 version String 参数说明:应用版本。 最小长度:0 最大长度:32 description String 参数说明:应用描述。 取值范围:只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 最小长度:0 最大长度:255 created_time String 参数说明:创建时间。 最小长度:0 最大长度:255 last_modified_time String 参数说明:最后一次修改时间。 最小长度:0 最大长度:255 state String 参数说明:应用版本状态。 取值范围: DRAFT:草稿 PUBLISHED:发布 OFF_SHELF:下线 command Array of strings 参数说明:启动命令。 args Array of strings 参数说明:启动参数。 container_settings ContainerSettingsDTO object 参数说明:容器配置。 publish_time String 参数说明:发布时间。 最小长度:0 最大长度:255 off_shelf_time String 参数说明:下线时间。 最小长度:0 最大长度:255 表4 ContainerSettingsDTO 参数 参数类型 描述 configs ContainerConfigsDTO object 参数说明:容器特殊参数。 image_url String 参数说明:镜像存储地址。 最小长度:1 最大长度:1000000 envs Object 参数说明:环境变量。 volumes Array of VolumeDTO objects 参数说明:卷配置。 resources ResourceDTO object 参数说明:资源配额。 ext_devices Array of ExtDevice objects 参数说明:外挂设备配置。 表5 ContainerConfigsDTO 参数 参数类型 描述 privileged Boolean 参数说明:开启容器特权模式。 缺省值:false host_network Boolean 参数说明:是否使用主机网络模式。 缺省值:true restart_policy String 参数说明:重启策略,容器执行健康检查后失败后的策略。 最小长度:1 最大长度:255 container_port_list Array of ContainerPortDTO objects 参数说明:容器端口映射值。 表6 ContainerPortDTO 参数 参数类型 描述 container_port Integer 参数说明:构成一堆映射的容器端口。 最小值:1 最大值:65535 host_port Integer 参数说明:构成一对映射的物理机对应网卡端口。 最小值:1 最大值:65535 host_ip String 参数说明:对应网卡地址。 表7 VolumeDTO 参数 参数类型 描述 name String 参数说明:卷名称。 最小长度:1 最大长度:63 type String 参数说明:挂载类型。 source String 参数说明:源路径。 destination String 参数说明:卷挂载路径。 read_only Boolean 参数说明:只读,默认只读。 表8 ResourceDTO 参数 参数类型 描述 limits ResourceConfigDTO object 参数说明:允许容器使用的最大资源。 requests ResourceConfigDTO object 参数说明:容器需要使用的最小资源。 表9 ResourceConfigDTO 参数 参数类型 描述 cpu Float 参数说明:cpu个数。 最小值:0.01 最大值:1000 memory Float 参数说明:内存大小。 最小值:0.01 最大值:1024000 gpu Float 参数说明:gpu个数。 最小值:0.01 最大值:1024000 npu Float 参数说明:npu个数。 最小值:0.01 最大值:1000 表10 ExtDevice 参数 参数类型 描述 source String 参数说明:源路径。 destination String 参数说明:卷挂载路径。 cgroup_permissions String 参数说明:只读,默认MRW。 最小长度:1 最大长度:63
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明:用户自定义应用唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)、美元符号($)的组合。 最小长度:1 最大长度:32 description String 参数说明:应用描述。 取值范围:只允许中文、字母、数字、下划线(_)、中文分号(;)、中文冒号(:)、中文问号(?)、中文感叹号(!)中文逗号(,)、中文句号(。)、英文引号(;)、英文冒号(:)、英文逗号(,)、英文句号(.)、英文问号(?)、英文感叹号(!)、顿号(、)、连接符(-)的组合。 最小长度:0 最大长度:255 created_time String 参数说明:创建时间。 最小长度:0 最大长度:255 last_modified_time String 参数说明:更新时间。 最小长度:0 最大长度:255 last_published_version String 参数说明:最新发布版本。 最小长度:0 最大长度:64
  • 响应示例 状态码: 200 Ok { "edge_app_id" : "13125481330735066213121901779837", "description" : "this is a test app", "created_time" : "2021-12-23T12:29:08", "last_modified_time" : "2021-12-23T12:29:09.367", "last_published_version" : null}
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和连接符(-)的组合,长度36。 X-Auth-Token 否 String 参数说明:用户Token,Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:1 最大长度:20000
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 v2x_edge_id String 参数说明:Edge ID,用于唯一标识一个Edge。 最小长度:0 最大长度:255 edge_app_id String 参数说明:用户自定义应用唯一ID。 最小长度:1 最大长度:32 app_version String 参数说明:应用版本,比如1.0.0。 最小长度:1 最大长度:64 status String 参数说明:应用部署状态。 取值范围: UNINSTALLED:待部署 INSTALLED:部署中 OFFLINE:离线 ONLINE:在线 UPGRADING:升级中 DELETING:删除中 RUNNING:运行中
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和连接符(-)的组合,长度36。 X-Auth-Token 否 String 参数说明:用户Token,Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:1 最大长度:20000
  • URI DELETE /v1/{project_id}/v2x-edges/{v2x_edge_id}/apps/{edge_app_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见 获取项目ID。 取值范围:仅支持数字,a到f的小写字母组合,长度32。 edge_app_id 是 String 参数说明:用户自定义应用唯一ID。 取值范围:只允许字母、数字、下划线(_)、连接符(-)、美元符号($)的组合。 最小长度:1 最大长度:32 v2x_edge_id 是 String 参数说明:Edge ID,用于唯一标识一个Edge,创建Edge后获得。方法参见 创建Edge。 最大长度:255
  • 请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channelContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password" }}
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明:平台类型。 取值范围: DRIS:华为路网数字化平台 LITONG:利通 ZHONGQIYAN:中汽研 platform_para PlatformPara object 参数说明:platform_type为非DRIS时有效,表示第三方平台的对接参数 channel_status String 参数说明:华为路网数字化平台或第三方业务平台连接状态。 取值范围: ONLINE:在线 OFFLINE:离线 INITIAL:初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明:第三方业务平台的ip地址和端口。 username String 参数说明:鉴权用户名。 最小长度:0 最大长度:255 passwd String 参数说明:鉴权密码,ITS800或者ATLAS500的密码 最小长度:0 最大长度:255
  • Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "spat_source" : { "spat_source_type" : "rsu", "spat_source_id" : "RSU0123456789" }, "intersections" : [ { "intersection_id" : { "region" : 1, "node_id" : 301 }, "intersection_status_object" : { "manual_control_is_enabled" : true, "stop_time_is_activated" : false, "failure_flash" : false, "preempt_is_active" : false, "signal_priority_is_active" : false, "fixed_time_operation" : false, "traffic_dependent_operation" : false, "standby_operation" : false, "failure_mode" : false, "controller_off" : false, "recent_map_message_update" : false, "recent_change_in_map_assigned_lanes_ids_used" : false, "no_valid_map_is_available_at_this_time" : false, "no_valid_spat_is_available_at_this_time" : false }, "time_stamp" : "2015-12-12T12:12:12.126Z", "time_confidence" : 5, "phases" : 5 } ], "time_stamp" : "2015-12-12T12:12:12.126Z", "name" : "12345" }}
  • Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XSPATTopicBodyDTO object 参数说明:信号灯消息。 header 是 OpenSPATTopicHeaderDTO object 参数说明:信号灯消息的附加信息。 表2 OpenV2XSPATTopicBodyDTO 参数 是否必选 参数类型 描述 spat_source 否 SPATSource object 参数说明:消息来源。 intersections 是 Array of IntersectionStateDTO objects 参数说明:路口信号灯集合。 time_stamp 否 String 参数说明:平台推送消息的UTC时间。 格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 例如2021-12-18T07:20:51.683Z。 name 否 String 参数说明:供理解的名称描述。 最小长度:1 最大长度:63 表3 SPATSource 参数 是否必选 参数类型 描述 spat_source_type 是 String 参数说明:来源的具体类型。 枚举值: unknown police government meteorological internet detection v2xServer rsu obu signalMachine spat_source_id 否 String 参数说明:来源的唯一标识码ID。 最小长度:0 最大长度:255 表4 IntersectionStateDTO 参数 是否必选 参数类型 描述 intersection_id 是 NodeReferenceId object 参数说明:节点属性ID。 intersection_status_object 否 IntersectionStatusObject object 参数说明:路口信号机的工作状态指示。 time_stamp 否 String 参数说明:信号机发送信号时携带的UTC时间。 格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 如2021-12-18T07:20:51.683Z。 time_confidence 否 Integer 参数说明:数值描述了95%置信水平的时间精度。参考时间精度参数说明。 最小值:0 最大值:39 phases 是 Array of PhaseDTO objects 参数说明:信号灯各道路方向的灯态列表。 表5 NodeReferenceId 参数 是否必选 参数类型 描述 region 否 Integer 参数说明:所在区域在地图中的编号,数值0仅用于测试。 最小值:0 最大值:65535 node_id 是 Integer 参数说明:节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口,也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值:0 最大值:65535 表6 IntersectionStatusObject 参数 是否必选 参数类型 描述 manual_control_is_enabled 否 Boolean 参数说明:手动控制状态开启。 stop_time_is_activated 否 Boolean 参数说明:停止计时状态激活。 failure_flash 否 Boolean 参数说明:用于硬件故障检测。 preempt_is_active 否 Boolean 参数说明:优先状态激活。 signal_priority_is_active 否 Boolean 参数说明:信号优先级状态激活。 fixed_time_operation 否 Boolean 参数说明:固定配时。 traffic_dependent_operation 否 Boolean 参数说明:基于交通流状态的配时。 standby_operation 否 Boolean 参数说明:备用操作,可部分关闭或闪烁。 failure_mode 否 Boolean 参数说明:故障模式。 controller_off 否 Boolean 参数说明:控制状态关闭。 recent_map_message_update 否 Boolean 参数说明:近期地图内容数据更新。 recent_change_in_map_assigned_lanes_ids_used 否 Boolean 参数说明:近期地图道路id数据更新。 no_valid_map_is_available_at_this_time 否 Boolean 参数说明:此时无有效地图。 no_valid_spat_is_available_at_this_time 否 Boolean 参数说明:此时无有效spat信息。 表7 PhaseDTO 参数 是否必选 参数类型 描述 phase_id 是 Integer 参数说明:定义信号灯相位ID。数值0表示无效ID。 最小值:0 最大值:255 phase_states 是 Array of PhaseStateDTO objects 参数说明:一个信号灯的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色,其属性包括了该状态的实时计时信息。 表8 PhaseStateDTO 参数 是否必选 参数类型 描述 light_state 是 Integer 参数说明:定义信号灯相位的灯色状态。支持GB14886规定的红绿黄三种信号灯灯色,以及亮灯、 闪烁和熄灭三种状态。 取值范围: 0:不可用 1:黑色 2:红色闪烁 3:红色 4:绿色闪烁 5:通行允许相位(通行绿) 6:通行保护相位(保护绿) 7:黄色 8:黄色闪烁 最小值:0 最大值:8 timing 否 TimeChangeDetailsDTO object 参数说明:定义一个信号灯相位的计时状态。提供了两种可选的计时状态格式,一种是倒计时形式,另一种是UTC世界标准时间的形式。在实际使用时,由路侧设施根据实际情况选用。 表9 TimeChangeDetailsDTO 参数 是否必选 参数类型 描述 counting 否 TimeCountingDownDTO object 参数说明:用倒计时形式,描述一个信号灯相位状态的完整计时状态。 utc_timing 否 UTCTimingDTO object 参数说明:用UTC世界标准时间形式,描述一个信号灯相位状态的完整计时状态。 表10 TimeCountingDownDTO 参数 是否必选 参数类型 描述 start_time 是 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 min_end_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 max_end_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likely_end_time 是 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 time_confidence 否 Integer 参数说明:定义置信度。单位为0.5%。 最小值:0 最大值:200 next_start_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 next_duration 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表11 UTCTimingDTO 参数 是否必选 参数类型 描述 start_utc_time 是 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 min_end_utc_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 max_end_utc_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likely_end_utc_time 是 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 time_confidence 否 Integer 参数说明:定义置信度。单位为0.5%。 最小值:0 最大值:200 next_start_utc_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 next_end_utc_time 否 TimeMark object 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表12 TimeMark 参数 是否必选 参数类型 描述 time_mark 是 Integer 参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。 取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值:0 最大值:36001 表13 OpenSPATTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。 event 是 String 参数说明:操作描述。" 取值范围: MODIFIED:修改 ADDED:新增 DELETED:删除 枚举值: MODIFIED ADDED DELETED
  • URI DELETE /v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channel 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见 获取项目ID。 取值范围:仅支持数字,a到f的小写字母组合,长度32。 v2x_edge_id 是 String 参数说明:Edge ID,用于唯一标识一个Edge。 最小长度:1 最大长度:255
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。 X-Auth-Token 否 String 参数说明:用户Token,Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:1 最大长度:20000
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 platform_type String 参数说明:平台类型。 取值范围: DRIS:华为路网数字化平台 LITONG:利通 ZHONGQIYAN:中汽研 platform_para PlatformPara object 参数说明:platform_type为非DRIS时有效,表示第三方平台的对接参数 channel_status String 参数说明:华为路网数字化平台或第三方业务平台连接状态。 取值范围: ONLINE:在线 OFFLINE:离线 INITIAL:初始化 表4 PlatformPara 参数 参数类型 描述 address String 参数说明:第三方业务平台的ip地址和端口。 username String 参数说明:鉴权用户名。 最小长度:0 最大长度:255 passwd String 参数说明:鉴权密码,ITS800或者ATLAS500的密码 最小长度:0 最大长度:255
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。 X-Auth-Token 否 String 参数说明:用户Token,Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:1 最大长度:20000
  • 请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channelContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password1" }}
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明:平台类型。 取值范围: DRIS:华为路网数字化平台 LITONG:利通 ZHONGQIYAN:中汽研 platform_para PlatformPara object 参数说明:platform_type为非DRIS时有效,表示第三方平台的对接参数 channel_status String 参数说明:华为路网数字化平台或第三方业务平台连接状态。 取值范围: ONLINE:在线 OFFLINE:离线 INITIAL:初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明:第三方业务平台的ip地址和端口。 username String 参数说明:鉴权用户名。 最小长度:0 最大长度:255 passwd String 参数说明:鉴权密码,ITS800或者ATLAS500的密码 最小长度:0 最大长度:255
  • Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "rsm_source" : { "rsm_source_type" : "rsu", "rsm_source_id" : "RSU0123456789", "esn" : "2102312ETX10K7000037" }, "id" : "12345678", "send_time" : "2020-09-01T01:37:01.123Z", "ref_pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "participant_list" : [ { "ptc_type" : "unknown", "ptc_id" : 3, "global_track_id" : 3, "source" : "rsu", "id" : "1234567890", "sec_mark" : 0, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "pos_confidence" : { "position_confidence" : 10, "ele_confidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "vehicle_color" : "black", "vehicle_model" : "朗逸", "vehicle_brand" : "红旗", "vehicle_style" : "2018,2019,2020", "lane_no" : 1, "gat_vehicle_class" : "K33", "cross_id" : "cross0123456789", "plate_no" : "粤B1234567", "motion_cfd" : { "speed_confidence" : 5, "heading_confidence" : 5, "steer_confidence" : 2 }, "accel_set" : { "long_accel" : 0, "lat_accel" : 0, "vert_accel" : 0, "yaw_rate" : 0 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 }, "vehicle_class" : { "basic_vehicle_class" : 54, "fuel_type" : 5 } } ] }}
  • Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XRSMTopicBodyDTO object 参数说明:路侧动态目标物消息,参考路侧安全消息。来源于边缘感知计算单元分析生成的路侧动态目标物状态数据。 header 是 OpenRSMTopicHeaderDTO object 参数说明:路侧动态目标物数据的附加信息。 表2 OpenV2XRSMTopicBodyDTO 参数 是否必选 参数类型 描述 rsm_source 否 RSMSource object 参数说明:消息来源。 ref_pos 是 Position3D object 参数说明:位置信息。 participant_list 否 Array of ParticipantData objects 参数说明:交通参与者列表。应用于RSM消息,表示当前探测到的所有或者部分交通参与者信息。 表3 RSMSource 参数 是否必选 参数类型 描述 rsm_source_type 是 String 参数说明:信息来源的具体类型描述。 枚举值: rsu obu detection rsm_source_id 否 String 参数说明:信息来源的唯一标识码ID。 最小长度:1 最大长度:255 esn 是 String 参数说明:设备编码。 取值范围:长度不超过64,只允许字母、数字、以及_等字符的组合。 表4 ParticipantData 参数 是否必选 参数类型 描述 ptc_type 是 String 参数说明:路侧单元检测到的交通参与者类型。 取值范围: unknown:未知类型 motor:机动车 non-motor:非机动车 pedestrian:行人 rsu:RSU设备 枚举值: unknown motor non-motor pedestrian rsu ptc_id 是 Integer 参数说明:检测单元设置的临时ID。 最小值:0 最大值:65535 global_track_id 否 Long 参数说明:ITS800通过GlobalTrackID字段标识了车辆唯一ID。 最小值:0 最大值:9223372036854775807 source 是 String 参数说明:定义交通参与者数据的来源。 枚举值: unknown rsu v2x video microwaveRadar loop lidar integrated id 否 String 参数说明:对应BSM消息中车辆ID。 最小长度:8 最大长度:8 sec_mark 是 Integer 参数说明:以0.1 秒为单位,定义1分钟中的毫秒级时刻。分辨率为1毫秒,有效范围是0~59999。 60000及以上表示未知或无效数值。 最小值:0 最大值:65535 pos 是 Position3D object 参数说明:位置信息。 pos_confidence 是 PositionalConfidence object 参数说明:定义当前实时位置(经纬度和高程)的精度大小,包括水平位置精度和高程精度, 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明:车辆档位状态。 0:空档 1:停止档 2:前进档 3:倒档 7:不可用 4~6:预留 最小值:0 最大值:7 speed 是 Integer 参数说明:车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值:0 最大值:8191 heading 是 Integer 参数说明:车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值:0 最大值:28800 angle 否 Integer 参数说明:定义车辆转向轮角度。向右为正,向左为负。单位为1.5°,值为127时代表无效值。 最小值:-126 最大值:127 vehicle_color 否 String 参数说明:车辆颜色。 取值范围: black:黑色 white:白色 gray:灰色 red:红色 blue:蓝色 yellow:黄色 orange:橙色 brown:棕色 green:绿色 purple:紫色 cyan:青色 pink:粉红色 transparent:透明色 other:其他 最小长度:0 最大长度:100 vehicle_model 否 String 参数说明:车辆型号。 最小长度:0 最大长度:31 vehicle_brand 否 String 参数说明:车辆品牌。 最小长度:0 最大长度:31 vehicle_style 否 String 参数说明:车辆年款,通过年份来表示,多个年份通过逗号分隔。 最小长度:0 最大长度:63 lane_no 否 Integer 参数说明:车辆所在车道。默认不携带。 最小值:0 最大值:99 gat_vehicle_class 否 String 参数说明:机动车车辆类型。参考机动车车辆类型。 cross_id 否 String 参数说明:路口id,对应到一组雷视拟合设备,检测一个特定的路口或者路段。 最小长度:0 最大长度:64 plate_no 否 String 参数说明:车牌号。 最小长度:0 最大长度:32 motion_cfd 否 MotionConfidenceSet object 参数说明:描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 否 AccelerationSet4Way object 参数说明:定义车辆四轴加速度。 size 是 VehicleSize object 参数说明:定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸,其中高度数值为可选项。 vehicle_class 否 VehicleClassification object 参数说明:定义车辆类型。包含车辆基本类型以及燃料动力类型。 表5 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明:定义纬度数值,北纬为正,南纬为负。单位°,精度小数点后7位。 最小值:-90 最大值:90.0000001 lon 是 Object 参数说明:定义经度数值。东经为正,西经为负。单位°,精度小数点后7位。 最小值:-179.9999999 最大值:180.0000001 ele 否 Object 参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。 最小值:-4096 最大值:61439 表6 PositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 参数说明:数值描述了95%置信水平的车辆位置精度。参考 位置精度参数说明。 最小值:0 最大值:15 ele_confidence 否 Integer 参数说明:数值描述了95%置信水平的车辆高程精度。参考 高程精度参数说明。 最小值:0 最大值:15 表7 MotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 参数说明:数值描述了95%置信水平的速度精度。 取值范围: 0:不可用 1:100m/s 2:10m/s 3:5m/s 4:1m/s 5:0.1m/s 6:0.05m/ 7:0.01m/s 最小值:0 最大值:7 heading_confidence 否 Integer 参数说明:数值描述了95%置信水平的航向精度。 取值范围: 0:不可用 1:10° 2:5° 3:1° 4:0.1° 5:0.05° 6:0.01° 7:0.0125° 最小值:0 最大值:7 steer_confidence 否 Integer 参数说明:数值描述了95%置信水平的车辆转向轮角度精度。 取值范围: 0:不可用 1:2° 2:1° 3:0.02° 最小值:0 最大值:3 表8 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明:车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 lat_accel 是 Integer 参数说明:车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 vert_accel 是 Integer 参数说明:定义Z轴方向的加速度大小,Z轴方向竖直向下,沿着Z轴方向为正。 分辨率为0.02G,G为重力加速度值9.80665m/s2。 最小值:-127 最大值:127 yaw_rate 是 Integer 参数说明:车辆横摆角速度。指汽车绕垂直轴的偏转,该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值,说明汽车发生测滑或者甩尾等危险工况。 顺时针旋转为正,逆时针为负。 数据分辨率为0.01°/s。 最小值:-127 最大值:127 表9 VehicleSize 参数 是否必选 参数类型 描述 width 是 Integer 参数说明:车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值:0 最大值:1023 length 是 Integer 参数说明:车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值:0 最大值:4095 height 否 Integer 参数说明:车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值:0 最大值:127 表10 VehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 否 Integer 参数说明:定义车辆基本类型。参考 车辆基本类型参数说明。 最小值:0 最大值:255 fuel_type 否 Integer 参数说明:定义车辆的燃料动力类型,10-15暂未定义。 取值范围: 0:未知 1:汽油 2:乙醇 3:柴油 4:电动 5:混合燃料类型 6:氢气 7:液化天然气 8:压缩天然气 9:丙烷 最小值:0 最大值:15 表11 OpenRSMTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。 event 是 String 参数说明:操作描述。" 取值范围: MODIFIED:修改 ADDED:新增 DELETED:删除 枚举值: MODIFIED ADDED DELETED
  • Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "bsm_source" : { "bsm_source_type" : "rsu", "bsm_source_id" : "RSU0123456789" }, "vehicle_id" : "01234567", "time_stamp" : "2021-11-24T11:41:15.964Z", "time_confidence" : 5, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "pos_accuracy" : { "semi_major" : 100, "semi_minor" : 100, "orientation" : 1000 }, "pos_confidence" : { "position_confidence" : 10, "ele_confidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "motion_confidence" : { "speed_confidence" : 5, "heading_confidence" : 5, "steer_confidence" : 2 }, "accel_set" : { "long_accel" : 0, "lat_accel" : 0, "vert_accel" : 0, "yaw_rate" : 0 }, "brakes" : { "brake_pedal_status" : 1, "wheel_brakes_status" : { "set_status" : false, "left_front" : false, "left_rear" : false, "right_front" : false, "right_rear" : false }, "traction_status" : 1, "abs_status" : 1, "scs_status" : 1, "brake_boost_status" : 1, "aux_brakes_status" : 1 }, "vehicle_class" : { "basic_vehicle_class" : 54, "fuel_type" : 5 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 } }}
  • Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XBSMTopicBodyDTO object 参数说明:车辆基本安全信息。 header 是 OpenBSMTopicHeaderDTO object 参数说明:车辆基本安全信息的附加描述。 表2 OpenV2XBSMTopicBodyDTO 参数 是否必选 参数类型 描述 bsm_source 否 BSMSource object 参数说明:消息来源。 vehicle_id 是 String 参数说明:车辆自己生成的临时ID,ID值会定期变化。 最小长度:8 最大长度:8 time_stamp 是 String 参数说明:采集数据的UTC时间。 格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 例如2021-12-18T07:20:51.683Z。 最大长度:32 time_confidence 否 Integer 参数说明:数值描述了95%置信水平的时间精度。参考 时间精度参数说明。 最小值:0 最大值:39 pos 是 Position3D object 参数说明:位置信息。 pos_accuracy 否 PositionalAccuracy object 参数说明:基于椭圆模型定义, 一个定位系统自身的精度。 pos_confidence 是 PositionalConfidence object 参数说明:定义当前实时位置(经纬度和高程)的精度大小,包括水平位置精度和高程精度, 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明:车辆档位状态。 取值范围: 0:空档 1:停止档 2:前进档 3:倒档 7:不可用 4-6:预留 最小值:0 最大值:7 speed 是 Integer 参数说明:车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值:0 最大值:8191 heading 是 Integer 参数说明:车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值:0 最大值:28800 angle 否 Integer 参数说明:定义车辆转向轮角度。向右为正,向左为负。单位为1.5°。值为127时代表无效值。 最小值:-126 最大值:127 motion_confidence 否 MotionConfidenceSet object 参数说明:描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 是 AccelerationSet4Way object 参数说明:定义车辆四轴加速度。 brakes 是 BrakeSystemStatus object 参数说明:定义车辆的刹车系统状态。包括7种不同类型的状态。 vehicle_class 否 VehicleClassification object 参数说明:定义车辆类型。包含车辆基本类型以及燃料动力类型。 size 是 VehicleSize object 参数说明:定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸,其中高度数值为可选项。 表3 BSMSource 参数 是否必选 参数类型 描述 bsm_source_type 是 String 参数说明:来源的具体类型。 枚举值: rsu obu detection bsm_source_id 否 String 参数说明:来源的唯一标识码ID。 最小长度:1 最大长度:255 表4 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明:定义纬度数值,北纬为正,南纬为负,单位为0.0000001°即1e-7°。 最小值:-900000000 最大值:900000001 lon 是 Object 参数说明:定义经度数值。东经为正,西经为负。单位为0.0000001°,即1e-7°。 最小值:-1799999999 最大值:1800000001 ele 否 Object 参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。 最小值:-4096 最大值:61439 表5 PositionalAccuracy 参数 是否必选 参数类型 描述 semi_major 是 Integer 参数说明:定义用椭圆模型表示的GNSS系统精度中半长轴的大小,单位为0.05米。 最小值:0 最大值:255 semi_minor 是 Integer 参数说明:定义用椭圆模型表示的GNSS系统精度中半短轴的大小,单位为0.05米。 最小值:0 最大值:255 orientation 是 Integer 参数说明:定义用椭圆模型表示的GNSS系统精度中正北方向顺时针到最近半长轴的夹角大小,单位为0.0054932479°。 最小值:0 最大值:65535 表6 PositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 参数说明:数值描述了95%置信水平的车辆位置精度。参考 位置精度参数说明。 最小值:0 最大值:15 ele_confidence 否 Integer 参数说明:数值描述了95%置信水平的车辆高程精度。参考 高程精度参数说明。 最小值:0 最大值:15 表7 MotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 参数说明:数值描述了95%置信水平的速度精度。 取值范围: 0:不可用 1:100m/s 2:10m/s 3:5m/s 4:1m/s 5:0.1m/s 6:0.05m/ 7:0.01m/s 最小值:0 最大值:7 heading_confidence 否 Integer 参数说明:数值描述了95%置信水平的航向精度。 取值范围: 0:不可用 1:10° 2:5° 3:1° 4:0.1° 5:0.05° 6:0.01° 7:0.0125° 最小值:0 最大值:7 steer_confidence 否 Integer 参数说明:数值描述了95%置信水平的车辆转向轮角度精度。 取值范围: 0:不可用 1:2° 2:1° 3:0.02° 最小值:0 最大值:3 表8 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明:车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 lat_accel 是 Integer 参数说明:车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 vert_accel 是 Integer 参数说明:定义Z轴方向的加速度大小,Z轴方向竖直向下,沿着Z轴方向为正。 分辨率为0.02G,G为重力加速度值9.80665m/s2。 最小值:-127 最大值:127 yaw_rate 是 Integer 参数说明:车辆横摆角速度。指汽车绕垂直轴的偏转,该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值,说明汽车发生测滑或者甩尾等危险工况。 顺时针旋转为正,逆时针为负。 数据分辨率为0.01°/s。 最小值:-127 最大值:127 表9 BrakeSystemStatus 参数 是否必选 参数类型 描述 brake_pedal_status 否 Integer 参数说明:指示刹车踏板状态,是否处在被踩下状态。 取值范围: 0:不可用 1:非踩下状态 2:踩下状态 最小值:0 最大值:2 wheel_brakes_status 否 WheelBrakesStatus object 参数说明:车辆车轮制动情况,定义四轮分别的刹车状态。 将车辆的轮胎分为左前、右前、左后、右后四组。当车辆进行刹车时,对应值分别指示了四组轮胎的刹车情况。 当车辆为单排轮胎(摩托车等)时,以左前和左后表示其前后轮。 当车辆某一组轮胎由多个组成时,其状态将等效到一个数值来表示。 traction_status 否 Integer 参数说明:牵引力控制系统实时状态。 取值范围: 0:系统未装备或不可用 1:系统处于关闭状态 2:系统处于开启状态,但未触发 3:系统被触发,处于作用状态 最小值:0 最大值:3 abs_status 否 Integer 参数说明:刹车防抱死系统(ABS)状态。 取值范围: 0:系统未装备或不可用 1:系统处于关闭状态 2:系统处于开启状态,但未触发 3:系统被触发,处于作用状态 最小值:0 最大值:3 scs_status 否 Integer 参数说明:车辆动态稳定控制系统状态。 取值范围: 0:系统未装备或不可用 1:系统处于关闭状态 2:系统处于开启状态,但未触发 3:系统被触发,处于作用状态 最小值:0 最大值:3 brake_boost_status 否 Integer 参数说明:刹车助力系统作用情况。通过刹车辅助系统的状态,指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车,从而接管刹车系统,在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器,来判断紧急刹车的需求。 取值范围: 0:系统未装备或不可用 1:系统处于关闭状态 2:系统处于开启状态 最小值:0 最大值:2 aux_brakes_status 否 Integer 参数说明:辅助制动系统(一般指手刹)情况。 取值范围: 0:系统未装备或不可用 1:系统处于关闭状态 2:代表系统处于开启状态 3:预留 最小值:0 最大值:3 表10 WheelBrakesStatus 参数 是否必选 参数类型 描述 set_status 否 Boolean 参数说明:车辆整体车轮制动是否可用。 缺省值:false left_front 否 Boolean 参数说明:左前轮刹车是否处于激活状态。 缺省值:false left_rear 否 Boolean 参数说明:左后轮刹车是否处于激活状态。 缺省值:false right_front 否 Boolean 参数说明:右前轮刹车是否处于激活状态。 缺省值:false right_rear 否 Boolean 参数说明:右后轮刹车是否处于激活状态。 缺省值:false 表11 VehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 否 Integer 参数说明:定义车辆基本类型。参考 车辆基本类型参数说明。 最小值:0 最大值:255 fuel_type 否 Integer 参数说明:定义车辆的燃料动力类型,10-15暂未定义。 取值范围: 0:未知 1:汽油 2:乙醇 3:柴油 4:电动 5:混合燃料类型 6:氢气 7:液化天然气 8:压缩天然气 9:丙烷 最小值:0 最大值:15 表12 VehicleSize 参数 是否必选 参数类型 描述 width 是 Integer 参数说明:车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值:0 最大值:1023 length 是 Integer 参数说明:车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值:0 最大值:4095 height 否 Integer 参数说明:车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值:0 最大值:127 表13 OpenBSMTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。 event 是 String 参数说明:操作描述。" 取值范围: MODIFIED:修改 ADDED:新增 DELETED:删除 枚举值: MODIFIED ADDED DELETED
  • 请求示例 POST https://{endpoint}/v1/{project_id}/spat/sendContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "rsu_id" : "834bdeb2-66cf-4c44-badf-74764a93eab1", "spat_content" : { "name" : "spat", "intersections" : [ { "intersection_id" : { "region" : 1, "id" : 15 }, "status" : 0, "phases" : [ { "phase_id" : 1, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] }, { "phase_id" : 2, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] } ] } ] }}
共100000条