La specifica GTFS (General Transit Feed Specification) è un formato esistente per gli orari dei trasporti pubblici e le informazioni geografiche associate. L'integrazione basata su GTFS utilizza GTFS e le estensioni per l'acquisto di biglietti di Google Transit per completare il passaggio 1 dell'integrazione di Travel Transport, ovvero fornire un feed di dati statici.
L'API Partner Server utilizzerà identificatori come ticketing_trip_id forniti da GTFS, quindi prima di poter utilizzare l'API è necessario che esista un feed GTFS valido.
Segui i passaggi riportati di seguito per fornire un feed GTFS valido.
Creare il feed statico GTFS
Per consentire agli utenti di cercare e trovare percorsi e orari per i viaggi interurbani utilizzando l'integrazione basata su GTFS, i partner devono fornire un feed GTFS. I dati del feed GTFS conterranno informazioni statiche su orari, percorsi e informazioni sull'acquisto di biglietti, che verranno poi utilizzate da Google per connettersi all' API partner.
1. Creare un account Transit
Se non l'hai ancora fatto, vai alla pagina Inizia a utilizzare Google Transit e utilizza il modulo per richiedere un account. Una volta completata la revisione, verrà creato un account e sarà disponibile la dashboard GTFS. Per informazioni dettagliate su come accedere e configurare la dashboard, consulta l'articolo Accedere alla Dashboard Partner di Google Transit.
2. Creare il feed GTFS con le estensioni
Crea il feed GTFS includendo le sezioni richieste delle estensioni per l'acquisto di biglietti di Google Transit (per maggiori dettagli, consulta la sezione Estensioni GTFS). Per garantire la migliore esperienza utente, leggi e segui i requisiti di qualità e le best practice per GTFS.
3. Denominare il feed
La convenzione di denominazione dei feed consigliata è: agency-region-country_code, ad esempio gbus-ca-us o agency-country_code se la regione non è obbligatoria, ad esempio gbus-br. Per i feed di test, la convenzione di denominazione dei feed consigliata è: test-agency-country_code, ad esempio test-gbus-ca-us o test-gbus-br.
4. Caricare e aggiornare il feed
Segui la guida Pubblicare i dati del feed GTFS per caricare e aggiornare i dati GTFS. Ogni volta che i dati vengono caricati, i dati vengono sottoposti a una convalida automatica (che richiede fino a 30 minuti) e viene generato un report di convalida. Correggi eventuali errori prima di passare al passaggio successivo.
5. Richiedere l'ambiente di anteprima
Una volta che i dati GTFS hanno superato la convalida, segui le istruzioni riportate in Eseguire il test dei dati del feed mediante un'anteprima privata per attivare l'ambiente di anteprima. Una volta attivati, i dati del feed caricati saranno visibili in Google Maps per gli utenti autorizzati. A questo punto, i dati GTFS possono essere utilizzati anche per i test con il server API.
6. Richiedere la revisione di controllo qualità per il lancio
Una volta risolti gli avvisi problematici e i problemi di qualità dei dati nell'ambiente di anteprima, è necessaria una revisione finale di controllo qualità di Google prima del lancio pubblico. I problemi rilevati durante la revisione di controllo qualità saranno visibili nella dashboard. Una volta risolti tutti i problemi in sospeso, GTFS sarà pronto per il lancio.
7. Lanciare il feed
Per istruzioni su come rendere il feed disponibile al pubblico, consulta l'articolo Lanciare il feed.