文档首页/ 路网数字化服务 DRIS/ API参考/ API/ 应用侧API参考/ 数据转发/ 轨迹数据信息(tracks)
更新时间：2024-10-24 GMT+08:00
查看PDF
分享

轨迹数据信息(tracks)

功能介绍

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

轨迹数据信息，Edge识别的某一时间段内的路侧车辆数据，包括车牌、车速、位置等信息。

TOPIC

v2x-v1-tracks

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

Message参数

表1 请求Body参数

参数

是否必选

参数类型

描述

header

是

OpenV2XTracksHeader object

参数说明：轨迹数据信息的附加描述。

body

是

OpenV2XTracksBody object

参数说明：轨迹数据信息。
表2 OpenV2XTracksHeader

参数

是否必选

参数类型

描述

instance_id

是

String

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

event

是

String

参数说明：操作描述。"

取值范围：

  • MODIFIED：修改

  • ADDED：新增

  • DELETED：删除

枚举值：

  • MODIFIED

  • ADDED

  • DELETED
表3 OpenV2XTracksBody

参数

是否必选

参数类型

描述

source

否

TracksSource object

参数说明：消息来源。

time

否

String

参数说明：数据上报的时间。

格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

例如 2021-01-08T02:03:41.907Z。

cross_id

否

String

参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。

最小长度：0

最大长度：64

track_list

否

Array of TrackList objects

参数说明：轨迹列表。

数组长度：0 - 100
表4 TracksSource

参数

是否必选

参数类型

描述

source_type

否

String

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

枚举值：

  • rsu

  • obu

  • detection

  • sne

source_id

否

String

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

最小长度：1

最大长度：255

esn

否

String

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

参数

是否必选

参数类型

描述

track_id

否

Long

参数说明：轨迹id。

最小值：0

最大值：9223372036854775807

ptc_type

否

String

参数说明：路侧单元检测到的交通参与者类型。

取值范围：

  • unknown：未知类型

  • motor：机动车

  • non-motor：非机动车

  • pedestrian：行人

  • rsu：RSU设备

ptc_id

否

Integer

参数说明：检测单元设置的临时ID。

最小值：0

最大值：65535

source

否

String

参数说明：定义交通参与者数据的来源。

取值范围：

  • unknown：未知数据源类型

  • rsu：RSU自身信息

  • v2x：参与者自身的v2x广播消息

  • video：视频传感器

  • microwaveRadar：微波雷达传感器

  • loop：地磁线圈传感器

  • lidar：激光雷达传感器

  • integrated：一类或以上感知数据的融合结果

global_track_id

否

Long

参数说明：ITS800通过GlobalTrackID字段标识了车辆唯一ID。

最小值：0

最大值：9223372036854775807

vehicle_class

否

Integer

参数说明：车辆类型。参考车辆基本类型。

最小值：0

最大值：1000

gat_vehicle_class

否

String

参数说明：机动车车辆类型。参考机动车车辆类型。

vehicle_color

否

String

参数说明：车辆颜色。

取值范围：

  • black：黑色

  • white：白色

  • gray：灰色

  • red：红色

  • blue：蓝色

  • yellow：黄色

  • orange：橙色

  • brown：棕色

  • green：绿色

  • purple：紫色

  • cyan：青色

  • pink：粉红色

  • transparent：透明色

  • other：其他

vehicle_model

否

String

参数说明：车辆型号。

最小长度：0

最大长度：63

vehicle_brand

否

String

参数说明：车辆品牌。

最小长度：0

最大长度：31

vehicle_style

否

String

参数说明：车辆年款，通过年份来表示，多个年份通过逗号分隔。

最小长度：0

最大长度：63

plat_no

否

String

参数说明：车牌。

最小长度：0

最大长度：63

heading

否

Number

参数说明：车的航向角，正北为0度，顺时针增加。单位°

最小值：0

最大值：360

speed

否

Number

参数说明：速度，单位km/h。

最小值：0

最大值：1000

car_direction

否

Integer

参数说明：车辆方向。

取值范围：

  • -1：未知方向

  • 0：车头

  • 1：车尾

最小值：-1

最大值：1

fuel_type

否

Integer

参数说明：定义车辆的燃料动力类型，10-15暂未定义。

取值范围：

  • 0：未知

  • 1：汽油

  • 2：乙醇

  • 3：柴油

  • 4：电动

  • 5：混合燃料类型

  • 6：氢气

  • 7：液化天然气

  • 8：压缩天然气

  • 9：丙烷

最小值：0

最大值：15

size

否

SizeDTO object

参数说明：车辆尺寸。

camera_list

否

Array of TrackCameraInfo objects

拍摄到事件的摄像头信息。

数组长度：0 - 10

location_list

否

Array of LocationList objects

参数说明：位置列表。

数组长度：0 - 100
表6 SizeDTO

参数

是否必选

参数类型

描述

width

否

Integer

参数说明：车辆宽度，单位厘米。

最小值：0

最大值：300

length

否

Integer

参数说明：车辆长度，单位厘米。

最小值：0

最大值：3000

height

否

Integer

参数说明：车辆高度，单位厘米。

最小值：0

最大值：500
表7 TrackCameraInfo

参数

是否必选

参数类型

描述

id

否

Integer

参数说明：SNE的摄像头id,编号从0开始。

最小值：0

最大值：128

ip

否

String

参数说明：摄像头ip。

最小长度：0

最大长度：15
表8 LocationList

参数

是否必选

参数类型

描述

lon

否

Number

参数说明：经度。东经为正，西经为负，单位°，精度小数点后7位。

最小值：-180

最大值：180

lat

否

Number

参数说明：纬度。北纬为正，南纬为负，单位°，精度小数点后7位。

最小值：-90

最大值：90

speed

否

Number

参数说明：速度，单位km/h。

最小值：0

最大值：1000

accel_set

否

AccelerationSet4Way object

参数说明：定义车辆四轴加速度。

heading

否

Number

参数说明：车的航向角，正北为0度，顺时针增加。单位°

最小值：0

最大值：360

angle

否

Integer

参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°，值为127时代表无效值。

最小值：-126

最大值：127

car_direction

否

Integer

参数说明：车辆方向。

取值范围：

  • -1：未知方向

  • 0：车头

  • 1：车尾

最小值：-1

最大值：1

lane_no

否

Integer

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

最小值：-32

最大值：32

time_stamp

否

Long

参数说明：采集车辆数据的毫秒时间戳。
表9 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

Message示例

{
  "header" : {
    "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7",
    "event" : "ADDED"
  },
  "body" : {
    "source" : {
      "source_type" : "detection",
      "source_id" : "EDGE0123456789",
      "esn" : "2102312ETX10K7000037"
    },
    "time" : "2020-09-01T01:37:01.123Z",
    "cross_id" : "cross0123456789",
    "track_list" : [ {
      "track_id" : 50,
      "ptc_type" : "motor",
      "ptc_id" : 3,
      "source" : "rsu",
      "global_track_id" : 3,
      "vehicle_class" : 10,
      "vehicle_color" : "black",
      "vehicle_model" : "朗逸",
      "vehicle_brand" : "红旗",
      "vehicle_style" : "2018,2019,2020",
      "gat_vehicle_class" : "K33",
      "plat_no" : "浙A12345",
      "heading" : 158.23,
      "speed" : 10.2,
      "car_direction" : 1,
      "fuel_type" : 5,
      "camera_list" : [ {
        "id" : 0,
        "ip" : "127.0.0.1"
      } ],
      "size" : {
        "width" : 200,
        "length" : 400,
        "height" : 200
      },
      "location_list" : [ {
        "lon" : 123.123,
        "lat" : 11.123,
        "speed" : 10.2,
        "accel_set" : {
          "long_accel" : 3,
          "lat_accel" : 4,
          "vert_accel" : 0,
          "yaw_rate" : 0
        },
        "heading" : 158.23,
        "angle" : 0,
        "car_direction" : 1,
        "time_stamp" : 1626243657123
      } ]
    } ]
  }
}
父主题： 数据转发

相关文档