GET api/Map/GetTracking?DeviceID={DeviceID}&MapType={MapType}&TimeZone={TimeZone}&Token={Token}&Language={Language}
获取单个设备实时位置数据
请求信息
URI 参数
| 参数名称 | 备注说明 | 数据类型 | 附加信息 |
|---|---|---|---|
| DeviceID |
设备唯一ID |
integer |
Required |
| MapType |
地图类型用于获取对应地图的经纬度 [谷歌、华为、高德、苹果原生地图传值google] [百度地图传值baidu] [天地图、OpenStreetMap传值tian] |
string |
Required |
| TimeZone |
用户所在时区 国内统一为China Standard Time 即东八区时区,也可以为Login方法返回的用户设置时区值 |
string |
Required |
| Token |
Token 授权信息，第一次请求时该值为空 |
string |
Required |
| Language |
语言 中文：zh-cn 英文：en-us |
string |
Required |
Body 参数
None.
响应信息
资源描述
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
{
"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
<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>