# 获取设备轨迹信息（API名称：getTrailList）
#### 功能介绍
用于获取设备轨迹信息。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                          | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/helmet/getTrailList | 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的值 |
   
#### 请求参数
| **参数**       | **类型**  | **是否必填** | **描述**           |
|:---|:---|:---|:---|
| page         | Object  | 否        | 分页参数             |
| start        | Integer | 否        | 当前页码，分页参数，page子项 |
| count        | Integer | 否        | 每页条数，分页参数，page子项 |
| isdpDeviceId | String  | 否        | 设备唯一编码           |
| startTime    | String  | 是        | 开始时间             |
| endTime      | String  | 是        | 结束时间             |
| coordType    | String  | 否        | 坐标分类             |
   
#### 响应参数
| **字段名**        | **数据类型** | **描述** |
|:---|:---|:---|
| id             | Long     | 主键Id   |
| tenantId       | Long     | 租户Id   |
| isdpDeviceId   | String   | 设备唯一ID |
| startTime      | Date     | 开始时间   |
| startLongitude | String   | 开始经度   |
| startLatitude  | String   | 结束纬度   |
| startAddress   | String   | 开始地址   |
| endTime        | Date     | 结束时间   |
| endLongitude   | String   | 结束经度   |
| endLatitude    | String   | 结束纬度   |
| endAddress     | String   | 结束地址   |
| status         | String   | 状态     |
| coordType      | String   | 坐标类型   |
   
#### 请求示例
```
{
    "isdpDeviceId": "FBA_YS001--1",
    "startTime": "2022-05-22 10:30:06",
    "endTime": "2022-05-27 10:30:06",
    "page": {
        "pageSize": 10,
        "pageNo": 1
    },
    "coordType": "BD09"
}
```
#### 响应示例
```
{
    "data": {
        "list": [
            {
                "COORDTYPE": "BD09",
                "ENDADDRESS": "广东省东莞市xxxxxxxx",
                "ENDLATITUDE": "22.890076631807478",
                "ENDLONGITUDE": "113.89738100046407",
                "ENDTIME": 1653550756000,
                "ID": 142972,
                "ISDPDEVICEID": "FBA_YS001--1",
                "STARTADDRESS": "广东省东莞市xxxxxxxx",
                "STARTLATITUDE": "22.890059838666158",
                "STARTLONGITUDE": "113.89739267786578",
                "STARTTIME": 1653550697000,
                "STATUS": "FINISH",
                "TENANTID": 886
            }
        ],
        "pageNo": 1,
        "pageSize": 15,
        "totalCount": 1
    },
    "error": null,
    "message": "SUCCESS",
    "status": 1,
    "timestamp": "2024-01-18T13:56:30.767+0800"
}
```