# 批量获取设备位置信息（API名称：getDeviceLocation）
#### 功能介绍
批量获取设备位置信息。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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"
}
```