Ten glosariusz zawiera definicje kluczowych terminów używanych w dokumentacji dotyczącej integracji z partnerem transportowym.
Token rezerwacji: opcjonalny ciąg znaków generowany przez partnera, który można przekazać w linku do strony z biletami, aby zachować spójność cen i planów podróży między wynikami wyszukiwania Google a stroną rezerwacji partnera.
Kanoniczne mapowanie JSON: określony zestaw reguł zdefiniowanych przez bufor protokołu na potrzeby konwertowania wiadomości proto na obiekt JSON. Ta integracja wymaga użycia tego mapowania z określonymi opcjami, aby żądania i odpowiedzi były prawidłowo sformatowane.
GTFS (General Transit Feed Specification): standardowy format danych, którego agencje transportu publicznego używają do przekazywania pasażerom informacji o rozkładach jazdy, trasach i cenach. W tej integracji jest to jeden z 2 sposobów przekazywania danych statycznych do Google.
Integracja oparta na GTFS: metoda integracji dla partnerów, którzy udostępniają Google własne dane o rozkładzie jazdy w formacie GTFS. Jest on używany, gdy Google nie ma jeszcze harmonogramów operatora.
known_itineraries: opcja w konfiguracji partnera, która umożliwia partnerom otrzymywanie od Google listy znanych tras, aby optymalizować odpowiedzi.
Zestaw rynków: (tylko w przypadku integracji typu „tylko przystanki”) opcjonalny plik danych dostarczany przez partnera, który zawiera listę par miejsc docelowych i początkowych (rynków), dla których partner będzie podawać ceny. Jeśli zostanie podana, będzie działać jako lista dozwolonych.
Partner API / Partner Server API: zestaw interfejsów API, które partnerzy muszą wdrożyć, aby dostarczać Google dynamiczne dane, takie jak ceny i dostępność w czasie rzeczywistym.
Testowanie jakości cen: ciągły proces, w którym roboty Google sprawdzają przykładowe plany podróży w witrynie partnera, aby upewnić się, że ceny wyświetlane użytkownikom są zgodne z cenami podanymi w interfejsie Partner API.
Zapytania na sekundę: średnia częstotliwość, z jaką Google wysyła żądania (jedno zapytanie to jedno żądanie) do serwera interfejsu API partnera. Może się ona wahać, a w niektórych okresach ruch może być nieco większy lub mniejszy.
SegmentKey: obiekt używany w interfejsie Partner API do jednoznacznego identyfikowania pojedynczego etapu podróży, w tym miejsca rozpoczęcia i zakończenia oraz dat i godzin usług.
service_date: konkretna data, w której działa usługa transportu publicznego, w formacie YYYYMMDD. Jest używany w połączeniu z innymi identyfikatorami do określania unikalnej instancji przejazdu.
Integracja tylko z przystankami: metoda integracji dla partnerów, którzy nie są źródłem danych o rozkładzie jazdy. Jest to używane, gdy Google otrzymuje już harmonogramy operatora z innego źródła. Partnerzy muszą tylko podać listę identyfikatorów przystanków.
ticketing_stop_id: niepowtarzalny identyfikator przystanku lub stacji przypisany przez partnera.
Ten identyfikator jest podawany w statycznym pliku danych (GTFS lub tylko przystanki) i jest używany w interfejsie Partner API oraz w precyzyjnych linkach do biletów.
ticketing_trip_id: (w przypadku integracji opartej na GTFS) Unikalny identyfikator partnera dla konkretnej podróży podany w pliku trips.txt w jego pliku danych GTFS. Tylko integracje oparte na GTFS.
Precyzyjny link do rezerwacji biletów: adres URL, który kieruje użytkownika z wyników wyszukiwania Google do witryny partnera, aby zarezerwować konkretną trasę. Adres URL zawiera zakodowane szczegóły wybranej podróży.
TripOptionsErrorType: określony zestaw typów błędów, które mogą być zwracane w interfejsie Partner API, aby dostarczać bardziej szczegółowe informacje o tym, dlaczego żądanie zakończyło się niepowodzeniem.
UNSPECIFIED Wartość typu enum: wymagana pierwsza wartość (o wartości liczbowej 0) w każdej definicji typu enum podczas korzystania z buforów protokołu. Jest to wartość domyślna i w przypadku otrzymania jej w żądaniu należy ją traktować jako błąd.