×

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

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