Обзор
Если вы не являетесь поставщиком GTFS-каналов для Google Maps, ваша интеграция предназначена только для остановок . Для этой интеграции нам необходимо понять, как вы определяете различные остановки поездов или автобусов.
Общие характеристики корма
При запуске интеграции мы создаём уникальный идентификатор для каждой интеграции, например: ch_google_test (код страны, название партнёра, интеграция) или eu_google (код региона, название партнёра).
Партнеры предоставляют файл, содержащий текстовые файлы в формате CSV, которые применяются для каждой интеграции. Каждый CSV-файл должен содержать строку заголовка с именами столбцов, соответствующими "Имени поля", указанному в соответствующей таблице спецификации потока данных.
Чтобы партнеры могли загружать новые версии файлов с информацией о стопах и рынках, наша команда предоставит ссылки на Dropbox-серверы SFTP (по одной для каждого типа файлов) в процессе подключения.
Спецификация остановки подачи (обязательно)
Файл остановки должен содержать следующие столбцы:
| Название поля | Тип (см. GTFS ) | Описание |
|---|---|---|
stop_id | Идентификационный номер (обязательно) | Уникальный идентификатор, определяющий остановку или станцию. Более крупные станции должны содержать только одну запись. Он используется при вызовах к API вашего партнерского сервера и в прямых ссылках системы продажи билетов. |
stop_name | Текст (обязательно) | Удобочитаемое имя для отладки данных о сопоставлении остановок, заполнении кэша и точности цен. |
stop_lat | Широта (обязательно) | Широта остановки. |
stop_lon | Долгота (обязательно) | Долгота остановки. |
Мы будем использовать автоматизированный процесс загрузки данных, в рамках которого партнеры смогут постоянно предоставлять обновленные ZIP-файлы при изменении содержащейся в них информации. Например, партнер может расширить предоставленный список остановок. Однако, как и в GTFS, stop_ids должны оставаться стабильными.
Спецификация корма, устанавливаемая на рынке (опционально)
Используя отмеченные остановки, мы генерируем набор рынков для этой интеграции (список популярных пар пункт отправления/назначения). Далее у вас есть возможность сократить этот набор рынков, предоставив собственный набор рынков.
Набор рынков служит списком разрешенных рынков для нашей службы заполнения кэша. По умолчанию, если набор рынков не указан, включены все рынки. Если вы укажете набор рынков, будут выполняться запросы только к рынкам, включенным в список. Если пользователи запрашивают рынки, не входящие в этот список, наши системы все равно отправят запрос в режиме реального времени для конкретного запрошенного рынка и даты, но мы не будем пытаться заблаговременно кэшировать его.
Файл с данными о рынке должен содержать следующие столбцы:
| Название поля | Тип (см. GTFS ) | Описание |
|---|---|---|
origin_stop_id | Идентификационный номер (обязательно) | Идентификатор остановки рынка stop_id ). |
destination_stop_id | Идентификационный номер (обязательно) | Идентификатор stop_id назначения рынка. |
Конфигурация партнера
При использовании интеграции только для остановки нам требуется дополнительная информация для статической конфигурации партнера, как описано в разделе «Конфигурация партнера» .
Спецификация реферальных ссылок
Формат и параметры ссылки для бронирования (также называемой Ticketing link ) определены в разделе «Ссылки для покупки билетов».
Параметры API партнера
Параметры SegmentKeys для партнерского API ( GetBulkTripOptionsRequest ) основаны на спецификации глубоких ссылок. Мы используем SegmentKeys, включающие только from_ticketing_stop_time_id , to_ticketing_stop_time_id , service_date , boarding_time и arrival_time , оставляя ticketing_trip_id пустым. Мы полностью укажем маршрут, включая все пересадки, указав несколько SegmentKeys, по одному на каждый сегмент.