Questa guida spiega come eseguire l'integrazione con Google per offrire agli utenti un'esperienza di ricerca dei trasporti fluida su varie piattaforme Google, tra cui Google Maps e la Ricerca Google. A livello generale, le principali specifiche di integrazione includono:
- Due opzioni per fornire dati statici:
- Integrazione basata su GTFS: fornire un feed GTFS con estensioni per l'acquisto di biglietti, per i casi in cui sei il fornitore dei dati sugli orari. Abbiamo alcuni requisiti aggiuntivi per l'integrazione basata su GTFS.
- Integrazione solo fermate: fornisce solo un elenco di fermate, per i casi in cui Google dispone già dei dati degli orari da un'altra fonte.
- Una specifica dell'API partner per fornire dati dinamici:
- Configurazione del partner: fornisci informazioni sul partner, come il branding e i dati di contatto.
- Server partner: implementazione di server che supportano le API Partner Server.
Passaggi per l'integrazione con Travel Transport
Di seguito è riportata una panoramica dei passaggi necessari per creare e testare un sistema end-to-end per supportare le funzionalità di trasporto di Google. L'integrazione prevede tre passaggi principali:
- Esaminando i requisiti di partecipazione.
- Fornire un feed di dati statici a Google.
- Supporto dell'API Travel Transport per abilitare query dinamiche di
dati in rapida evoluzione come prezzi e disponibilità. L'API utilizza
gli identificatori forniti dal feed di dati statici del passaggio 1, ad esempio
ticketing_stop_id, per identificare le fermate.
1. Requisiti di partecipazione
L'unità delle funzionalità per i trasporti di Google mostra itinerari e opzioni di prenotazione con prezzi. Per visualizzare la tua offerta nell'elenco, sono necessari un link di buona qualità e un prezzo finale corrispondente. Per maggiori dettagli, consulta i nostri requisiti di partecipazione.
2. Fornire un feed di dati statici
Esistono due opzioni per fornire dati statici, ognuna applicabile in circostanze specifiche. Il criterio principale per decidere quale opzione utilizzare è se sei il fornitore dei dati sugli orari per le coincidenze di transito per cui vuoi offrire la funzionalità di prenotazione. Il modo più semplice per verificare se Google dispone già dei dati sugli orari è provare a trovare collegamenti per un operatore specifico su Google Maps.
| Funzionalità | Integrazione basata su GTFS | Integrazione solo con stop |
|---|---|---|
| Caso d'uso | Fornisci già GTFS con informazioni su orari e biglietti. | Google dispone già dei dati sugli orari dell'operatore provenienti da un'altra fonte. |
| Dati richiesti | Gli ID GTFS. | Un elenco degli ID fermata, con le relative coordinate geografiche. |
| Impegno | Bassa | Media |
L'opzione 1 si applica se sei il fornitore del feed GTFS per un operatore. In questo caso, devi anche configurare un feed GTFS per fornire prima a Google le informazioni sull'orario. Poi, segui le istruzioni riportate nella sezione Integrazione basata su GTFS.
L'opzione 2 si applica se Google riceve già i dati sugli orari dell'operatore da un'altra origine. In questo caso, non abbiamo bisogno delle informazioni complete sull'orario, ma abbiamo comunque bisogno di un elenco degli ID delle tue fermate che possiamo utilizzare nell'API Travel Transport (vedi sotto). Per fornire l'elenco delle fermate, segui le istruzioni nella sezione Integrazione solo fermate.
3. Supporto dell'API Travel Transport
Per essere elencato come partner di prenotazione con prezzi nell'unità di trasporto, Google deve essere in grado di recuperare le informazioni più recenti su prezzi e disponibilità dai partner. Per abilitare questa funzionalità, i partner devono fornire un servizio che implementi le API Partner Server.
3.1. Implementazione dell'API Partner Server
I dettagli su come implementare l'API Partner Server sono disponibili nella Guida di riferimento API e nella Guida di Partner Server. L'API consente a Google di ottenere le informazioni più aggiornate su prezzi e disponibilità dai partner e verrà chiamata da Google per:
- Genera una cache per restituire rapidamente i prezzi.
- Visualizza i prezzi più recenti quando un utente fa clic su un itinerario specifico.
L'implementazione dell'API Partner Server è obbligatoria se il partner vuole che i prezzi vengano visualizzati da Google.
3.2. Test e convalida delle API
Una volta che l'implementazione dell'API è quasi completata e il servizio che la implementa è attivo e funzionante, contatta transport-help@google.com con le informazioni del server per consentirci di iniziare a convalidare l'implementazione.
In futuro, prevediamo di offrire strumenti automatizzati per la convalida dell'implementazione dell'API, ma non sono ancora disponibili.