获取设备定位历史数据-数据-有人云

#### 简要描述
	获取设备定位历史数据

<h4>请求 URL</h4><div style="background:rgba(22, 184, 248, 0.1);padding:10px;"><a href="http://cloud.usr.cn/document/531.html">{url}</a>/history/position,url获取见http://cloud.usr.cn/document/531.html</div>

#### 请求方式
	POST

#### 用户等级
:fa-check-square-o: 基础版 :fa-check-square-o: 企业版 :fa-check-square-o: 旗舰版
#### 调用限制

- 调用此接口每分钟不能超过30次
- [本接口严禁周期频繁调用]()
- 单次查询变量数量不得超过10个
- 单次查询单个变量的历史记录不得超过5000条
- 若要获取变量最新数据，请使用[获取历史记录最新数据](http://cloud.usr.cn/document/472.html)
- 如果需要获取实时数据，或想通过数据开发自己个性化业务系统，推荐使用[数据推送](http://cloud.usr.cn/document/481.html "数据推送")或[私有部署](http://cloud.usr.cn/document/7.html "私有部署")

#### 调用限制

- 针对设备，接口每小时的调用次数不能超过 60 次；

#### 请求参数

| 名称  | 必选/可选  | 类型  | 位置 | 说明  |
| ------------ | ------------ | ------------ |
| X-Access-Token | 必选  | String  | Header |  登录成功时返回的登录凭证(注意:X-Access-Token 有效时间为2小时，两小时内可以重复使用，[获取详情](http://cloud.usr.cn/document/362.html "获取详情")） |
| Content-Type | 必选  | String  | Header | 消息体的媒体类型，必须为"application/json"  |
| deviceNos | 必选 | JSONArray  |  Body |设备编号集合  |
| start  | 必选| Long  | Body | 开始时间戳（单位：毫秒）  |
| end  | 必选| Long  |  Body |结束时间戳（单位：毫秒）  |
| timeSort  | 必选| String  | Body | 排序规则 asc（升序）desc (降序)  |

#### 响应参数
| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| data  | JSONObject  | 响应数据  |
| info  | String  | 提示消息  |
| status  | Integer  | 返回码  |
| account  | String  | 操作用户  |

**响应数据（data）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| list  | JSONArray  | 数据列表  |

**响应数据（list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| deviceNo  | String  | 设备编号   |
| total  |  Integer |  总条数 |
| list  | JSONArray  | 数据列表(数组)  |

**响应数据（	数据列表list）**

| 名称  | 类型  | 说明  |
| ------------ | ------------ | ------------ |
| lngGcj  | Object  | 经度 - 火星   |
| lngBd  | Object  |  经度 - 百度 |
| lngWgs  | Object  | 经度 - 原始  |
| latGcj  | Object  | 纬度 - 火星  |
| raw  | JSONArray  | 原始数据  |
| locationType  | String  | 定位类型(LBS,GPS)  |
| time  | Long  | 时间戳(毫秒)  |
| latWgs  | Object  | 	纬度 - 原始  |
| latBd  | Object  | 纬度 - 百度  |

#### 返回码说明
| 返回码  | 说明  |
| ------------ | ------------ |
| 0  | 成功  |
| 30004  | 没有权限  |

#### 请求示例
<pre>
POST https://openapi.mp.usr.cn/usrCloud/vn/ucloudSdk/getPositionHistory
Content-Type: application/json
	
{
    "deviceNos":["00000000000000000002"],
    "start":1600850000000,
    "end":1600850000000,
    "timeSort":"asc"
}
	</pre>
	
#### 响应示例

status : 0，info: ok
<pre>
Content-Type: application/json
	
{
    "status": 0,
    "data": {
        "list": [
            {
                "deviceNo": "00000000000000000002",
                "total": 1,
                "list": [
                    {
                        "lngGcj": 116.88829474435883,
                        "lngBd": 116.89467616910662,
                        "lngWgs": 116.88275219745142,
                        "latGcj": 36.56885592401393,
                        "raw": "{\"p\":{\"lat\":36.56882967071845,\"lng\":116.88275219745142}}",
                        "locationType": "G",
                        "time": 1600850000000,
                        "latWgs": 36.56882967071845,
                        "latBd": 36.57516807200072
                    }
                ]
            }
        ],
        "total": 1
    },
    "info": "ok",
    "account": "test"
}
	</pre>