GTFS (General Transit Feed Specification) è un formato esistente per i programmi di trasporto pubblico e le informazioni geografiche associate. L'integrazione basata su GTFS utilizza le estensioni GTFS e di Google Transit Ticketing per completare il passaggio 1 dell'integrazione di Travel Transport, fornendo un feed di dati statici.
L'API Partner Server utilizzerà identificatori, come ticketing_trip_id,
forniti da GTFS, pertanto è necessario che esista un feed GTFS valido prima di poter utilizzare l'API.
Segui questi passaggi per fornire un feed GTFS valido.
Creazione del feed statico GTFS
Per consentire agli utenti di cercare e trovare percorsi e orari per i viaggi intercity utilizzando l'integrazione basata su GTFS, i partner richiedono un feed GTFS. I dati del feed GTFS conterranno informazioni statiche su orari, percorsi e informazioni su vendita di biglietti che verranno poi utilizzate da Google per collegarsi all'API partner.
1. Creazione di un account Transit
Se non l'hai già fatto, vai alla Guida introduttiva a Google Transit e utilizza il modulo per richiedere un account. Una volta completata la revisione, verrà creato un account e la dashboard GTFS sarà disponibile. Consulta Accedere alla Dashboard Partner di Google Transit per i dettagli su come accedere alla dashboard e configurarla.
2. Creazione del feed GTFS con le estensioni
Crea il feed GTFS, incluse le sezioni obbligatorie delle estensioni per l'acquisto di biglietti di Google Transit (maggiori dettagli nella sezione delle estensioni GTFS). Per garantire la migliore esperienza utente, leggi e segui i requisiti di qualità e le best practice GTFS.
3. Assegnare un nome al 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 è richiesta, ad esempio
gbus-br. Per i feed di prova, la convenzione di denominazione dei feed consigliata è:
test-agency-country_code, ad esempio test-gbus-ca-us o test-gbus-br.
4. Caricamento e aggiornamento del feed
Segui la guida relativa alla pubblicazione dei dati del feed GTFS per caricare e aggiornare i dati GTFS. Ogni volta che vengono caricati, i dati vengono sottoposti a convalida automatica (che richiede fino a 30 minuti) e viene generato un report di convalida. Correggi eventuali errori prima di andare al passaggio successivo.
5. Richiedi ambiente di anteprima
Una volta che i dati GTFS superano la convalida, segui le istruzioni su Testare i dati del feed utilizzando un'anteprima privata per attivare l'ambiente di anteprima. Una volta attivati, i dati del feed caricato saranno visibili in Google Maps degli utenti autorizzati. A questo punto, i dati GTFS possono essere usati anche per i test con il server API.
6. Richiesta di revisione QA di avvio
Una volta risolti gli eventuali avvisi problematici e i problemi relativi alla qualità dei dati nell'ambiente di anteprima, è necessaria una revisione finale del QA di Google prima del lancio pubblico. I problemi rilevati tramite la procedura di revisione del QA saranno visibili nella dashboard. Una volta risolti tutti i problemi in sospeso, GTFS sarà pronto per il lancio.
7. Lancio del feed
Consulta Lancia il feed per istruzioni su come renderlo disponibile pubblicamente.