Questo glossario definisce i termini chiave utilizzati nella documentazione relativa all'integrazione dei partner di trasporto.
Token di prenotazione:una stringa facoltativa generata dal partner che può essere trasmessa nel link diretto di emissione dei biglietti per contribuire a mantenere la coerenza di prezzo e itinerario tra i risultati di ricerca di Google e la pagina di prenotazione del partner.
Mapping JSON canonico:un insieme specifico di regole definite da Protocol Buffers per convertire un messaggio proto in un oggetto JSON. Questa integrazione richiede l'utilizzo di questo mapping con opzioni specifiche in modo che le richieste e le risposte siano formattate correttamente.
GTFS (General Transit Feed Specification): un formato di dati standard che le aziende di trasporto pubblico utilizzano per fornire informazioni su orari, percorsi e tariffe ai passeggeri. In questa integrazione, è uno dei due modi per fornire dati statici a Google.
Integrazione basata su GTFS:un metodo di integrazione per i partner che forniscono a Google i propri dati sugli orari in un feed GTFS. Viene utilizzato quando Google non dispone già degli orari dell'operatore.
known_itineraries: un'opzione nella configurazione del partner che consente ai partner di ricevere un elenco di itinerari noti da Google per ottimizzare la risposta.
Set di mercati: (per l'integrazione solo con Stop) un feed facoltativo fornito dal partner per definire un elenco specifico di coppie origine-destinazione (mercati) per le quali fornirà i prezzi. Se fornito, funge da lista consentita.
API partner / API server partner:il set di API che i partner devono implementare per fornire a Google dati dinamici, come prezzi e disponibilità in tempo reale.
Test di qualità del prezzo:il processo continuo in cui i crawler di Google campionano gli itinerari sul sito web del partner per verificare che i prezzi mostrati agli utenti corrispondano a quelli forniti tramite l'API Partner.
QPS (query al secondo): la velocità media con cui Google invia richieste (una query è una richiesta) al server API Partner. Questo tasso può variare, con periodi di traffico leggermente superiore o inferiore.
SegmentKey: un oggetto utilizzato nell'API Partner per identificare in modo univoco una singola tratta di un viaggio, inclusi origine, destinazione e date/orari del servizio.
service_date: la data specifica in cui opera un servizio di trasporto pubblico,
formattata come YYYYMMDD. Viene utilizzato in combinazione con altri identificatori per
specificare un'istanza di viaggio univoca.
Integrazione solo interruzione:un metodo di integrazione per i partner che non sono l'origine dei dati del programma. Viene utilizzato quando Google riceve già gli orari dell'operatore da un'altra fonte. I partner devono fornire solo un elenco dei propri ID fermata.
ticketing_stop_id: l'identificatore univoco del partner per una fermata o una stazione.
Questo ID viene fornito nel feed di dati statici (GTFS o solo fermate) e viene
utilizzato nell'API Partner e nei deep link per l'emissione di biglietti.
ticketing_trip_id: (per l'integrazione basata su GTFS) L'identificatore univoco del partner per una corsa specifica, fornito nel file trips.txt del feed GTFS. Solo integrazioni basate su GTFS.
Link diretto per l'emissione di biglietti:un URL che indirizza un utente dai risultati di ricerca di Google al sito web del partner per prenotare un itinerario specifico. L'URL contiene dettagli codificati sul viaggio selezionato.
TripOptionsErrorType: un insieme specifico di tipi di errore che possono essere restituiti
nell'API Partner per fornire informazioni più dettagliate sul motivo per cui una richiesta
non è andata a buon fine.
UNSPECIFIED Valore enum: il primo valore obbligatorio (con un valore numerico di
0) in qualsiasi definizione enum quando si utilizzano Protocol Buffer. Funge da valore
predefinito e in genere deve essere trattato come un errore se ricevuto in una richiesta.