×

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

Этот API передаёт информацию о транспортных средствах, включая их текущее местоположение, данные с датчиков, техническую информацию, а также дополнительные параметры.

Как получить данные

Метод

GET

Адрес запроса

Для получения данных используйте адрес:  https://<server_address>/api/api.php?

Параметры запроса

Чтобы получить нужные данные, добавьте к адресу запроса команду.
  • cmd=list — команда для получения списка транспортных средств
  • node — номер узла, на котором нужно выполнить команду
Формат запрашиваемых данных — массив данных о транспортных средствах.
 

Пример запроса

https://<server_address>/api/api.php?cmd=list&node=1
Ответ
{
  "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",
            "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": ""
          }
        ]
      }
    }
  ]
}
В ответ на API-запрос возвращается:
  • 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 — группа датчиков