В этом глоссарии определяются основные термины, используемые в документации по интеграции транспортных партнеров.
Токен бронирования: необязательная строка, сгенерированная партнером, которая может быть передана в глубинной ссылке на билеты, чтобы обеспечить согласованность цен и маршрутов между результатами поиска Google и страницей бронирования партнера.
Каноническое сопоставление JSON: определённый набор правил, определяемых Protocol Buffers для преобразования сообщения Proto в объект JSON. Эта интеграция требует использования сопоставления с определёнными параметрами для корректного форматирования запросов и ответов.
GTFS (General Transit Feed Specification): стандартный формат данных, используемый транспортными компаниями для предоставления пассажирам информации о расписании, маршруте и стоимости проезда. В рамках данной интеграции это один из двух способов предоставления статических данных Google.
Интеграция на основе GTFS: метод интеграции для партнёров, предоставляющих Google данные о расписании рейсов в виде фида GTFS. Используется, когда у Google ещё нет расписаний оператора.
known_itineraries : опция в конфигурации партнера, которая позволяет партнерам получать список известных маршрутов от Google для оптимизации своего ответа.
Market Set: (для интеграции только Stop-only) необязательный фид, предоставляемый партнёром для определения списка пар «отправитель-назначение» (рынков), для которых он будет предоставлять цены. Если он указан, он действует как разрешённый список.
API партнера / API сервера партнера: набор API, которые партнеры должны реализовать для предоставления Google динамических данных, таких как цены и доступность в режиме реального времени.
Тестирование качества цен: непрерывный процесс, в ходе которого поисковые роботы Google проверяют маршруты на веб-сайте партнера, чтобы убедиться, что цены, отображаемые пользователям, соответствуют ценам, предоставляемым через API партнера.
QPS (запросов в секунду): средняя скорость отправки запросов Google (один запрос — это один запрос) на сервер API партнёра. Эта скорость может колебаться, с периодами небольшого роста или снижения трафика.
SegmentKey: объект, используемый в API партнера для уникальной идентификации отдельного этапа поездки, включая пункт отправления, пункт назначения, а также дату/время обслуживания.
service_date : конкретная дата начала работы общественного транспорта в формате YYYYMMDD . Используется в сочетании с другими идентификаторами для указания уникального случая поездки.
Интеграция только с остановками: метод интеграции для партнёров, которые не являются источником данных о расписании. Используется, когда Google уже получает расписания оператора из другого источника. Партнёрам достаточно предоставить только список идентификаторов своих остановок.
ticketing_stop_id : уникальный идентификатор остановки или станции партнёра. Этот идентификатор предоставляется в статическом фиде данных (GTFS или только для остановок) и используется в API партнёра и глубинных ссылках на билеты.
ticketing_trip_id : (для интеграции на основе GTFS) уникальный идентификатор партнера для конкретной поездки, указанный в файле trips.txt его фида GTFS. Только для интеграции на основе GTFS.
Глубокая ссылка на покупку билетов: URL-адрес, который перенаправляет пользователя из результатов поиска Google на сайт партнёра для бронирования определённого маршрута. URL-адрес содержит закодированную информацию о выбранном маршруте.
TripOptionsErrorType : определенный набор типов ошибок, которые могут быть возвращены в API партнера для предоставления более подробной информации о причине сбоя запроса.
UNSPECIFIED значение перечисления: обязательное первое значение (с числовым значением 0) в любом определении перечисления при использовании буферов протокола. Оно служит значением по умолчанию и, как правило, должно рассматриваться как ошибка при получении в запросе.