POST api/Map/PostHistory

获取单个设备历史轨迹数据，如果请求轨迹起止时间跨度较大，建议分批次少量获取轨迹数据，提升性能 例如：一次获取200条

请求信息

URI 参数

None.

Body 参数

GetHistoryModel
参数名称备注说明数据类型附加信息
DeviceID

设备唯一ID

 integer

None.
MapType

地图类型用于获取对应地图的经纬度 [谷歌、华为、高德、苹果原生地图传值google] [百度地图传值baidu] [天地图、OpenStreetMap传值tian]

 string

None.
TimeZone

用户所在时区 国内统一为China Standard Time 即东八区时区,也可以为Login方法返回的用户设置时区值

 string

None.
StartTime

轨迹起始时间 时间格式：yyyy-MM-dd HH:mm:ss ，时间为当地时间，例如中国用户传递北京时间，即东八区时间

 string

None.
EndTime

轨迹截止时间 时间格式：yyyy-MM-dd HH:mm:ss ，时间为当地时间，例如中国用户传递北京时间，即东八区时间

 string

None.
GetLBS

返回的轨迹数据中是否包含基站数据 1表示包含基站数据（GPS+LBS） 0表示不包含基站数据(GPS)

 integer

None.
GetCount

获取轨迹的数量，主要用于时间跨度大时，分批次获取展示，提升性能。本次请求时间段内轨迹按从小到大时间顺序获取前N条数据

 integer

None.
Token

Token 授权信息，第一次请求时该值为空

 string

None.
Language

语言 中文：zh-cn 英文：en-us

 string

None.

请求格式

application/json, text/json

Sample: 
{
  "DeviceID": 1,
  "MapType": "sample string 2",
  "TimeZone": "sample string 3",
  "StartTime": "sample string 4",
  "EndTime": "sample string 5",
  "GetLBS": 6,
  "GetCount": 7,
  "Token": "sample string 8",
  "Language": "sample string 9"
}

application/xml, text/xml

Sample: 
<GetHistoryModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OpenWebAPI.Models.ParModel">
  <Language>sample string 9</Language>
  <Token>sample string 8</Token>
  <DeviceID>1</DeviceID>
  <EndTime>sample string 5</EndTime>
  <GetCount>7</GetCount>
  <GetLBS>6</GetLBS>
  <MapType>sample string 2</MapType>
  <StartTime>sample string 4</StartTime>
  <TimeZone>sample string 3</TimeZone>
</GetHistoryModel>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'GetHistoryModel'.

响应信息

资源描述

GetHistoryResult
参数名称备注说明数据类型附加信息
LastDeviceUtcDate

返回轨迹数据中，最后一个定位点的定位时间 格式：yyyy-MM-dd HH:mm:ss ***注：如果在分批次获取轨迹数据中，该时间小于等于轨迹结束时间(EndTime)时，应认为轨迹数据尚未获取完毕，需要再次以该值作为开始时间，截止时间不变，再次获取剩余轨迹数据，和前边返回的轨迹数据拼接为完整轨迹数据。直至返回的轨迹数量为0，认为获取完毕请求时间段内的所有轨迹数据。

 string

None.
Items

轨迹数据集合

 Collection of HistoryInfo

None.
State

返回值基类 0表示成功返回 -1表示接口异常

 integer

None.
Remark

返回值说明 通常用于解释返回值情况，例如：接口成功返回、提交的鉴权信息匹配异常等解释说明 0：接口成功返回 -1：接口返回异常 999：鉴权失败 1：提交的鉴权信息匹配异常 2：提交的Token已过期，请重新获取Token 3：用户不存在 4：暂不支持设备IMEI登录 5：用户名下没有设备存在 6：没有获取到分组信息 7：设备不存在 8：没有获取到该时间段内的轨迹数据 9：没有获取到该设备的报警信息 10：用户不存在或密码不匹配 11：报警信息不存在 12：要删除的电子围栏不存在 13：没有获取到该设备的ACC数据 14：该区域内没有设备存在 15：无法获取到该设备的OBD信息 16：要修改的围栏不属于该设备

 string

None.

响应格式

application/json, text/json

Sample: 
{
  "LastDeviceUtcDate": "sample string 1",
  "Items": [
    {
      "DeviceUtcDate": "sample string 1",
      "ServerUtcTime": "sample string 2",
      "Latitude": "sample string 3",
      "Longitude": "sample string 4",
      "OLatitude": "sample string 5",
      "OLongitude": "sample string 6",
      "Speed": "sample string 7",
      "Course": "sample string 8",
      "GSM": 9,
      "Satellite": 10,
      "ACC": "sample string 11",
      "Oil": "sample string 12",
      "Dismantle": "sample string 13",
      "Voltage": "sample string 14",
      "Battery": "sample string 15",
      "LocationType": "sample string 16",
      "IsStop": 17,
      "StopTimeMinute": 18,
      "Distance": 19.1
    },
    {
      "DeviceUtcDate": "sample string 1",
      "ServerUtcTime": "sample string 2",
      "Latitude": "sample string 3",
      "Longitude": "sample string 4",
      "OLatitude": "sample string 5",
      "OLongitude": "sample string 6",
      "Speed": "sample string 7",
      "Course": "sample string 8",
      "GSM": 9,
      "Satellite": 10,
      "ACC": "sample string 11",
      "Oil": "sample string 12",
      "Dismantle": "sample string 13",
      "Voltage": "sample string 14",
      "Battery": "sample string 15",
      "LocationType": "sample string 16",
      "IsStop": 17,
      "StopTimeMinute": 18,
      "Distance": 19.1
    }
  ],
  "State": 2,
  "Remark": "sample string 3"
}

application/xml, text/xml

Sample: 
<GetHistoryResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OpenWebAPI.Models.ResModel">
  <Remark>sample string 3</Remark>
  <State>2</State>
  <Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/OpenWebAPI.Models.ViewModel">
    <d2p1:HistoryInfo>
      <d2p1:ACC>sample string 11</d2p1:ACC>
      <d2p1:Battery>sample string 15</d2p1:Battery>
      <d2p1:Course>sample string 8</d2p1:Course>
      <d2p1:DeviceUtcDate>sample string 1</d2p1:DeviceUtcDate>
      <d2p1:Dismantle>sample string 13</d2p1:Dismantle>
      <d2p1:Distance>19.1</d2p1:Distance>
      <d2p1:GSM>9</d2p1:GSM>
      <d2p1:IsStop>17</d2p1:IsStop>
      <d2p1:Latitude>sample string 3</d2p1:Latitude>
      <d2p1:LocationType>sample string 16</d2p1:LocationType>
      <d2p1:Longitude>sample string 4</d2p1:Longitude>
      <d2p1:OLatitude>sample string 5</d2p1:OLatitude>
      <d2p1:OLongitude>sample string 6</d2p1:OLongitude>
      <d2p1:Oil>sample string 12</d2p1:Oil>
      <d2p1:Satellite>10</d2p1:Satellite>
      <d2p1:ServerUtcTime>sample string 2</d2p1:ServerUtcTime>
      <d2p1:Speed>sample string 7</d2p1:Speed>
      <d2p1:StopTimeMinute>18</d2p1:StopTimeMinute>
      <d2p1:Voltage>sample string 14</d2p1:Voltage>
    </d2p1:HistoryInfo>
    <d2p1:HistoryInfo>
      <d2p1:ACC>sample string 11</d2p1:ACC>
      <d2p1:Battery>sample string 15</d2p1:Battery>
      <d2p1:Course>sample string 8</d2p1:Course>
      <d2p1:DeviceUtcDate>sample string 1</d2p1:DeviceUtcDate>
      <d2p1:Dismantle>sample string 13</d2p1:Dismantle>
      <d2p1:Distance>19.1</d2p1:Distance>
      <d2p1:GSM>9</d2p1:GSM>
      <d2p1:IsStop>17</d2p1:IsStop>
      <d2p1:Latitude>sample string 3</d2p1:Latitude>
      <d2p1:LocationType>sample string 16</d2p1:LocationType>
      <d2p1:Longitude>sample string 4</d2p1:Longitude>
      <d2p1:OLatitude>sample string 5</d2p1:OLatitude>
      <d2p1:OLongitude>sample string 6</d2p1:OLongitude>
      <d2p1:Oil>sample string 12</d2p1:Oil>
      <d2p1:Satellite>10</d2p1:Satellite>
      <d2p1:ServerUtcTime>sample string 2</d2p1:ServerUtcTime>
      <d2p1:Speed>sample string 7</d2p1:Speed>
      <d2p1:StopTimeMinute>18</d2p1:StopTimeMinute>
      <d2p1:Voltage>sample string 14</d2p1:Voltage>
    </d2p1:HistoryInfo>
  </Items>
  <LastDeviceUtcDate>sample string 1</LastDeviceUtcDate>
</GetHistoryResult>