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

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

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

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

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

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

Статический транзит

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

Игнорируются официальные спецификации в статических фидах.

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

В таблице 1 перечислены файлы GTFS, которые не поддерживаются Transit в статических фидах. Кроме того, ни одно из полей, определенных в этих файлах, не поддерживается Transit.

Таблица 1. Неподдерживаемые файлы GTFS в статических фидах
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

В таблице 2 перечислены все поля, определенные GTFS, которые игнорируются Transit в статических фидах.

Таблица 2. Игнорируемые поля GTFS в статических фидах
Имя файла Игнорируемое поле, определенное в GTFS. Тип поля
fare_attributes.txt payment_method Перечисление
feed_info.txt default_lang Код языка
feed_info.txt feed_publisher_name Текст
pathways.txt max_slope Плавать
routes.txt continuous_drop_off Перечисление
routes.txt continuous_pickup Перечисление
routes.txt network_id ИДЕНТИФИКАТОР
routes.txt route_desc Текст
routes.txt route_sort_order Неотрицательное целое число
stops.txt level_id ИДЕНТИФИКАТОР
stops.txt stop_desc Текст
stops.txt stop_url URL-адрес
stops.txt tts_stop_name Текст
stops.txt bikes_allowed Перечисление

Разная интерпретация в статических фидах

Хотя Transit принимает определенные поля, определенные GTFS, Transit интерпретирует их иначе, чем GTFS.

В таблице 3 показаны поля в статических фидах, которые Transit реализует иначе, чем описано в GTFS.

Таблица 3. Различные варианты реализации статических полей фида
Имя файла Поле, определенное в GTFS Тип поля Требуется Google Transit? Подробности реализации Google Transit
fare_attributes.txt transfers Перечисление Необходимый

Расширение Google Transit.

Общедоступная GTFS ограничивает значения диапазоном от 0 до 2 . Google Transit принимает значения от 0 до 5 .

В этом поле укажите максимально допустимое количество пересадок по тарифу. Сюда не входят групповые переводы, также известные как переводы на месте. Если вы не хотите устанавливать ограничения на количество пересадок по тарифу, оставьте поле transfers пустым.

pathways.txt pathway_mode Перечисление Необязательный Если поле pathway_mode указано и оставлено пустым, Google Transit принимает его и считает неизвестным.
stop_times.txt arrival_time Время Условно требуется Часы ограничены значениями от 00 до 99 , чего более чем достаточно для трехдневных поездок.
transfers.txt transfer_type Перечисление Необходимый

Значения 4 и 5 не поддерживаются и игнорируются.

Google Transit поддерживает значения 0 , 1 , 2 и 3 .

trips.txt block_id ИДЕНТИФИКАТОР Необязательный Подробнее см. в разделе Пример блочной передачи .

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

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

Расширения, поддерживаемые Google Transit, в статических фидах

В таблице 4 представлена ​​информация о расширениях Google Transit . Эти поля не являются частью официальной GTFS.

Таблица 4. Поддерживаемые расширения статических фидов
Имя файла Поле Тип поля Требуется Google Transit? Подробности реализации Google Transit
fare_attributes.txt ic_price Плавать Необязательный

Это расширение Google Transit доступно только партнерам в Японии.

Поле ic_price представляет сумму денег со скидкой, подлежащую оплате за этот тариф с помощью смарт-карты. Если для этого тарифа скидки не предусмотрены или смарт-карта не поддерживается, значение поля ic_price должно быть равно -1 .

fare_rules.txt contains_route_id ИДЕНТИФИКАТОР Необязательный

Расширение Google Transit.

Этот тариф применяется только к поездкам, которые посещают точный набор маршрутов, указанных значением route_id во всех строках для этой комбинации столбцов fare_id , origin_id и destination_id .

Если столбец contains_route_id отсутствует или все его значения для этого тарифа равны нулю, то тариф не ограничен этим параметром. Если для тарифа указано поле contains_route_id , то поле route_id должно быть пустым.

routes.txt checkin_duration Целое число Необязательный

Расширение Google Transit.

Поле checkin_duration указывает, на сколько секунд пассажиру рекомендуется прибыть до запланированного вылета, чтобы зарегистрироваться и сесть на борт.

Если пассажир соединяется с вылетом пересадкой, то любое определенное время пересадки переопределяет значение checkin_duration .

Значение checkin_duration — это всего лишь рекомендация, обычно предоставляемая транспортным оператором. Это может не отражать последний возможный момент, когда пассажир может прибыть и все же сесть в транспортное средство.

routes.txt route_type Перечисление Необходимый

Расширение Google Transit.

Чтобы узнать, как Google Transit расширяет параметры значения route_type , принятые GTFS, см. раздел Расширенные типы маршрутов GTFS .

stop_times.txt stop_direction_name Текст Необязательный

Расширение Google Transit.

Поле stop_direction_name указывает пассажирам направление поездки. Направление сохраняется как значение direction_name отправления с этой остановки.

Если поле stop_direction_name пусто, вместо него используется поле trip_direction_name , поддерживаемое транзитом. Если поля trip_direction_name и stop_direction_name пусты, то импортер общественного транспорта оставляет их пустыми. В этом случае партнеры могут вместо этого использовать значение stop_headsign или trip_headsign . Значения поля stop_direction_name нормализованы по регистру.

stops.txt signposted_as Текст Необязательный

Расширение Google Transit.

Поле signposted_as содержит дословный текст, написанный на вывеске платформы. Примеры: «К центру» и «Ист-Сайд и Бруклин».

Поле platform_code GTFS и поле signposted_as , поддерживаемое Transit, можно задать одновременно.

Различия между полями platform_code и signposted_as заключаются в следующем:

  • Длина. Поле platform_code обычно содержит число или букву, например 2 или C.
  • Язык. Поле platform_code не имеет языка, но значения signposted_as могут иметь переводы.
  • Стабильность. Поле platform_code меняется гораздо реже, чем поле signposted_as .
stops.txt vehicle_type Целое число Необязательный

Расширение Google Transit.

Поле vehicle_type указывает тип транспортных средств, которые используются на остановке. Это поле принимает типы маршрутов иерархического типа транспортного средства (HVT). Значения HVT взяты из стандарта Европейской группы экспертов по транспортным протоколам (TPEG).

agency.txt ticketing_deep_link_id ИДЕНТИФИКАТОР Необязательный

Расширение для продажи билетов Google Transit.

В файле agency.txt поле ticketing_deep_link_id представляет глубокую ссылку, которая используется для оформления билетов на поездки этого агентства.

routes.txt ticketing_deep_link_id ИДЕНТИФИКАТОР Необязательный

Расширение для продажи билетов Google Transit.

В файле routes.txt поле ticketing_deep_link_id представляет глубокую ссылку, которая используется для оформления билетов на поездки по этому маршруту.

stop_times.txt ticketing_stop_time_id ИДЕНТИФИКАТОР Необязательный

Расширение для продажи билетов Google Transit.

Поле ticketing_stop_time_id , если оно присутствует в файле stop_times.txt , переопределяет идентификатор, который представляет время остановки для оформления билетов с глубокими ссылками.

stop_times.txt ticketing_type Перечисление Необязательный

Расширение для продажи билетов Google Transit.

Поле ticketing_type указывает тип билета, который применяется к этому времени остановки.

Google Transit принимает следующие значения:

  • Empty . По умолчанию — в соответствии с поездкой.
  • 0 . Доступно только в том случае, если у агентства или маршрута включена глубокая ссылка для продажи билетов.
  • 1 . Недоступен.
ticketing_deep_links.txt android_intent_uri URI Необязательный

Расширение для продажи билетов Google Transit.

Поле android_intent_uri представляет URI намерения, который используется для глубоких ссылок в Android.

ticketing_deep_links.txt ios_universal_link_url URL-адрес Необязательный

Расширение для продажи билетов Google Transit.

Поле ios_universal_link_url представляет URL-адрес универсальной ссылки, который используется для глубоких ссылок в iOS.

ticketing_deep_links.txt ticketing_deep_link_id ИДЕНТИФИКАТОР Необходимый

Расширение для продажи билетов Google Transit.

Поле ticketing_deep_link_id представляет идентификатор глубокой ссылки.

ticketing_deep_links.txt web_url URL-адрес Необязательный

Расширение для продажи билетов Google Transit.

Поле web_url представляет URL-адрес, который используется для глубоких ссылок в Интернете.

ticketing_identifiers.txt agency_id ИДЕНТИФИКАТОР Необходимый

Расширение для продажи билетов Google Transit.

Чтобы указать агентство остановки, для которого определено поле ticketing_stop_id по умолчанию, поле agency_id содержит идентификатор из файла GTFS agency.txt .

ticketing_identifiers.txt stop_id ИДЕНТИФИКАТОР Необходимый

Расширение для продажи билетов Google Transit.

Чтобы указать остановку, для которой определено поле ticketing_stop_id по умолчанию, поле stop_id содержит идентификатор из файла GTFS stops.txt .

ticketing_identifiers.txt ticketing_stop_id ИДЕНТИФИКАТОР Необходимый

Расширение для продажи билетов Google Transit.

Поле ticketing_stop_id содержит идентификатор билета, который применяется к остановке. При желании агентство квалифицирует идентификатор.

trips.txt exceptional Перечисление Необязательный

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

Google принимает следующие варианты значений:

  • 0 . Регулярные услуги
  • 1 . Исключение службы. Например, услуги, добавленные в связи с особыми событиями, или услуги, отклоняющиеся от обычного маршрута из-за запланированных сбоев.
trips.txt ticketing_trip_id ИДЕНТИФИКАТОР Необязательный

Расширение для продажи билетов Google Transit.

Если поле ticketing_trip_id присутствует, его значение переопределяет поле trip_id , чтобы идентифицировать поездку для оформления билетов с глубокими ссылками.

trips.txt ticketing_type Перечисление Необязательный

Расширение для продажи билетов Google Transit.

Поле ticketing_type указывает тип билета, применимого к этой поездке.

Google Transit принимает следующие значения:

  • 0 . По умолчанию. Доступно только в том случае, если у агентства или маршрута включена глубокая ссылка для продажи билетов.
  • 1 . Недоступен.
translations.txt lang Код языка Необязательный

Расширение Google Transit.

Поле lang не является частью официальной GTFS, но Google Transit использует это значение, если оно присутствует.

Чтобы указать перевод фразы, используйте поле lang . Его значение не должно быть пустым или und (неопределенный язык).

translations.txt trans_id ИДЕНТИФИКАТОР Необязательный

Расширение Google Transit.

Поле trans_id не является частью официальной GTFS, но Google Transit использует это значение, если оно присутствует.

Чтобы указать идентификатор фразы, для которой предусмотрен перевод, используйте поле trans_id . Каждая строка таблицы translations.txt означает, что на языке lang фраза trans_id переводится как translation .

trips.txt original_trip_id ИДЕНТИФИКАТОР Необязательный

Расширение Google Transit.

Если оно присутствует в файле trips.txt , значение original_trip_id переопределяет значение trip_id для использования другими системами. Примером является сопоставление в реальном времени.

trips.txt trip_direction_name Текст Необязательный

Расширение Google Transit.

Поле trip_direction_name указывает пассажирам направление поездки. Значение в этом поле сохраняется как значение direction_name для каждой поездки.

Если значение stop_direction_name в таблице stop_times изменяется во время поездки, оно может переопределить значение trip_direction_name .

Значения в поле trip_direction_name нормализованы по регистру.

trips.txt vehicle_category_id ИДЕНТИФИКАТОР Необязательный

Расширение Google Transit.

В файле trips.txt поле vehicle_category_id идентифицирует транспортное средство, назначенное для этой поездки. Если это поле присутствует в файле trips.txt , его значение переопределяет значение vehicle_category_id в файле routes.txt .