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

查询IPC列表

功能介绍

获取多个IPC资源

调试

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

URI

GET /v1/{project_id}/cameras

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

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

参数

是否必选

参数类型

描述

offset

否

Integer

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

limit

否

Integer

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

status

否

String

参数说明：摄像机的状态。

取值范围：

  • ONLINE：在线

  • OFFLINE：离线

  • INITIAL：初始化

  • UNKNOWN：未知

  • SLEEP：休眠

v2x_edge_id

否

String

参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。

取值范围：长度36，只允许小写字母、数字、连接符（-）的组合。

esn

否

String

参数说明：IPC的设备编码。

请求参数

表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

参数说明：总数

ipcs

Array of IpcResponseDTO objects

参数说明：IPC列表
表5 IpcResponseDTO

参数

参数类型

描述

camera_id

String

参数说明：摄像头ID，console界面查询摄像头IPC列表中的设备Id。

v2x_edge_id

String

参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。

name

String

参数说明：摄像头名称。

cross_id

String

参数说明：摄像头所感知的路口或者路段的Id。

focal_type

String

参数说明：摄像头聚焦类型。

  • long：长焦

  • short：短焦

parent_connect_code

String

参数说明：摄像头连接的ITS800的互联编码。

connect_code

String

参数说明：摄像头的互联编码。

description

String

参数说明：描述。

esn

String

参数说明：IPC的设备编码。

ip

String

参数说明：该摄像头的ip地址。

status

String

参数说明：摄像机的状态。

取值范围：

  • ONLINE：在线

  • OFFLINE：离线

  • INITIAL：初始化

  • UNKNOWN：未知

  • SLEEP：休眠

brief_type

Integer

参数说明：摄像头类型。

  • 100：短焦(<=20mm)

  • 101：中焦(>20mm&<=50mm)

  • 102：长焦(>50mm)

  • 103：鱼眼

  • 104：球机

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}/cameras?limit={limit}&status={status}&v2x_edge_id={v2x_edge_id}&offset={offset}
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********

响应示例

状态码： 200

OK

{
  "count" : 1,
  "ipcs" : [ {
    "camera_id" : "8f6a6e23-f245-412a-92b7-4c4944284418",
    "v2x_edge_id" : "99678cc3-1665-4cc0-be01-b69346094542",
    "name" : "camera2",
    "cross_id" : "code",
    "focal_type" : "long",
    "parent_connect_code" : "connectcode",
    "connect_code" : "code",
    "description" : "test",
    "esn" : "124546416113",
    "ip" : "127.0.0.1",
    "status" : "ONLINE",
    "brief_type" : 101,
    "sequence_no" : 1,
    "direction" : 0,
    "lon" : 114.0398513,
    "lat" : 30.5087712,
    "sensor_angle" : 124.711914,
    "created_time" : "2021-12-23T12:59:43.935Z",
    "last_modified_time" : "2021-12-23T12:59:43.935Z",
    "last_online_time" : "2021-12-23T12:59:43.935Z"
  } ]
}

状态码

状态码

描述

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

错误码

请参见错误码。

父主题： IPC管理

相关文档