Przegląd
Jeśli nie jesteś dostawcą plików danych GTFS dla Map Google, integracja jest tylko do zatrzymywania. W przypadku tej integracji musimy wiedzieć, jak identyfikujesz różne przystanki kolejowe lub autobusowe.
Ogólne specyfikacje pliku danych
Podczas inicjowania integracji tworzymy dla każdej integracji unikalny identyfikator, na przykład ch_google_test (kod kraju, nazwa partnera, integracja) lub eu_google (kod regionu, nazwa partnera).
Partnerzy mogą przesłać plik ZIP zawierający pliki tekstowe w formacie CSV, które są stosowane globalnie lub w ramach integracji:
Przykład 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Przykład 2:
- stops.txt (stosowany do wszystkich integracji)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Specyfikacja pliku danych o przerwaniu dostawy (wymagane)
Plik stop powinien zawierać te kolumny:
| Nazwa pola | Typ (patrz GTFS) | Opis |
|---|---|---|
stop_id |
Identyfikator (wymagany) | Unikalny identyfikator przystanku lub stacji. Większe stacje powinny zawierać tylko 1 pozycję. Jest on używany podczas wywoływania interfejsu Partner Server API i w precyzyjnych linkach do biletów. |
stop_name |
Tekst (wymagane) | Możliwa do odczytania przez człowieka nazwa danych służących do debugowania mapowania punktów zatrzymania, wypełniania pamięci podręcznej i sprawdzania zgodności cen. |
stop_lat |
Szerokość geograficzna (wymagana) | Szerokość geograficzna przystanku. |
stop_lon |
Długość geograficzna (wymagana) | Długość geograficzna przystanku. |
Użyjemy automatycznego procesu przetwarzania, w którym partnerzy mogą stale przesyłać zaktualizowane pliki ZIP, gdy zmienią się informacje w tych plikach. Na przykład partner może zwiększyć liczbę dostępnych zasobów reklamowych, poszerzając listę przystanków. Jednak podobnie jak w przypadku GTFS, identyfikatory przystanków powinny być stabilne.
Specyfikacja pliku danych o zestawach rynków (opcjonalnie)
Na podstawie zmapowanych przystanków generujemy zestaw rynków dla tej integracji (listę zawierającą popularne pary miejsc pochodzenia i miejsc docelowych). Możesz wtedy zmniejszyć ten zestaw rynków, przesyłając plik danych z ustawionymi rynkami.
Zestaw rynków działa jak lista dozwolonych: jeśli nie podasz zestawu rynków, wszystkie rynki zostaną włączone w ramach integracji. Jeśli podany jest zestaw rynków, wszystkie rynki, które nie znajdują się na liście, są wyłączone.
Plik z zestawem rynków powinien zawierać te kolumny:
| Nazwa pola | Typ (patrz GTFS) | Opis |
|---|---|---|
origin_stop_id |
Identyfikator (wymagany) | Kraj stop_id, w którym znajduje się rynek. |
destination_stop_id |
Identyfikator (wymagany) | Docelowy rynek stop_id. |
Konfiguracja partnera
Jeśli korzystasz z integracji tylko w celu zatrzymywania, potrzebujemy dodatkowych informacji dotyczących konfiguracji statycznej partnera, jak opisano w sekcji Konfiguracja partnera.
Precyzyjne linki do sprzedaży biletów
Format i parametry precyzyjnego linku są zdefiniowane w linkach do sprzedaży biletów.
Parametry Partner API
Parametry SegmentKeys w interfejsie Partner API (GetBulkTripOptionsRequest) są oparte na specyfikacji precyzyjnych linków. Używamy SegmentKeys, w tym tylko from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time i arrival_time, pozostawiając ticketing_trip_id pusty. Określimy w pełni trasę, w tym wszystkie przesiadnięcia, podając wiele kluczy segmentu, po jednym na każdy segment.