批量获取设备位置信息（API名称：getDeviceLocation）

功能介绍

批量获取设备位置信息。

接口名称	调用说明
获取Token	调用该接口获取到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"
}

父主题：设备状态查询

上一篇：设备状态查询

下一篇：设备告警信息查询