Отчёт по движению с гео-привязкой

Этот API позволяет получить отчёт о перемещениях транспортного средства за выбранный период с указанием координат и географической информации (адрес, район, город и т. д.). Данные содержат информацию о начале и завершении каждого отрезка движения, средней и максимальной скорости, длине пути и месте по гео-координатам.

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

Метод

GET

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

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

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

  • cmd = rungeo — команда для получения отчёта
  • imei — уникальный идентификатор объекта в системе
  • start — время начала выборки в формате Unix timestamp
  • stop — время окончания выборки в формате Unix timestamp
  • node — номер узла, на котором нужно выполнить команду
 

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

https://<server_address>/api/api.php?cmd=rungeo&imei=356307045913463&start=1439413200&stop=1439586000&node=1
Ответ
{
  "code": 0,
  "msg": "OK",
  "tracks": {
    "1439443509": {
      "avgspeed": 35.3889,
      "length": 12.7304,
      "maxspeed": 59,
      "ts": 1439443509,
      "te": 1439445837,
      "slat": "47.2037",
      "slon": "39.6325",
      "elat": "47.2037",
      "elon": "39.6325",
      "sgeo": {
        "city": "Rostov-on-Don",
        "road": "2-ya Krasnodarskaya ulitsa",
        "house_number": "80 к13",
        "state": "Rostov Oblast",
        "postcode": "344091"
      },
      "egeo": {
        "city": "Rostov-on-Don",
        "road": "2-ya Krasnodarskaya Street",
        "house_number": "80 к13",
        "state": "Rostov Oblast",
        "postcode": "344091"
      }
    }
  }
}
В ответ на API-запрос возвращается:
  • code — код выполнения (0 = успех)
  • msg — сообщение о статусе
  • tracks — объект, где ключи — это метки времени начала поездки (Unix timestamp), а значения — данные о каждой поездке
Эти ключи одновременно являются уникальными идентификаторами треков (track_id), которые можно использовать в запросе метода gettrack для получения детальных точек маршрута.
Для каждой поездки:
  • avgspeed — средняя скорость (км/ч)
  • maxspeed — максимальная скорость (км/ч)
  • length — длина маршрута (км)
  • ts — время начала поездки (Unix timestamp)
  • te — время окончания поездки (Unix timestamp)
  • slat, slon — координаты старта (широта, долгота)
  • elat, elon — координаты конца
  • sgeo — адрес места старта (город, улица, дом, почтовый индекс)
  • egeo — адрес места окончания