В этом руководстве объясняется, как интегрироваться с Google, чтобы предоставить пользователям удобный поиск транспорта на различных платформах Google, включая Google Карты и Google Поиск. Основные требования к интеграции включают:
- Два варианта предоставления статических данных:
- Интеграция на основе GTFS : предоставление GTFS-фида с расширениями для продажи билетов в случаях, когда вы являетесь поставщиком данных о расписании. Для интеграции на основе GTFS существуют дополнительные требования .
- Интеграция только с остановками : предоставление только списка остановок для случаев, когда у Google уже есть данные о расписании из другого источника.
- Спецификация API партнера для предоставления динамических данных:
- Конфигурация партнера : предоставление информации о партнере, такой как брендинг и контактные данные.
- Партнерский сервер : Реализация серверов, поддерживающих API-интерфейсы партнерского сервера .
Шаги по интеграции с Travel Transport
Ниже представлен обзор шагов, необходимых для создания и тестирования комплексной системы поддержки транспортных функций Google. Интеграция включает три основных этапа:
- Рассмотрение требований к участию .
- Предоставление потока статических данных в Google.
- Поддержка API Travel Transport для динамических запросов к быстро меняющимся данным, таким как цены и наличие мест. API использует идентификаторы, предоставленные статическим потоком данных из шага 1, например,
ticketing_stop_id, для определения остановок.
1. Требования к участию
В блоке транспортных функций Google отображаются маршруты и варианты бронирования с указанием цен. Для отображения вашего предложения в списке требуется качественная ссылка и соответствующая окончательная цена. Подробнее см. в наших требованиях к участию .
2. Предоставление потока статических данных
Существует два варианта предоставления статических данных, каждый из которых применим в конкретных обстоятельствах. Главный критерий выбора варианта — являетесь ли вы поставщиком данных о расписании рейсов для тех транспортных маршрутов, для которых вы хотите предложить функцию бронирования. Самый простой способ проверить, есть ли у Google данные о расписании, — попробовать найти маршруты конкретного оператора на Google Картах.
| Особенность | Интеграция на основе GTFS | Интеграция только для остановки |
|---|---|---|
| Вариант использования | Вы уже предоставляете GTFS расписания и информацию о билетах. | У Google уже есть данные о расписании этого оператора из другого источника. |
| Необходимые данные | Идентификаторы GTFS. | Список идентификаторов ваших остановок с их географическими координатами. |
| Усилие | Низкий | Середина |
Вариант 1 применяется, если вы являетесь поставщиком GTFS-фида для оператора. В этом случае вам также необходимо сначала настроить GTFS-фид для предоставления информации о расписании в Google. Затем следуйте инструкциям в разделе «Интеграция на основе GTFS» .
Вариант 2 применяется, если Google уже получает данные о расписании для оператора из другого источника. В этом случае нам не нужна полная информация о расписании, но нам всё равно нужен список идентификаторов ваших остановок, который мы можем использовать в API Travel Transport (см. ниже). Чтобы предоставить список остановок, следуйте инструкциям в разделе «Интеграция только с остановками» .
3. Поддержка API Travel Transport
Чтобы быть представленным в качестве партнера по бронированию с ценами в разделе «Транспорт», Google необходимо иметь возможность получать от партнеров актуальную информацию о ценах и наличии мест. Для этого партнеры должны предоставлять сервис, реализующий API партнерского сервера.
3.1. Реализация API партнерского сервера
Подробную информацию о реализации API сервера партнёров можно найти в справочнике API и руководстве по серверу партнёров . API позволяет Google получать от партнёров самую актуальную информацию о ценах и наличии товаров и услуг. Google будет использовать его для:
- Создайте кэш для быстрого возврата цен.
- Получайте актуальную информацию о ценах, когда пользователь выбирает определенный маршрут.
Реализация API партнерского сервера необходима, если партнер хочет, чтобы цены отображались Google.
3.2. Проверка и тестирование API
Как только реализация вашего API будет близка к завершению, а реализующая его служба будет запущена и начнет работать, отправьте нам по адресу transport-help@google.com информацию о сервере, чтобы мы могли начать проверку вашей реализации.
В будущем мы планируем предложить автоматизированный инструментарий для проверки реализации вашего API, но пока он недоступен.