Обзор
Если вы не являетесь поставщиком GTFS-каналов для Google Карт, ваша интеграция предназначена только для остановок . Для этой интеграции нам необходимо понять, как вы определяете различные остановки поездов или автобусов.
Общие характеристики кормов
При запуске интеграции мы создаем уникальный идентификатор для каждой интеграции, например: ch_google_test (код страны, название партнера, интеграция) или eu_google (код региона, название партнера).
Партнеры предоставляют файл, содержащий текстовые файлы в формате CSV, которые применяются для каждой интеграции. Каждый CSV-файл должен содержать строку заголовка с названиями столбцов, соответствующими названию поля, указанному в соответствующей таблице спецификаций фида.
Чтобы партнеры могли загружать новые версии файлов остановок и рынков, наша команда предоставит данные Dropbox SFTP — по одному для каждого типа файла в процессе регистрации.
Спецификация остановки подачи (обязательно)
Файл остановок должен содержать следующие столбцы:
| Имя поля | Тип (см. GTFS ) | Описание |
|---|---|---|
stop_id | Идентификатор (обязательно) | Уникальный идентификатор остановки или станции. Для более крупных станций следует использовать только одну запись. Он используется при вызовах API вашего партнерского сервера и в глубинных ссылках на билеты. |
stop_name | Текст (обязательно) | Удобочитаемое имя для отладки отображения остановок, заполнения кэша и данных о точности цен. |
stop_lat | Широта (обязательно) | Широта остановки. |
stop_lon | Долгота (обязательно) | Долгота остановки. |
Мы будем использовать автоматизированный процесс загрузки, благодаря которому партнёры смогут постоянно предоставлять обновлённые ZIP-файлы по мере изменения содержащейся в них информации. Например, партнёр может расширить предоставляемый инвентарь, дополнив список остановок. Однако, как и в GTFS, идентификаторы остановок должны быть стабильными.
Спецификация набора рыночных фидов (необязательно)
На основе сопоставленных остановок мы формируем набор рынков для этой интеграции (список популярных пар «отправитель/направитель»). Далее вы можете сократить этот набор рынков, предоставив фид набора рынков.
Набор рынков служит списком разрешенных рынков для нашей службы заполнения кэша. По умолчанию, если набор рынков не указан, включены все рынки. Если вы предоставите набор рынков, запросы будут выполняться только по рынкам, включенным в список. Если пользователи будут запрашивать рынки, не входящие в этот список разрешенных, наши системы все равно отправят актуальный запрос для конкретного рынка и запрошенной даты, но мы не будем пытаться проактивно кэшировать его.
Файл набора рынка должен содержать следующие столбцы:
| Имя поля | Тип (см. 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, по одному на сегмент.