Vehicle Positions¶
Vehicle position используется для предоставления автоматически генерируемой информации о местоположении транспортного средства, например, с помощью GPS-устройства на борту. Одно vehicle position должно быть предоставлено для каждого транспортного средства, которое способно его предоставить.
Поездка, которую в данный момент обслуживает транспортное средство, должна быть указана через TripDescriptor. Вы также можете предоставить VehicleDescriptor, который определяет точное физическое транспортное средство, о котором вы предоставляете обновления. Документация приведена ниже.
Может быть предоставлена timestamp, обозначающая время, когда было снято показание положения. Обратите внимание, что она отличается от временной метки в заголовке фида, которая является временем, когда это сообщение было сгенерировано сервером.
Также может быть предоставлен Current passage (либо как stop_sequence, либо как stop_id). Это ссылка на остановку, на которую транспортное средство либо направляется, либо уже остановилось.
Position¶
Position содержит данные о Vehicle Position. Широта и долгота являются обязательными, остальные поля необязательны. К этим типам данных относятся:
- Latitude - градусы севера, в системе координат WGS-84.
- Longitude - градусы восточной долготы в системе координат WGS-84.
- Bearing - направление, в котором движется автомобиль
- Odometer - расстояние, пройденное транспортным средством
- Speed - мгновенная скорость, измеренная транспортным средством, в метрах в секунду
CongestionLevel¶
Vehicle position также позволяет агентству определить уровень загруженности дорог, в которых в данный момент находится транспортное средство. Заторы могут быть классифицированы по следующим категориям:
- Unknown congestion level
- Running smoothly
- Stop and go
- Congestion
- Severe congestion
Агентство само решает, что классифицировать как каждый тип затора. Мы рекомендуем использовать категорию "сильный затор" только в ситуациях, когда движение настолько перегружено, что люди покидают свои автомобили.
OccupancyStatus¶
Vehicle position также позволяет агентству определить степень заполненности транспортного средства пассажирами. Заполненность может быть классифицирована по следующим категориям:
- Empty
- Many seats available
- Few seats available
- Standing room only
- Crushed standing room only
- Full
- Not accepting passengers
Это поле является экспериментальным и может быть изменено. Возможно, в будущем оно будет официально принято.
VehicleStopStatus¶
Vehicle stop status средства придает больше смысла статусу транспортного средства по отношению к остановке, к которой оно в данный момент приближается или на которой находится. Он может быть установлен на любое из этих значений.
- Incoming at - транспортное средство вот-вот прибудет на указанную остановку.
- Stopped at - транспортное средство остановилось на указанной остановке.
- In transit to - указанная остановка является следующей остановкой для транспортного средства - по умолчанию.
VehicleDescriptor¶
VehicleDescriptor описывает конкретное физическое транспортное средство и может содержать любой из следующих атрибутов:
- ID - внутренняя система идентификации транспортного средства. Должен быть уникальным для данного транспортного средства
- Label - видимая пользователю метка - например, название поезда.
- License plate - фактический номерной знак транспортного средства