×

Список транспортных средств

Этот 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 — группа датчиков