Различия между официальной реализацией GTFS Realtime и реализацией этой спецификации в Google Транспорте

На этой странице описаны основные различия между официальной реализацией GTFS Realtime и реализацией этой спецификации в Google Транспорте по следующим типам:

  • Игнорируемые официальные спецификации. Эти поля входят в официальную реализацию GTFS. Google Транспорт обрабатывает эти данные без ошибок, но не использует их.

  • Другая интерпретация. Эти поля включают части официальной спецификации GTFS, которые в Google Транспорте интерпретируются не так, как в определениях GTFS.

  • Экспериментальная поддержка. Это экспериментальные поля в реализации Google Транспорта. Чтобы реализовать новое экспериментальное поле, обратитесь к команде Google Транспорта.

  • Расширения, поддерживаемые в Google Транспорте. Эти расширения не входят в официальную реализацию GTFS. К этой категории относятся как общедоступные расширения, так и расширения из Google Транспорта. Любой партнер может отправить эту информацию в Транспорт через свой фид.

Данные об общественном транспорте в реальном времени

В этом разделе описаны основные различия между официальной реализацией GTFS и реализацией этой спецификации в Google Транспорте для фида данных об общественном транспорте в реальном времени.

Игнорируемые официальные спецификации в фидах данных в реальном времени

Некоторые игнорируемые спецификации являются экспериментальными. Подробная информация приведена на сайте gtfs.org.

В таблице 1 приведены все поля, которые имеют определения GTFS и которые Google Транспорт игнорирует в фидах данных в реальном времени.

Таблица 1. Игнорируемые официальные поля в фидах данных в реальном времени
Сообщение Игнорируемое поле с определением GTFS Тип поля
сообщение Alert image TranslatedImage
сообщение Alert image_alternative_text TranslatedString
сообщение Alert severity_level Перечисление
сообщение Alert tts_description_text Proto
сообщение Alert tts_header_text Proto
сообщение CarriageDetails id Строка
сообщение CarriageDetails occupancy_percentage int32
сообщение Position bearing Число с плавающей запятой
сообщение Position odometer Число двойной точности
сообщение Position speed Число с плавающей запятой
сообщение Shape encoded_polyline Строка
сообщение Shape shape_id Строка
сообщение StopTimeUpdate (в TripUpdate) arrival.uncertainty int32
сообщение StopTimeUpdate (в TripUpdate) stop_time_properties Proto
сообщение TripUpdate trip_properties Proto
сообщение TripUpdate vehicle VehicleDescriptor
сообщение VehicleDescriptor license_plate Строка
сообщение VehicleDescriptor wheelchair_accessible WheelchairAccessible
сообщение VehiclePosition congestion_level Перечисление
сообщение VehiclePosition current_status VehicleStopStatus
сообщение VehiclePosition current_stop_sequence uint32
сообщение VehiclePosition multi_carriage_details.id Строка
сообщение VehiclePosition occupancy_percentage uint32
сообщение VehiclePosition stop_id Строка

Разная интерпретация в фидах данных в реальном времени

Хотя в Google Транспорте принимаются некоторые поля GTFS, они интерпретируются не так, как в GTFS.

В таблице 2 приведены поля GTFS в фидах данных в реальном времени, которые являются необязательными или условно обязательными в Google Транспорте. Если поле необязательное, в таблице указывается, поддерживает ли Google Транспорт значения перечисления.

Таблица 2. Поля в фидах данных в реальном времени, интерпретируемые по-другому
Название файла Поле с определением в GTFS Тип поля Обязательно в Google Транспорте? Сведения о реализации в Google Транспорте
сообщение StopTimeUpdate (в TripUpdate) stop_id Строка Условно обязательно

Если указана строка stop_id, она должна соответствовать одному из следующих условий.

  • Строка stop_id должна быть такой же, как и в файле stops.txt соответствующего канала GTFS.
  • Если используется другая строка stop_id, то указанная строка stop_id должна быть элементом того же уровня или дочерним по отношению к строке stop_id, которая указана в статическом фиде GTFS. Также необходимо указать соответствующее поле stop_sequence.
сообщение StopTimeUpdate schedule_relationship Перечисление Необязательно

Google Транспорт поддерживает следующие значения перечисления:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
сообщение TripDescriptor schedule_relationship Перечисление Необязательно

Google Транспорт не поддерживает следующие значения перечисления:

  • DUPLICATED
  • CANCELED, если оно не для записей TripUpdate

Google поддерживает следующие значения перечисления:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED, поддерживается только для записей TripUpdate

Экспериментальная поддержка в фидах данных в реальном времени

Если вам нужна поддержка с реализацией новых экспериментальных полей, свяжитесь с командой Google Транспорта.

Расширения в фидах данных в реальном времени, поддерживаемые Google Транспортом

На момент публикации этой статьи полей, относящихся к данной категории, нет. Если вам нужна помощь, свяжитесь с командой Google Транспорта.