文档首页/ 路网数字化服务 DRIS/ API参考/ API/ 应用侧API参考/ 雷达管理/ 查询雷达列表
更新时间：2024-10-24 GMT+08:00
查看PDF
分享

查询雷达列表

功能介绍

查询雷达列表

调试

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

URI

GET /v1/{project_id}/radars

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。

取值范围：仅支持数字，a到f的小写字母组合，长度32。
表2 Query参数

参数

是否必选

参数类型

描述

esn

否

String

参数说明：设备序列号。

取值范围：长度不小于1，不大于64，英文字母，数字和下划线（_）的组合。

offset

否

Integer

参数说明：分页查询时的页码。

limit

否

Integer

参数说明：分页查询时每页显示的记录数。

status

否

String

参数说明：状态。

取值范围：

  • ONLINE：在线

  • OFFLINE：离线

  • UNKNOWN：未知

  • SLEEP：睡眠

请求参数

表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

参数说明：总数

radars

Array of RadarResourceDTO objects

参数说明：数据列表
表5 RadarResourceDTO

参数

参数类型

描述

radar_id

String

参数说明：雷达ID

取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。

name

String

参数说明：名称

取值范围：长度不小于1，不大于128的汉字、英文字母、数字、下划线（_）和横杠（-）的组合。

v2x_edge_id

String

参数说明：所属的EdgeId

取值范围：长度不小于1，不大于128的英文字母、数字、下划线（_）和横杠（-）的组合。

ip

String

参数说明：设备IP

status

String

参数说明：状态值

取值范围：

  • ONLINE：在线

  • OFFLINE：离线

  • UNKNOWN：未知

  • SLEEP：睡眠

esn

String

参数说明：设备编号

取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。

position_description

String

参数说明：位置描述

取值范围：长度不小于1，不大于128的英文字母、数字和下划线（_）的组合。

sequence_no

Integer

参数说明：雷达序号，该字段是SNE感知设备信息上报的，只有SNE会上报该字段。

direction

Integer

参数说明：道路检测方向，0表示朝向起点，1表示朝向终点,255表示无效值。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。

lon

Number

参数说明：雷达设备的经度，东经为正，西经为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。

lat

Number

参数说明：雷达设备的纬度，北纬为正，南纬为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。

sensor_angle

Number

参数说明：感知设备部署的角度，以正北为0，顺时针旋转（无线的部署方式）。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。

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

last_online_time

String

参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

请求示例

GET https://{endpoint}/v1/{project_id}/radars?limit={limit}&offset={offset}&esn={esn}&status={status}
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********

响应示例

状态码： 200

ok

{
  "count" : 1,
  "radars" : [ {
    "radar_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3",
    "name" : "radar00001",
    "v2x_edge_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3",
    "ip" : "127.0.0.1",
    "status" : "ONLINE",
    "esn" : "abcd00001",
    "position_description" : "k01",
    "sequence_no" : 1,
    "direction" : 0,
    "lon" : 114.0398513,
    "lat" : 30.5087712,
    "sensor_angle" : 124.711914,
    "created_time" : "2020-09-01T01:37:01Z",
    "last_modified_time" : "2020-09-01T01:37:01Z",
    "last_online_time" : "2020-09-01T01:37:01Z"
  } ]
}

状态码

状态码

描述

200

ok

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 雷达管理

相关文档