文档首页/ 路网数字化服务 DRIS/ API参考/ API/ 应用侧API参考/ 历史交通消息管理/ 查询历史交通统计信息列表

更新时间：2024-10-24 GMT+08:00

查看PDF

查询历史交通统计信息列表

功能介绍

查询历史交通统计信息列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/edge-flow

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。取值范围：仅支持数字，a到f的小写字母组合，长度32。

表2 Query参数
参数	是否必选	参数类型	描述
offset	否	Integer	参数说明：分页查询时的页码。
limit	否	Integer	参数说明：分页查询时每页显示的记录数。
from_date	否	String	参数说明：查询此时间后达到平台的消息。格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。例如 2020-09-01T01:37:01.000Z。取值范围：携带edge_id参数查询时，from_date和to_date的时间范围不能超过24小时；未携带edge_id参数查询时，from_date和to_date的时间范围不能超过1小时。
to_date	否	String	参数说明：查询此时间前达到平台的消息。格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。例如 2020-09-02T01:37:01.000Z。取值范围：携带edge_id参数查询时，from_date和to_date的时间范围不能超过24小时；未携带edge_id参数查询时，from_date和to_date的时间范围不能超过1小时。
edge_id	否	String	参数说明：Edge ID，用于唯一标识一个Edge。取值范围：数字，a至f的小写字母，横杠（-），长度为36的组合。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
Instance-Id	否	String	参数说明：实例ID。DRIS物理实例的唯一标识，获取方法请参见“API参考 > 附录 > 获取Instance-Id”。取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。
X-Auth-Token	否	String	参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 “获取IAM用户Token”接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见“API参考 > API > 应用侧API参考 > 如何调用API > 认证鉴权 > Token认证”。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
count	Long	参数说明：条件查询返回的总条数。
statistics	Array of OpenV2XStatisticsBody objects	参数说明：车辆流量，平均速度等统计信息列表

表5 OpenV2XStatisticsBody
参数	参数类型	描述
source	StatisticsSourceDTO object	参数说明：消息来源。
section_id	Integer	参数说明：分段id，无线SNE上报的流量使用该字段。当检测设备覆盖范围较大时，可以通过划分section实现精细化检测，此时每一个section需要携带对应的section_id，从1开始编码。
time	String	参数说明：数据上报的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z'。例如：2021-01-08T02:03:41Z。
period	Integer	参数说明：统计周期，单位秒。
direction	Number	参数说明：道路的角度，区分道路方向，向东为0度，逆时针增加。
flow	Integer	参数说明：统计周期内的车辆数。
average_speed	Number	参数说明：车辆平均速度，单位km/h。
esn	String	参数说明：设备编码。取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。
cross_id	String	参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。
segment	Segment object	参数说明：长路段场景下，分段信息。
traffic_direction	Integer	参数说明：路段的交通流方向，0为正向，1为逆向。交通流方向按照“西北原则”进行定义。西北原则说明请参见“API参考 > 附录 > 西北原则”。 0：正向 1：逆向 2：正向转逆向的连接线 3：逆向转正向的连接线 9：为方向未确定
road_kind	Integer	参数说明：道路特征，0为主路，1为汇入匝道，2为汇出匝道，3为辅道
has_congestion	Boolean	参数说明：该crossId是否存在交通拥堵的情况
vehicle_class_flow	Array of ModelFlow objects	参数说明：不同车辆类型的流量统计。
occupancy	Array of LaneOccupancy objects	参数说明：分车道统计的占有率列表。
lane_count	Integer	参数说明：车道数。
lane_flow	Array of LaneFlow objects	参数说明：车道级流量统计。

表6 StatisticsSourceDTO
参数	参数类型	描述
source_type	String	参数说明：信息来源的具体类型描述。取值范围： rsu：RSU obu：OBU detection：Edge sne: 无线SNE
source_id	String	参数说明：上报数据的设备或系统的原始id。

表7 Segment
参数	参数类型	描述
segment_id	String	参数说明：分段id，对应的是在检测道路上画的区段编号。segment_id要配合traffic_direction、road_kind字段一起使用。
lon	Number	参数说明：分段的经度。东经为正，西经为负，单位°，精度小数点后7位。在对接无线时，该字段填充的是雷达经度。
lat	Number	参数说明：分段的纬度。北纬为正，南纬为负，单位°，精度小数点后7位。在对接无线时，该字段填充的是雷达纬度。

表8 LaneOccupancy
参数	参数类型	描述
lane_id	Integer	参数说明：车道编号。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。
space_occupancy	Double	参数说明：车道的空间占有率。
time_occupancy	Double	参数说明：车道的时间占有率。

表9 LaneFlow
参数	参数类型	描述
lane_id	Integer	参数说明：车道编号。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。
flow	Integer	参数说明：统计周期内的车辆数。
average_speed	Number	参数说明：车辆平均速度，单位km/h。
vehicle_density	Integer	参数说明：车流密度，单位：辆/小时。
head_interval	Integer	参数说明：车头时间距离，单位：秒。
space_interval	Integer	参数说明：车头空间距离，单位：厘米。
vehicle_class_flow	Array of ModelFlow objects	参数说明：不同车辆类型的流量统计。

**表10** ModelFlow
参数	参数类型	描述
vehicle_class	Integer	参数说明：车辆类型。参考“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。
flow	Integer	参数说明：统计周期内的车辆数。
average_speed	Number	参数说明：车辆平均速度，单位km/h。

请求示例

GET https://{endpoint}/v1/{project_id}/edge-flow?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&edge_id={edge_id}
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********

响应示例

状态码： 200

{
  "count" : 1,
  "statistics" : [ {
    "source" : {
      "source_type" : "detection",
      "source_id" : "EDGE0123456789"
    },
    "section_id" : 1,
    "time" : "2022-09-01T13:10:21Z",
    "period" : 300,
    "direction" : 180.5,
    "flow" : 50,
    "average_speed" : 70.8,
    "esn" : "2102312ETX10K7000037",
    "cross_id" : "cross0123456789",
    "segment" : {
      "segment_id" : "1",
      "lon" : 114.23256,
      "lat" : 30.121545
    },
    "traffic_direction" : 0,
    "road_kind" : 10,
    "lane_count" : 4,
    "vehicle_class_flow" : [ {
      "vehicle_class" : 10,
      "flow" : 50,
      "average_speed" : 70.8
    } ],
    "lane_flow" : [ {
      "lane_id" : 10,
      "flow" : 50,
      "average_speed" : 73.6,
      "vehicle_density" : 100,
      "head_interval" : 100,
      "space_interval" : 1000,
      "vehicle_class_flow" : [ {
        "vehicle_class" : 10,
        "flow" : 50,
        "average_speed" : 70.8
      } ]
    } ],
    "occupancy" : [ {
      "lane_id" : 1,
      "space_occupancy" : 1,
      "time_occupancy" : 1
    } ]
  } ]
}

状态码

状态码	描述
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

错误码

请参见错误码。

父主题： 历史交通消息管理

上一篇：查询历史交通事件列表

下一篇：设备侧MQTT接口参考

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询历史交通统计信息列表

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？