Сообщения VehiclePosition

Сообщение VehiclePosition в фиде содержит информацию, которая поступает с устройства GPS на борту транспортного средства. Такое сообщение должно предоставляться для каждого транспортного средства, поддерживающего геолокацию.

Рейс, который в настоящее время выполняет транспортное средство, должен быть определен в сообщении TripDescriptor. Также можно использовать сообщение VehicleDescriptor, в котором указывается конкретное транспортное средство. Документация представлена ниже.

Необязательный параметр timestamp указывает, когда выполнена геолокация транспортного средства. Обратите внимание, что он будет отличаться от параметра timestamp в заголовке фида, который отражает время создания сообщения на сервере.

Также может быть указан текущий участок пути (в параметре stop_sequence или stop_id): он определяется следующей или текущей остановкой.

Поле position

В поле position сообщения VehiclePosition содержатся данные о местоположении транспортного средства. Значения широты и долготы обязательны, остальные – нет:

  • Latitude – градусы северной широты в системе координат WGS-84.
  • Longitude – градусы восточной долготы в системе координат WGS-84.
  • Bearing – направление движения транспортного средства.
  • Odometer – расстояние, пройденное транспортным средством.
  • Speed – мгновенная скорость в метрах в секунду, измеренная приборами транспортного средства.

Поле congestion_level

В сообщении VehiclePosition также можно указывать уровень загруженности дорог в местонахождении транспортного средства. Этот параметр может принимать следующие значения:

  • UNKNOWN_CONGESTION_LEVEL (уровень загруженности неизвестен);
  • RUNNING_SMOOTHLY (Нормальное движение);
  • STOP_AND_GO (Частые остановки);
  • CONGESTION (Пробка);
  • SEVERE_CONGESTION (Сильный затор).

Каждое агентство определяет степень загруженности дороги самостоятельно. Мы рекомендуем использовать наивысшую категорию только в самых тяжелых ситуациях, когда движение полностью останавливается и люди выходят из машин.

Поле occupancy_status

В сообщении VehiclePosition можно указать данные о заполненности транспортного средства. Этот параметр может принимать следующие значения:

  • EMPTY (Пустой);
  • MANY_SEATS_AVAILABLE (Много свободных мест);
  • FEW_SEATS_AVAILABLE (Мало свободных мест);
  • STANDING_ROOM_ONLY (Только стоячие места);
  • CRUSHED_STANDING_ROOM_ONLY (Почти полный);
  • FULL (Нет мест);
  • NOT_ACCEPTING_PASSENGERS (Нет посадки).

Это поле пока имеет статус экспериментального. В дальнейшем оно может быть изменено и добавлено в спецификацию.

Поле VehicleStopStatus

Содержит информацию о следующей или текущей остановке. Этот параметр может принимать следующие значения:

  • INCOMING_AT (Прибывает на…);
  • STOPPED_AT (Находится на остановке…);
  • IN_TRANSIT_TO (Следующая остановка…). Это значение используется по умолчанию.

Сообщение VehicleDescriptor

Идентифицирует транспортное средство. Может содержать следующие поля:

  • ID (Внутренний идентификатор). Должен быть уникальным.
  • Label (Название). Обозначение маршрута, указанное на транспортном средстве.
  • License_plate (Номерной знак).