Руководство пользователя для версии 7.9
Предыдущие версии: 7.8 | 7.7
×
  («Скай Электроникс», 2026

Получение ближайших транспортных средств

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

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

Метод

GET

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

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

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

Чтобы получить нужные данные, добавьте к адресу запроса команду.
  • cmd= get_nearest_vehicles 
  • group_id — ID группы транспортных средств (orgdep.id)
  • lat — широта целевой точки (от −90 до 90)
  • lon — долгота целевой точки (от −180 до 180)
  • radius — радиус поиска. Поддерживает значения вида 500M, 1KM, 10KM, 20KM или число в метрах
     

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

https://<server_address>/api/api.php?cmd=get_nearest_vehicles&group_id=228&lat=43.28191&lon=76.90723&radius=50KM
Ответ
 
 {
  "code": 0,
  "msg": "OK",
  "group_id": 123,
  "group_name": "Police Fleet",
  "location": { "latitude": 24.4539, "longitude": 54.3773 },
  "radius_meters": 10000,
  "vehicles_found": 2,
  "vehicles": [
    {
      "vehiclenumber": "POL-001",
      "agentid": 456,
      "veh_id": 789,
      "imei": "123456789",
      "model": "Toyota Land Cruiser",
      "vehicle_type": "Car",
      "location": {
        "address": "Sheikh Zayed Road, Dubai, UAE",
        "latitude": 24.4550,
        "longitude": 54.3780,
        "altitude": 10
      },
      "status": {
        "active": 1,
        "speed": 0,
        "direction": 0,
        "altitude": 10,
        "satsinview": 12,
        "ignition": 1,
        "unixtimestamp": 1706964000,
        "zone": []
      },
      "distance": {
        "meters": 1234,
        "kilometers": 1.23,
        "straight_line_meters": 1200
      },
      "travel_time": {
        "seconds": 180,
        "minutes": 3.0,
        "formatted": "3 min"
      }
    }
  ]
}
В ответ на API-запрос возвращается:
  • group_id — ID группы транспортных средств
  • group_name — название группы
  • location — координаты целевой точки
  • latitude— широта
  • longitude— долгота
  • radius_meters — радиус поиска в метрах
  • vehicles_found — количество найденных транспортных средств
  • vehicles — массив объектов с информацией о транспортных средствах:
  • vehiclenumber— номер транспортного средства
  • agentid— ID агента/устройства
  • veh_id— ID объекта
  • imei— IMEI устройства
  • model— модель ТС
  • vehicle_type— тип ТС (Car, Truck и др.)
  • location— местоположение ТС
  • address— адрес (по данным геокодера)
  • latitude, longitude, altitude
  • status— текущее состояние ТС
  • active— активность (1 = в работе)
  • speed— скорость, км/ч
  • direction— направление движения
  • altitude— высота
  • satsinview— количество спутников
  • ignition— зажигание (1 = включено)
  • unixtimestamp— время события в формате UNIX
  • zone— массив текущих геозон
  • distance— расстояние до цели
  • meters— в метрах
  • kilometers— в километрах
  • straight_line_meters— по прямой в метрах
  • travel_time— расчётное время движения до цели
  • seconds — в секундах
  • minutes — в минутах
  • formatted— форматированное время (например, "3 min")