Z tego przewodnika dowiesz się, jak zintegrować swoje usługi z Google, aby zapewnić użytkownikom bezproblemowe wyszukiwanie transportu na różnych platformach Google, w tym w Mapach Google i wyszukiwarce Google. Główne specyfikacje integracji to:
- Dostępne są 2 opcje przekazywania danych statycznych:
- Integracja oparta na GTFS: udostępnianie pliku danych GTFS z rozszerzeniami dotyczącymi biletów w przypadkach, gdy jesteś dostawcą danych o harmonogramie. W przypadku integracji opartej na GTFS mamy dodatkowe wymagania.
- Integracja typu „tylko przystanki”: podawanie tylko listy przystanków w przypadku, gdy Google ma już dane o rozkładzie jazdy z innego źródła.
- Specyfikacja interfejsu Partner API do przekazywania dynamicznych danych:
- Konfiguracja partnera: podawanie informacji o partnerze, takich jak elementy marki i dane kontaktowe.
- Serwer partnera: serwery implementujące interfejsy API serwera partnera.
Kroki integracji z usługą Travel Transport
Poniżej znajdziesz omówienie czynności, które musisz wykonać, aby utworzyć i przetestować kompleksowy system obsługujący funkcje transportowe Google. Integracja obejmuje 3 główne kroki:
- Sprawdź wymagania dotyczące udziału.
- przekazywanie do Google pliku danych statycznych;
- Obsługa interfejsu Travel Transport API, który umożliwia dynamiczne wysyłanie zapytań o szybko zmieniające się dane, takie jak ceny i dostępność. Interfejs API korzysta z identyfikatorów podanych w statycznym pliku danych z kroku 1, np.
ticketing_stop_id, aby identyfikować przystanki.
1. Wymagania dotyczące uczestnictwa
Jednostka funkcji transportowych Google wyświetla plany podróży i opcje rezerwacji z cenami. Aby oferta wyświetlała się na liście, wymagany jest link dobrej jakości i pasująca cena końcowa. Więcej informacji znajdziesz w wymaganiach dotyczących udziału.
2. Przesyłanie pliku danych statycznych
Dane statyczne możesz przekazywać na 2 sposoby, z których każdy ma zastosowanie w określonych okolicznościach. Głównym kryterium wyboru opcji jest to, czy jesteś dostawcą danych o rozkładzie jazdy dla połączeń transportu publicznego, w przypadku których chcesz oferować funkcję rezerwacji. Najprostszym sposobem sprawdzenia, czy Google ma już dane o rozkładzie jazdy, jest wyszukanie połączeń konkretnego przewoźnika w Mapach Google.
| Funkcja | Integracja oparta na GTFS | Integracja tylko z funkcją zatrzymania |
|---|---|---|
| Przypadek użycia | Udostępniasz już GTFS z rozkładami jazdy i informacjami o biletach. | Google ma już dane o rozkładzie jazdy tego operatora z innego źródła. |
| Wymagane dane | Identyfikatory GTFS. | Lista identyfikatorów przystanków wraz z ich współrzędnymi geograficznymi. |
| Wysiłek | Niski | Średni |
Opcja 1 dotyczy sytuacji, w której jesteś dostawcą pliku GTFS dla operatora. W tym przypadku musisz też najpierw skonfigurować plik danych GTFS, aby dostarczać Google informacje o rozkładzie jazdy. Następnie postępuj zgodnie z instrukcjami w sekcji dotyczącej integracji opartej na GTFS.
Opcja 2 ma zastosowanie, jeśli Google otrzymuje już dane o rozkładzie jazdy od operatora z innego źródła. W takim przypadku nie potrzebujemy pełnego harmonogramu, ale nadal potrzebujemy listy identyfikatorów przystanków, których możemy używać w interfejsie Travel Transport API (patrz poniżej). Aby podać listę przystanków, postępuj zgodnie z instrukcjami w sekcji dotyczącej integracji tylko przystanków.
3. Obsługa interfejsu Travel Transport API
Aby być wymienionym jako partner rezerwacji z cenami w sekcji Transport, Google musi mieć możliwość pobierania od partnerów najnowszych informacji o cenach i dostępności. Aby to umożliwić, partnerzy muszą udostępnić usługę, która implementuje interfejsy Partner Server API.
3.1. Wdrażanie interfejsu Partner Server API
Szczegółowe informacje o wdrażaniu interfejsu Partner Server API znajdziesz w dokumentacji interfejsu API i w przewodniku po serwerze partnera. Interfejs API umożliwia Google uzyskiwanie od partnerów najbardziej aktualnych informacji o cenach i dostępności. Google będzie go używać do:
- Generowanie pamięci podręcznej, aby szybko zwracać ceny.
- Pobieranie najnowszych cen, gdy użytkownik wyszukuje trasę w określonym dniu, która w naszej pamięci podręcznej wyświetla plany podróży bez ceny.
Wdrożenie interfejsu Partner Server API jest wymagane, jeśli partner chce, aby ceny były wyświetlane przez Google.
3.2. Weryfikacja i testowanie interfejsu API
Gdy implementacja interfejsu API będzie prawie ukończona, a usługa, która go wdraża, będzie działać, wyślij e-maila na adres transport-help@google.com z informacjami o serwerze, abyśmy mogli rozpocząć weryfikację Twojej implementacji.
W przyszłości planujemy udostępnić automatyczne narzędzia do weryfikacji implementacji interfejsu API, ale nie są one jeszcze dostępne.