Список транспортных средств
Этот API предназначен для получения списка транспортных средств с информацией о каждом из них, включая данные о местоположении, техническую информацию и показания датчиков.
Как получить данные
Метод
GET
Адрес запроса
Для получения данных используйте адрес: https://<address>/api/api.php?
<address> — адрес сайта
Параметры запроса
Чтобы получить нужные данные, добавьте к адресу запроса команду.
-
cmd = list — команда для получения списка транспортных средств.
Формат запрашиваемых данных — массив данных о транспортных средствах.
Пример
API-запрос
https://<address>/api/api.php?cmd=list
|
Ответ на API
{
"code": 0,
"msg": "OK",
"list":[
{
"agentid":9003,
"imei":"356307046873054",
"typeid":1,
"type":"Car",
"vehiclenumber":"Х444МР123",
"vin": "TRDFG65876",
"folder":"Geo-Center OOO",
"created_time":1414224633,
"current_mileage":881,
"status":{
"unixtimestamp":"1418744535",
"lat":"43.5562",
"lon":"39.9084",
"speed":0,
"dir":268,
"alt":246,
"satsinview":16,
"sensors":[
{
"name":"Parking",
"description":"TEST SPEED"
},
{
"name":"Fuel sensor",
"description":"Fuel sensor"
},
{
"name":"External power supply",
"description":"External power supply"
},
{
"name":"Ignition sensor",
"description":"Ignition sensor"
}
],
"sensors_status":[
{
"name":"Ignition sensor", // sensor name
"id":"1187852", // sensor id
"hum_value":"off", // readable value after calibration
"dig_value":"0", // digital value after calibration
"raw_value":"0", // raw value before calibration
"change_ts":"1627467122", // time of the last value change unixtimestamp
"group":"" // sensor group
},
{
"name":"External power supply",
"id":"1187851",
"hum_value":"26.27 V",
"dig_value":"26.27",
"raw_value":"26272",
"change_ts":"1627467122",
"group":""
},
{
"name":"Fuel sensor",
"id":"1187850",
"hum_value":"1 l",
"dig_value":"1",
"raw_value":"1",
"change_ts":"1626336197",
"group":""
}
]
}
}
]
}
|
Параметры ответа
Ответ возвращается в формате JSON и содержит:
-
code — код статуса (0 — успех)
-
msg — сообщение о статусе
-
list — массив объектов транспортных средств, каждый из которых содержит:
-
agentid — уникальный идентификатор устройства слежения
-
imei — международный идентификатор мобильного оборудования
-
typeid — числовой идентификатор типа транспортного средства
-
type — тип транспортного средства
-
vehiclenumber — регистрационный номер транспортного средства
-
vin — идентификационный номер транспортного средства
-
folder — организационная группа
-
created_time — время добавления в систему в Unixtimestamp-формате
-
current_mileage —текущий пробег
-
status — информация о текущем состоянии:
-
unixtimestamp — время последнего обновления
-
lat — широта
-
lon — долгота
-
speed — скорость
-
dir — направление движения в градусах
-
alt — высота над уровнем моря
-
satsinview — количество видимых спутников GPS
-
sensors — массив доступных датчиков
-
sensors_status — детальный статус каждого датчика, включая:
-
name — название датчика
-
id — идентификатор датчика
-
hum_value — реальное значение после калибровки
-
dig_value — цифровое значение после калибровки
-
raw_value — необработанное значение до калибровки
-
change_ts — время последнего изменения значения
-
group — группа датчиков