Список транспортных средств
Этот 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
},
"extra_params": {
"kmlimit": "2",
"mvanumber": "12312",
"make_model": "BMW"
},
"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",
"id": "1187852",
"hum_value": "off",
"dig_value": "0",
"raw_value": "0",
"change_ts": "1627467122",
"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
-
extra_params — дополнительные параметры транспортного средства. Параметры могут отличаться в зависимости от настроек и типа объекта.:
-
kmlimit — лимит пробега
-
mvanumber — номер транспортного средства
-
make_model — марка и модель
-
sensors — массив доступных датчиков
-
sensors_status — детальный статус каждого датчика, включая:
-
name — название датчика
-
id — идентификатор датчика
-
hum_value — реальное значение после калибровки
-
dig_value — цифровое значение после калибровки
-
raw_value — необработанное значение до калибровки
-
change_ts — время последнего изменения значения
-
group — группа датчиков