文档首页/ ISDP/ API参考/ API接口/ 智能安监/ 设备状态查询/ 批量获取设备位置信息（API名称：getDeviceLocation）
更新时间：2024-01-18 GMT+08:00
查看PDF
分享

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

功能介绍

批量获取设备位置信息。

相关API

接口名称

调用说明

获取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"
}
父主题： 设备状态查询

相关文档