Статус объекта и расстояние до точки или геозоны

Этот API передаёт текущий статус транспортного средства, а также время и расстояние до заданной точки или геозоны.

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

Метод

GET

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

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

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

  • cmd = get_status_and_distance — команда для получения статуса и расстояния
  • vehnum — гаражный или госномер автомобиля, можно указать несколько через запятую
  • zone — название геозоны (если нужно рассчитать расстояние до зоны)
  • point — координаты точки в формате широта,долгота (если нужно расстояние до конкретной точки)
  • node — номер узла, на котором нужно выполнить команду
 

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

https://<server_address>/api/api.php?cmd=get_status_and_distance&vehnum=М897ЕТ777&zone=Госпиталь%20Лапино&node=1
https://<server_address>/api/api.php?cmd=get_status_and_distance&vehnum=М897ЕТ777&point=55.923032,37.659668&node=1
Ответ
{
  "cstatus": 6,
  "cstatus_timestamp": 1554985159,
  "destination_name": "Zero coordinates",
  "distance": {
    "code": 0,
    "length": 27613,
    "msg": "OK",
    "point": "55.923032,37.659668",
    "time": 2002,
    "type": "point"
  },
  "ignition": 1,
  "rbu": "08",
  "sensors": {
    "Unloading Sensor": "on|1554985138",
    "Loading Sensor": "on|1554985138",
    "Ignition Sensor": "on|1554985138",
    "FUEL SENSORS OPERATION SENSORS": "Operating|1554985138",
    "Fuel ... fuel": "202.96 Liter|1554995669"
  },
  "source_name": "Loading_Chertanovo",
  "status": 4,
  "status_timestamp": 1554985072,
  "unixtimestamp": 1554995864,
  "vehiclenumber": "М897ЕТ777",
  "zone": []
}
В ответ на API-запрос возвращается:
  • cstatus — текущий статус объекта
  • cstatus_timestamp — время фиксации статуса (Unix timestamp)
  • destination_name — название точки назначения
  • distance — объект с информацией о расстоянии и времени до точки или зоны:
  • length — расстояние в метрах
  • time — время в секундах
  • type — тип объекта (point или zone)
  • point — координаты точки (если type=point)
  • ignition — состояние зажигания (1 = включено)
  • rbu — идентификатор РБУ
  • sensors — состояние различных сенсоров (например, загрузка/разгрузка, топливо)
  • source_name — имя источника данных
  • status — статус объекта
  • status_timestamp — время последнего изменения статуса
  • unixtimestamp — время получения данных
  • vehiclenumber — номер транспортного средства
  • zone — массив с текущими зонами (если есть)