Обзор
Если вы не являетесь поставщиком каналов GTFS для Google Maps, ваша интеграция — Stop-only . Для этой интеграции нам нужно понять, как вы идентифицируете различные остановки поездов или автобусов.
Общие характеристики корма
При запуске интеграции мы создаем уникальный идентификатор для каждой интеграции, например: ch_google_test (код страны, имя партнера, интеграция) или eu_google (код региона, имя партнера).
Партнеры могут предоставить zip-файл, содержащий текстовые файлы в формате CSV, которые применяются глобально или для каждой интеграции:
Пример 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Пример 2:
- stops.txt (применяется ко всем интеграциям)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Спецификация остановки подачи (обязательно)
Файл остановки должен содержать следующие столбцы:
| Имя поля | Тип (см. 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 конечного пункта рынка. |
Конфигурация партнера
При использовании интеграции «только остановка» нам требуется дополнительная информация для статической конфигурации партнера, как описано в разделе «Конфигурация партнера» .
Билеты Deep Links
Формат и параметры глубокой ссылки определены в разделе «Ссылки для билетов».
Параметры API партнера
Параметры SegmentKeys для API партнера ( GetBulkTripOptionsRequest ) основаны на спецификации deep link. Мы используем SegmentKeys , включая только from_ticketing_stop_time_id , to_ticketing_stop_time_id , service_date , boarding_time и arrival_time , оставляя ticketing_trip_id пустым. Мы полностью укажем маршрут, включая все пересадки, указав несколько SegmentKeys, по одному на сегмент.