POST api/Map/PostTracking

获取单个设备实时位置数据

请求信息

URI 参数

None.

Body 参数

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

设备唯一ID

integer

None.

MapType

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

string

None.

TimeZone

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

string

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",
  "Token": "sample string 4",
  "Language": "sample string 5"
}

application/xml, text/xml

Sample:
<GetTrackingModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OpenWebAPI.Models.ParModel">
  <Language>sample string 5</Language>
  <Token>sample string 4</Token>
  <DeviceID>1</DeviceID>
  <MapType>sample string 2</MapType>
  <TimeZone>sample string 3</TimeZone>
</GetTrackingModel>

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 'GetTrackingModel'.

响应信息

资源描述

GetTrackingResult
参数名称备注说明数据类型附加信息
DeviceUtcDate

设备定位时间

string

None.

LastCommunication

设备和服务器最后通讯时间

string

None.

IMEI

设备唯一编码

string

None.

DeviceName

设备名称

string

None.

ModelName

设备型号

string

None.

Status

设备状态 0表示未启用 1表示运动状态 2表示静止状态 3表示离线状态 4表示欠费状态 5表示休眠状态

integer

None.

Latitude

纬度 受入参MapType影响,直接返回对应地图可以直接使用的经纬度

string

None.

Longitude

经度 受入参MapType影响,直接返回对应地图可以直接使用的经纬度

string

None.

OLatitude

纬度 未经过国内纠偏算法计算的原始纬度数据

string

None.

OLongitude

经度 未经过国内纠偏算法计算的原始经度数据

string

None.

Speed

瞬时速度 单位 :公里/小时

string

None.

Course

方向角 范围:0-360 0和360都表示正北 90表示正东 180表示正南 270表示正西 从0开始顺时针增加方向值 特殊说明:基站定位时方向角为999 WIFI定位时方向角为888

string

None.

GSM

4G信号值 0-100 100表示信号值满值

integer

None.

Satellite

参与定位的卫星颗数

integer

None.

ACC

ACC状态 --表示没有该状态值 0表示关闭 1表示开启

string

None.

Oil

断油电状态 --表示没有该状态值 1表示接通 0表示断开

string

None.

Dismantle

拆除状态 --表示没有该状态值 2表示拆除 0表示未拆除

string

None.

Voltage

外部电电源电压 单位 :伏(v) --表示没有该状态值

string

None.

Battery

设备内部电池电量百分比 --表示没有该状态值

string

None.

WorkModel

工作模式,仅部分型号设备有该值 --表示没有该状态值 1表示定时模式 2表示定点模式 3表示连续定位模式 4表示智能监控模式 5连续定位省电模式 6连续定位在线模式 7定时省电模式 8补传省电模式 9紧急模式 10正常模式A 11定时模式 12正常模式B ***注:1-4为VT99M型号设备工作模式 5-8为VT77M型号设备工作模式 9-12为PT01型号设备工作模式

string

None.

LocationType

定位方式 1表示卫星定位 2表示基站定位 3表示WIFI定位 4表示单点定位 5表示差分定位 6表示RTK 固定解 7表示RTK 浮点解 8惯导定位 ***注:4-8为高精度设备特有定位方式

string

None.

StopTimeMinute

设备静止时,在原地停留的时长 单位:分钟 仅设备状态为静止时有效

integer

None.

OfflineTime

设备离线时长 单位:分钟 仅设备状态为离线时有效

string

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:
{
  "DeviceUtcDate": "sample string 1",
  "LastCommunication": "sample string 2",
  "IMEI": "sample string 3",
  "DeviceName": "sample string 4",
  "ModelName": "sample string 5",
  "Status": 6,
  "Latitude": "sample string 7",
  "Longitude": "sample string 8",
  "OLatitude": "sample string 9",
  "OLongitude": "sample string 10",
  "Speed": "sample string 11",
  "Course": "sample string 12",
  "GSM": 13,
  "Satellite": 14,
  "ACC": "sample string 15",
  "Oil": "sample string 16",
  "Dismantle": "sample string 17",
  "Voltage": "sample string 18",
  "Battery": "sample string 19",
  "WorkModel": "sample string 20",
  "LocationType": "sample string 21",
  "StopTimeMinute": 22,
  "OfflineTime": "sample string 23",
  "State": 24,
  "Remark": "sample string 25"
}

application/xml, text/xml

Sample:
<GetTrackingResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OpenWebAPI.Models.ResModel">
  <Remark>sample string 25</Remark>
  <State>24</State>
  <ACC>sample string 15</ACC>
  <Battery>sample string 19</Battery>
  <Course>sample string 12</Course>
  <DeviceName>sample string 4</DeviceName>
  <DeviceUtcDate>sample string 1</DeviceUtcDate>
  <Dismantle>sample string 17</Dismantle>
  <GSM>13</GSM>
  <IMEI>sample string 3</IMEI>
  <LastCommunication>sample string 2</LastCommunication>
  <Latitude>sample string 7</Latitude>
  <LocationType>sample string 21</LocationType>
  <Longitude>sample string 8</Longitude>
  <ModelName>sample string 5</ModelName>
  <OLatitude>sample string 9</OLatitude>
  <OLongitude>sample string 10</OLongitude>
  <OfflineTime>sample string 23</OfflineTime>
  <Oil>sample string 16</Oil>
  <Satellite>14</Satellite>
  <Speed>sample string 11</Speed>
  <Status>6</Status>
  <StopTimeMinute>22</StopTimeMinute>
  <Voltage>sample string 18</Voltage>
  <WorkModel>sample string 20</WorkModel>
</GetTrackingResult>