查询雷达列表
功能介绍
查询雷达列表
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/radars
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
esn |
否 |
String |
参数说明：设备序列号。 取值范围：长度不小于1，不大于64，英文字母，数字和下划线（_）的组合。 |
offset |
否 |
Integer |
参数说明：分页查询时的页码。 最小值：0 最大值：1000 缺省值：0 |
limit |
否 |
Integer |
参数说明：分页查询时每页显示的记录数。 最小值：0 最大值：100 缺省值：10 |
status |
否 |
String |
参数说明：状态。 取值范围：
|
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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认证”。 最小长度：1 最大长度：20000 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
count |
Long |
参数说明：总数 最小值：0 最大值：1000 |
radars |
Array of RadarResourceDTO objects |
参数说明：数据列表 数组长度：0 - 1000 |
参数 |
参数类型 |
描述 |
|---|---|---|
radar_id |
String |
参数说明：雷达ID 取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。 最小长度：1 最大长度：64 |
name |
String |
参数说明：名称 取值范围：长度不小于1，不大于128的汉字、英文字母、数字、下划线（_）和横杠（-）的组合。 |
v2x_edge_id |
String |
参数说明：所属的EdgeId 取值范围：长度不小于1，不大于128的英文字母、数字、下划线（_）和横杠（-）的组合。 |
ip |
String |
参数说明：设备IP |
status |
String |
参数说明：状态值 取值范围：
|
esn |
String |
参数说明：设备编号 取值范围：长度不小于1，不大于64的英文字母、数字和下划线（_）的组合。 |
position_description |
String |
参数说明：位置描述 取值范围：长度不小于1，不大于128的英文字母、数字和下划线（_）的组合。 |
sequence_no |
Integer |
参数说明：雷达序号，该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：0 最大值：128 |
direction |
Integer |
参数说明：道路检测方向，0表示朝向起点，1表示朝向终点,255表示无效值。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：0 最大值：255 |
lon |
Number |
参数说明：雷达设备的经度，东经为正，西经为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-180 最大值：180 |
lat |
Number |
参数说明：雷达设备的纬度，北纬为正，南纬为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-90 最大值：90 |
sensor_angle |
Number |
参数说明：感知设备部署的角度，以正北为0，顺时针旋转（无线的部署方式）。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-180 最大值：180 |
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 |
错误码
请参见错误码。
