POST api/Location/NewsHistory

Get history location data for a device in a time range

Request Information

Body Parameters

HistoryModel
NameDescriptionTypeAdditional 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:29:13.4934785+08:00",
  "EndTime": "2025-12-12T05:29:13.4934785+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:29:13.4934785+08:00</EndTime>
  <MapType>sample string 5</MapType>
  <PositionType>7</PositionType>
  <SelectCount>6</SelectCount>
  <ShowLbs>4</ShowLbs>
  <StartTime>2025-12-12T05:29:13.4934785+08:00</StartTime>
</HistoryModel>

Response Information

Resource Description

State 状态码
0. 表示成功
10. 该时段无数据
1100. 表示设备不存在

HistoryResult
NameDescriptionTypeAdditional 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>