更新时间：2024-01-18 GMT+08:00
批量获取设备位置信息（API名称：getDeviceLocation）
功能介绍
批量获取设备位置信息。
相关API
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/device/getDeviceLocation |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
isdpDeviceId |
String |
是 |
设备唯一Id集合 (设备Id + '-' + '-1') 示例 ： "isdpDeviceId": "11--1, 22--1, 33--1" |
|
coordType |
String |
否 |
坐标类型。 可填的类型：[“BD09”, “GCJ02”, “WGS84”]，若传空，默认作“WGS84”处理 |
|
startTime |
String |
是 |
开始时间。 日期格式：YYYY-MM-DD hh:mm:ss。 |
|
endTime |
String |
是 |
结束时间。 日期格式：YYYY-MM-DD hh:mm:ss。 |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
isdpDeviceId |
String |
isdp唯一设备ID |
|
reportTime |
Long |
设备上报时间 |
|
deviceState |
String |
接入状态 |
|
longitude |
String |
经度 |
|
latitude |
String |
纬度 |
|
address |
String |
地址 |
|
battery |
String |
设备电量 |
|
coordinateType l |
int |
坐标分类：百度，谷歌 |
请求示例
{
"isdpDeviceId" : "f2003--1,zhangyz008--1",
"coordType" : "",
"startTime" : "2022-06-01 12:00:02",
"endTime" : "2022-06-14 12:00:02"
}
响应示例
{
"status" : 1,
"message" : "SUCCESS",
"error" : null,
"data" : [{
"isdpDeviceId" : "zhangyz008--1",
"reportTime" : 1655105399000,
"deviceState" : "ONLINE",
"longitude" : "11***52",
"latitude" : "22***26",
"address" : "**市**区**街道",
"battery" : "14",
"coordinateType" : "WGS84"
}, {
"isdpDeviceId" : "f2003--1",
"reportTime" : 1655104701000,
"deviceState" : "OFFLINE",
"longitude" : "11***56",
"latitude" : "22***24",
"address" : "**市**区**街道",
"battery" : "39",
"coordinateType" : "WGS84"
}
],
"timestamp" : "2022-06-17T11:36:17.692+0800"
}
父主题： 设备状态查询
