POST api/Location/History
Get history location data for a device in a time range
Request Information
Body Parameters
HistoryModel| Name | Description | Type | Additional information |
|---|---|---|---|
| DeviceId |
设备id |
integer |
None. |
| StartTime |
开始时间(时间为 UTC0 时间) 格式：yyyy-MM-dd HH:mm:ss |
date |
None. |
| EndTime |
结束时间(时间为 UTC0 时间) 格式：yyyy-MM-dd HH:mm:ss |
date |
None. |
| ShowLbs |
1:显示lbs 2:显示wifi |
integer |
None. |
| MapType |
地图类型 baidu 百度坐标系 google 谷歌坐标系（包括高德） |
string |
None. |
| SelectCount |
返回记录的最大数量 |
integer |
None. |
| PositionType |
定位类型 0: GPS,1: LBS,2: Wifi,3: GPS+LBS,4: GPS+Wifi,5: LBS+Wifi,6: GPS+LBS+Wifi |
integer |
None. |
| Token |
登录后获取到的 Token |
string |
None. |
| Language |
语言选项 |
string |
None. |
| AppId |
APP应用标识 |
string |
None. |
Request Formats
application/json, text/json
Sample:
{
"DeviceId": 1,
"StartTime": "2025-12-12T05:28:05.4625459+08:00",
"EndTime": "2025-12-12T05:28:05.4625459+08:00",
"ShowLbs": 4,
"MapType": "sample string 5",
"SelectCount": 6,
"PositionType": 7,
"Token": "sample string 8",
"Language": "sample string 9",
"AppId": "sample string 10"
}
application/xml, text/xml
Sample:
<HistoryModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ParModel"> <AppId>sample string 10</AppId> <Language>sample string 9</Language> <Token>sample string 8</Token> <DeviceId>1</DeviceId> <EndTime>2025-12-12T05:28:05.4625459+08:00</EndTime> <MapType>sample string 5</MapType> <PositionType>7</PositionType> <SelectCount>6</SelectCount> <ShowLbs>4</ShowLbs> <StartTime>2025-12-12T05:28:05.4625459+08:00</StartTime> </HistoryModel>
Response Information
Resource Description
State 状态码
0. 表示成功
| Name | Description | Type | Additional information |
|---|---|---|---|
| State |
状态 |
integer |
None. |
| LastLocationId |
最后id |
integer |
None. |
| LastDeviceUtcDate |
最后时间 |
string |
None. |
| Items |
数据 |
Collection of HistoryInfo |
None. |
| ItemsCount |
去除停留点之前的数量 |
integer |
None. |
Response Formats
application/json, text/json
Sample:
{
"State": 1,
"LastLocationId": 2,
"LastDeviceUtcDate": "sample string 3",
"Items": [
{
"LocationId": 1,
"Time": "sample string 2",
"Lat": 3.0,
"Lng": 4.0,
"Speed": 5.0,
"Course": 6.0,
"IsStop": 7,
"StopTime": 8,
"Icon": "sample string 9",
"DataType": 10,
"StopTimeStr": "sample string 11",
"EndTime": "sample string 12",
"Battery": 13
},
{
"LocationId": 1,
"Time": "sample string 2",
"Lat": 3.0,
"Lng": 4.0,
"Speed": 5.0,
"Course": 6.0,
"IsStop": 7,
"StopTime": 8,
"Icon": "sample string 9",
"DataType": 10,
"StopTimeStr": "sample string 11",
"EndTime": "sample string 12",
"Battery": 13
}
],
"ItemsCount": 4
}
application/xml, text/xml
Sample:
<HistoryResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ResModel">
<Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ViewModel">
<d2p1:HistoryInfo>
<d2p1:Battery>13</d2p1:Battery>
<d2p1:Course>6</d2p1:Course>
<d2p1:DataType>10</d2p1:DataType>
<d2p1:EndTime>sample string 12</d2p1:EndTime>
<d2p1:Icon>sample string 9</d2p1:Icon>
<d2p1:IsStop>7</d2p1:IsStop>
<d2p1:Lat>3</d2p1:Lat>
<d2p1:Lng>4</d2p1:Lng>
<d2p1:LocationId>1</d2p1:LocationId>
<d2p1:Speed>5</d2p1:Speed>
<d2p1:StopTime>8</d2p1:StopTime>
<d2p1:StopTimeStr>sample string 11</d2p1:StopTimeStr>
<d2p1:Time>sample string 2</d2p1:Time>
</d2p1:HistoryInfo>
<d2p1:HistoryInfo>
<d2p1:Battery>13</d2p1:Battery>
<d2p1:Course>6</d2p1:Course>
<d2p1:DataType>10</d2p1:DataType>
<d2p1:EndTime>sample string 12</d2p1:EndTime>
<d2p1:Icon>sample string 9</d2p1:Icon>
<d2p1:IsStop>7</d2p1:IsStop>
<d2p1:Lat>3</d2p1:Lat>
<d2p1:Lng>4</d2p1:Lng>
<d2p1:LocationId>1</d2p1:LocationId>
<d2p1:Speed>5</d2p1:Speed>
<d2p1:StopTime>8</d2p1:StopTime>
<d2p1:StopTimeStr>sample string 11</d2p1:StopTimeStr>
<d2p1:Time>sample string 2</d2p1:Time>
</d2p1:HistoryInfo>
</Items>
<ItemsCount>4</ItemsCount>
<LastDeviceUtcDate>sample string 3</LastDeviceUtcDate>
<LastLocationId>2</LastLocationId>
<State>1</State>
</HistoryResult>