更新时间:2023-12-29 GMT+08:00
分享

统计数据信息(statistics)

功能介绍

Edge上报统计数据消息到平台,平台经过处理后将该消息推送到对应的数据转发配置通道。

统计数据信息,包括车辆流量,平均速度等统计信息。

TOPIC

v2x-v1-edge-flow

如果新增数据转发配置时填写了topic_prefix参数,则推送的topic:{topic_prefix}v2x-v1-edge-flow。例如topic前缀为test,推送的topic:testv2x-v1-edge-flow。

Message参数

表1 请求Body参数

参数

是否必选

参数类型

描述

header

OpenV2XStatisticsHeader object

参数说明:统计数据信息的附加描述。

body

OpenV2XStatisticsBody object

参数说明:统计数据信息。

表2 OpenV2XStatisticsHeader

参数

是否必选

参数类型

描述

instance_id

String

参数说明:实例ID。dris物理实例的唯一标识。

event

String

参数说明:操作描述。"

取值范围

  • MODIFIED:修改

  • ADDED:新增

  • DELETED:删除

枚举值:

  • MODIFIED

  • ADDED

  • DELETED

表3 OpenV2XStatisticsBody

参数

是否必选

参数类型

描述

source

StatisticsSourceDTO object

参数说明:消息来源。

section_id

Integer

参数说明:截面id,SNE在一个感知范围内划分的不同统计截面或者路段id。从1开始编码。

最小值:1

最大值:128

time

String

参数说明:数据上报的时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z'。 例如:2021-01-08T02:03:41Z。

period

Integer

参数说明:统计周期,单位秒。

最小值:0

最大值:100000000

direction

Number

参数说明:道路路的角度,区分道路方向,向东为0度,逆时针增加。

最小值:0

最大值:360

flow

Integer

参数说明:统计周期内的车辆数。

最小值:0

最大值:100000000

average_speed

Number

参数说明:车辆平均速度,单位km/h。

最小值:0

最大值:1000

esn

String

参数说明:设备编码。 取值范围:长度不超过64,只允许字母、数字、以及_等字符的组合。

cross_id

String

参数说明:路口id,检测一个特定的路口或者路段。

最小长度:0

最大长度:64

segment

Segment object

参数说明:分段信息

traffic_direction

Integer

参数说明:路段的交通流方向,交通流方向按照“西北原则”进行定义,即尽量选择西北的点作为正向起点,先西后北。西北原则说明请参见“API参考 > 附录 > 西北原则”。。 0:正向 1:逆向 2:正向转逆向的连接线 3:逆向转正向的连接线 9:为方向未确定

最小值:0

最大值:10

road_kind

Integer

参数说明:道路特征

取值范围

0为主路

1为汇入匝道

2为汇出匝道

3为辅道

4为 分合流后主路

最小值:0

最大值:10

has_congestion

Boolean

参数说明:该crossId是否存在交通拥堵的情况

vehicle_class_flow

Array of ModelFlow objects

参数说明:不同车辆类型的流量统计。

数组长度:0 - 100

occupancy

Array of LaneOccupancy objects

参数说明:分车道统计的占有率列表。

数组长度:0 - 32

lane_count

Integer

参数说明:车道数。

最小值:0

最大值:32

lane_flow

Array of LaneFlow objects

参数说明:车道级流量统计。

数组长度:0 - 32

表4 StatisticsSourceDTO

参数

是否必选

参数类型

描述

source_type

String

参数说明:信息来源的具体类型描述。"

取值范围

  • rsu:RSU设备

  • obu:OBU设备

  • detection:V2XEdge检测算法

  • sne: sne上报的统计信息

枚举值:

  • rsu

  • obu

  • detection

  • sne

source_id

String

参数说明:信息来源的唯一标识码ID。

最小长度:1

最大长度:255

表5 Segment

参数

是否必选

参数类型

描述

segment_id

String

参数说明:分段id, 在对接无线时,该字段填充的是雷达序号。

最小长度:1

最大长度:4

lon

Number

参数说明:分段的经度。东经为正,西经为负,单位°,精度小数点后7位。在对接无线时,该字段填充的是雷达经度。

最小值:-180

最大值:180

lat

Number

参数说明:分段的纬度。北纬为正,南纬为负,单位°,精度小数点后7位。在对接无线时,该字段填充的是雷达纬度。

最小值:-90

最大值:90

表6 ModelFlow

参数

是否必选

参数类型

描述

vehicle_class

Integer

参数说明:车辆类型。参考“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。

最小值:0

最大值:2000

flow

Integer

参数说明:统计周期内的车辆数。

最小值:0

最大值:100000000

average_speed

Number

参数说明:车辆平均速度,单位km/h。

最小值:0

最大值:1000

表7 LaneOccupancy

参数

是否必选

参数类型

描述

lane_id

Integer

参数说明:车道编号。如果感知设备支持覆盖双向行驶方向时,桩号递增行驶方向,车道号从左到右从1依次递增;桩号递减行驶方向,车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道,可以不区分桩号递增或者递减行驶方向,车道号可以按照车辆行驶方向从左到右,从1开始递增。

最小值:-32

最大值:32

space_occupancy

Double

参数说明:车道的空间占有率。

最小值:0

最大值:1

time_occupancy

Double

参数说明:车道的时间占有率。

最小值:0

最大值:1

表8 LaneFlow

参数

是否必选

参数类型

描述

lane_id

Integer

参数说明:车道编号。如果感知设备支持覆盖双向行驶方向时,桩号递增行驶方向,车道号从左到右从1依次递增;桩号递减行驶方向,车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道,可以不区分桩号递增或者递减行驶方向,车道号可以按照车辆行驶方向从左到右,从1开始递增。

最小值:-32

最大值:32

flow

Integer

参数说明:统计周期内的车辆数。

最小值:0

最大值:100000000

average_speed

Number

参数说明:车辆平均速度,单位km/h。

最小值:0

最大值:1000

vehicle_density

Integer

参数说明:车流密度,单位:辆/小时。

最小值:0

最大值:100000000

head_interval

Integer

参数说明:车头时间距离,单位:秒。

最小值:0

最大值:100000000

space_interval

Integer

参数说明:车头空间距离,单位:厘米。

最小值:0

最大值:100000000

Message示例

{
  "header" : {
    "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7",
    "event" : "ADDED"
  },
  "body" : {
    "source" : {
      "source_type" : "detection",
      "source_id" : "705183159624675328_2102312ETX10K7000037"
    },
    "time" : "2020-09-01T01:37:01Z",
    "section_id" : 1,
    "period" : 300,
    "direction" : 180,
    "flow" : 75,
    "average_speed" : 72.5,
    "cross_id" : "cross0123456789",
    "segment" : {
      "segment_id" : "1",
      "lon" : 114.23256,
      "lat" : 30.121545
    },
    "esn" : "2102312ETX10K7000037",
    "traffic_direction" : "0,",
    "road_kind" : "1,",
    "has_congestion" : "false,",
    "vehicle_class_flow" : [ {
      "vehicle_class" : 10,
      "flow" : 50,
      "average_speed" : 73.6
    }, {
      "vehicle_class" : 20,
      "flow" : 25,
      "average_speed" : 71.4
    } ],
    "occupancy" : [ {
      "lane_id" : 0,
      "space_occupancy" : 0.6,
      "time_occupancy" : 0.5
    }, {
      "lane_id" : 1,
      "space_occupancy" : 0.6,
      "time_occupancy" : 0.5
    } ],
    "lane_count" : 4,
    "lane_flow" : [ {
      "lane_id" : 10,
      "flow" : 50,
      "average_speed" : 73.6,
      "vehicle_density" : 100,
      "head_interval" : 100,
      "space_interval" : 1000
    }, {
      "lane_id" : 20,
      "flow" : 25,
      "average_speed" : 71.4,
      "vehicle_density" : 100,
      "head_interval" : 100,
      "space_interval" : 1000
    } ]
  }
}

相关文档