Сообщение 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 (Номерной знак).