Estensioni per l'acquisto di biglietti di Google Transit

Questa pagina definisce un sottoinsieme delle specifiche per la vendita di biglietti GTFS, che si trova nella fase di proposta durante la creazione di questo documento. Questa pagina include anche diverse limitazioni aggiuntive da in tutti i canali Google.

Requisiti

Il campo departure_time in stop_times.txt è obbligatorio.

Tipi di campi aggiuntivi

Questa sezione illustra i tipi di campi aggiuntivi e quelli con estensioni di Google. Alcune richiedono valori sotto forma di URI.

• URI: un URI (Uniform Resource Identifier) completo che include lo schema. Qualsiasi i caratteri speciali dell'URI devono utilizzare i caratteri di escape corretti. Per una descrizione di come creare valori URI completi, consulta l'articolo URI (Uniform Resource Identifier) RFC 3986: sintassi generica.

Estensioni o aggiunte di file

I file di testo con stato Estensione sono file già esistenti che devono essere estendere. Devi aggiungere i nuovi campi definiti nella tabella seguente.

I file di testo con lo stato Addition sono nuovi file introdotti da Google Transit Estensioni per l'acquisto di biglietti. Devi creare questi file nel rispetto della Definizioni dei campi riportate dopo la tabella seguente. Assicurati di includi questi file nel tuo feed.

Nome file	Stato	Definisce
agency.txt	Estensione	Aggiunge agency.ticketing_deep_link_id.
routes.txt	Estensione	Aggiunge routes.ticketing_deep_link_id.
trips.txt	Estensione	Aggiunge trips.ticketing_trip_id e trips.ticketing_type.
stop_times.txt	Estensione	Aggiunge stop_times.ticketing_type.
ticketing_identifiers.txt	Aggiunta	Nuovo file. Per ulteriori dettagli, consulta Definizioni dei campi.
ticketing_deep_links.txt	Aggiunta	Nuovo file. Per ulteriori dettagli, consulta Definizioni dei campi.

Definizioni dei campi

agency.txt (file esteso)

Nome campo	Presenza	Dettagli
ticketing_deep_link_id	Facoltativo	(ID da ticketing_deep_links.txt) Definisce il link diretto da utilizzare agenzia. Può essere sovrascritto in routes.txt. Nota: per applicare la vendita di biglietti all'intero feed statico, imposta lo stesso valore nel campo ticketing_deep_link_id per tutte le agenzie del agency.txt.

routes.txt (file esteso)

Nome campo	Presenza	Dettagli
ticketing_deep_link_id	Facoltativo	(ID da ticketing_deep_links.txt) Definisce il link diretto da utilizzare percorso. Se presente, sovrascrive il campo in agency.txt.

trips.txt (file esteso)

Nome campo	Presenza	Dettagli
ticketing_trip_id	Facoltativo	(ID) Identificatore da trasmettere nel link diretto. Non deve essere necessariamente univoco. Se ticketing_trip_id è vuoto, il sistema utilizza il valore di trip_id in alternativa.
ticketing_type	Facoltativo	(Enum) Definisci se la vendita di biglietti tramite un link diretto è disponibile per questa corsa: 0 o vuoto: Se definisci un ticketing_deep_link_id per il percorso o l'agenzia, questo è disponibili. Non disponibile negli altri casi. 1: non disponibile.

stop_times.txt (file esteso)

Nome campo	Presenza	Dettagli
ticketing_type	Facoltativo	(Enum) Definisce se la vendita di biglietti tramite un link diretto è disponibile per questo momento di fermata. Se tu definisci stop_times.ticketing_type, sostituisce il valore impostato in trip.ticketing_type. Vuoto: utilizza il valore indicato in trip.ticketing_type. 0: Se definisci un ticketing_deep_link_id per il percorso o l'agenzia, questo è disponibili. Non disponibile negli altri casi. 1: non disponibile. di Gemini Advanced. Importante: per un determinato stop_id, se uno dei suoi stop_times ha ticketing_type=1, poi tutti gli altri stop_times deve anche avere ticketing_type=1.

ticketing_identifiers.txt (file aggiunto)

Il caso più comune per la vendita di biglietti è che ogni fermata è dotata di un identificatore per elaborare la fatturazione. Aziende diverse possono utilizzare lo stesso identificatore per ogni fermata. Quando più agenzie operano la stessa fermata, ripeti questa mappatura per ogni agenzia.

Nome campo	Presenza	Dettagli
ticketing_stop_id	Obbligatorio	(ID) Definisce un ID per l'acquisto di biglietti predefinito per questa fermata dell'azienda di trasporto.
stop_id	Obbligatorio	(ID da stops.txt) La fermata per cui il valore predefinito ticketing_stop_id definito.
agency_id	Obbligatorio	(ID da agency.txt) L'agenzia della fermata per la quale viene utilizzato il valore predefinito ticketing_stop_id definito.

ticketing_deep_links.txt (file aggiunto)

Nome campo	Presenza	Dettagli
ticketing_deep_link_id	Obbligatorio	(ID) Definisce un ID per il link diretto.
web_url	Facoltativo	(URL) L'URL da visitare per i link diretti. Questo campo non è traducibile tramite translations.txt. Importante: la traduzione URL non è supportata pertanto il rilevamento della lingua deve essere effettuato dal sito web o dall'app ricevente.
android_intent_uri	Facoltativo	(URI) L'URI da passare a un'app Android nativa con un Intenzione android.intent.action.VIEW. Se è vuoto, significa che non è possibile aggiungere un link diretto a un'app Android nativa. Importante: la traduzione URL non è supportata pertanto il rilevamento della lingua deve essere effettuato dal sito web o dall'app ricevente. Per ulteriori informazioni sui link diretti su Android, consulta l'articolo Creare link diretti a dell'app. Consiglio: utilizza i link per app Android, che sono entrambi più sicuri e avere un comportamento di riserva migliore quando il passeggero non ha l'app Android nativa sul loro dispositivo. Questo campo non è traducibile tramite translations.txt.
ios_universal_link_url	Facoltativo	(URL) L'URL del link universale da richiamare su iOS. Importante: la traduzione URL non è supportata pertanto il rilevamento della lingua deve essere effettuato dal sito web o dall'app ricevente. Se vuoto, i link diretti non vengono visualizzati su iOS. Per ulteriori informazioni, consulta la sezione sui link universali su iOS. Questo campo non è traducibile tramite translations.txt.

Nota: quando più aziende o percorsi condividono gli stessi URL di link diretti in feed, consigliamo vivamente di definire un solo link diretto e di collegarli tutti tramite agenzie o percorsi verso lo stesso link diretto. Per ulteriori informazioni, consulta Sezione Pratiche consigliate.

Segnaposto di campi nella chiamata API

Google chiama gli URL definiti in ticketing_deep_links.txt con quanto segue parametri:

Nome campo	Dettagli
service_date	(Data, ripetibile) Giorno di servizio della corsa. Utilizza questo campo per la data di partenza della corsa dalla prima fermata. Il formato di questo campo è un array JSON.
ticketing_trip_id	(ID da trips.txt, ripetibile) Identificatore della corsa. Il formato di questo campo è un array JSON.
from_ticketing_stop_time_id	(Ripetibile) Identificatore del stop_time in cui inizia la gamba. Per un determinato momento di interruzione, il valore è il seguente: Il valore ticketing_stop_id definito in ticketing_identifiers.txt per i agency_id e i stop_id dei stop_time. Importante: questa funzionalità utilizza solo ticketing_identifiers per la fermata stessa. Anche se la fermata ha un genitore interrompere, ignoriamo l'elemento ticketing_identifiers della fermata principale. In caso contrario, utilizza il metodo stop_sequence. Il formato di questo campo è un array JSON.
to_ticketing_stop_time_id	(Ripetibile) Identificatore del stop_time in cui termina la gamba. Per una spiegazione sulla derivazione del valore, consulta from_ticketing_stop_time_id. Il formato di questo campo è un array JSON.
boarding_time	(ISO 8601, ripetibile) Ora di partenza, departure_time, del stop_time nel punto in cui inizia la gamba. Utilizza questo campo per indicare la data e l'ora effettive in cui il passeggero sale a bordo del veicolo. Il valore dell'ora di questo campo è conforme a ISO 8601 con il seguente formato di stringa: YYYY-MM-DDThh:mm:ss±hh:mm Gli orari indicati di seguito sono uguali, ma in fusi orari diversi: A Londra, Regno Unito: 2019-07-29T18:26:00+01:00 A NYC, USA-NY: 2019-07-29T13:26:00-04:00 A Tokyo in Giappone: 2019-07-30T02:26:00+09:00 di Gemini Advanced. Importante: il fuso orario non è necessariamente lo stesso fuso orario dell'agenzia nel feed. Il fuso orario è nel fuso orario UTC. Il formato di questo campo è un array JSON.
arrival_time	(ISO 8601, ripetibile) Ora di arrivo, arrive_time allo stop_time a cui la tappa termina il video. Il valore dell'ora di questo campo è conforme a ISO 8601 con il seguente formato di stringa: YYYY-MM-DDThh:mm:ss±,hh:mm Gli orari indicati di seguito sono uguali, ma in fusi orari diversi: A Londra, UK: 2019-07-29T18:46:00+01:00 A NYC, USA-NY: 2019-07-29T13:46:00-04:00 A Tokyo, JP: 2019-07-30T02:46:00+09:00 di Gemini Advanced. Importante: il fuso orario non corrisponde necessariamente allo stesso fuso orario dell'agenzia del feed. Il fuso orario è nel fuso orario UTC. Il formato di questo campo è un array JSON.

Esempi

In questo esempio, le tappe del percorso di un passeggero sono le seguenti:

• Il giorno del servizio 20190716, l'ID biglietteria della corsa ti1 inizia dalla fermata ID ticketing a tempo 11 per interrompere l'ID richiesta di chiamata 12. Il passeggero parte alle 14:00 UTC e arriva alle 14:50 UTC.
• Il giorno del servizio 20190716, l'ID biglietteria della corsa ti2 inizia dalla fermata ID ticketing a tempo 21 per interrompere l'ID richiesta di chiamata 22. Il passeggero parte alle 15:00 UTC e arriva alle 15:50 UTC.

Per questo esempio, il valore web_url è https://examplepetstore.com.

Con tutte queste informazioni, utilizza i seguenti valori per i parametri del feed per questo percorso:

Nome campo	Dettagli
service_date	["20190716", "20190716"]
ticketing_trip_id	["ti1", "ti2"]
from_ticketing_stop_time_id	["11", "21"]
to_ticketing_stop_time_id	["12", "22"]
boarding_time	["2019-07-16T14:00:00+00:00", "2019-07-16T15:00:00+00:00"]
arrival_time	["2019-07-16T14:50:00+00:00", "2019-07-16T15:50:00+00:00"]

Di seguito è riportato l'URI finale dopo la codifica:

https://examplepetstore.com?service_date=%5B%2220190716%22,%2220190716%22%5D &ticketing_trip_id=%5B%22ti1%22,%22ti2%22%5D&from_ticketing_stop_time_id=%5B%2211%22,%2221%22%5D &to_ticketing_stop_time_id=%5B%2212%22,%2222%22%5D&boarding_time=%5B%222019-07-16T14:00:00%2B00:00 %22,%222019-07-16T15:00:00%2B00:00%22%5D&arrival_time=%5B%222019-07-16T14:50:00%2B00:00 %22,%222019-07-16T15:50:00%2B00:00%22%5D

Esempi di diverse ticketing_stop_id valori

Le fermate possono avere ID diversi per la vendita di biglietti con campo ticketing_identifiers.txt. I valori in grassetto sono quelli trovati nella chiamata web descritti dopo i file.

stop.txt
stop_id, stop_name si1,"Parigi Gare-de-Lyon" si2,"Lione Part-Dieu"

routes.txt
route_id,route_long_name,ticketing_deep_link_id ri1,"TGV inOui Parigi-Lione",tdl1

trips.txt
trip_id,service_id,route_id,trip_short_name, ticketing_trip_id ti1,everyday,ri1,"TGV INOUI 6603",FR_SNCF_6603 ti2,ogni giorno,ri1,"TGV INOUI 6681",FR_SNCF_6681 ti3,ogni giorno,ri1,"TGV INOUI 6607",FR_SNCF_6607

stop_times.txt
trip_id,stop_sequence,stop_id,arrival_time, departure_time ti1,1,si1,06:59:00,06:59:00 ti1,2,si2,08:56:00,08:56:00 ti2,1,si1,07:53:00,07:53:00 ti2,2,si2,10:00:00,10:00:00 ti3,1,si1,08:59:00,08:59:00 ti3,2,si2,10:56:00,10:56:00

ticketing_identifiers.txt
stop_id,agency_id,ticketing_stop_id si1,agenzia1,4924 si2,agenzia1,4676

ticketing_deep_links.txt
ticketing_deep_link_id, web_url, android_intent_uri ios_universal_link_url tdl1, https://examplepetstore.com/api/gtfs/web, https://examplepetstore.com/api/gtfs/android, https://examplepetstore.com/api/gtfs/ios

Se la richiesta viene effettuata il 19-07-2019 e gli orari GTFS sono espressi nel fuso orario UTC+1, allora questa è la chiamata per il web:

https://examplepetstore.com/api/gtfs/web?service_date=%5B%2220190719%22%5D&ticketing_trip_id= %5B%22FR_SNCF_6603%22%5D&from_ticketing_stop_time_id=%5B%224924%22%5D&to_ticketing_stop_time_id= %5B%224676%22%5D&boarding_time=%5B%222019-07-19T05:59:00%2B00:00%22%5&arrival_time=%5B%222019-07-19T07:56:00%2B00:00%22%5D

Importante: tieni presente che i valori all'interno di boarding_time e arrival_time, che sono in UTC, non seguono necessariamente il fuso orario in GTFS (UTC+1), che causa una variazione del valore HH:MM:SS.

Pratiche consigliate

Segui questi consigli per implementare le estensioni per l'acquisto di biglietti di Google Transit:

Linee guida
Se possibile, condividi link diretti tra aziende o percorsi.	Nel feed statico, ogni volta che più aziende o percorsi hanno gli stessi URL di link diretti, e devono condividere un singolo valore per il campo ticketing_deep_link_id. Questo consente i trasferimenti tra aziende o percorsi. Nota: in caso contrario, i passeggeri devono acquistare due biglietti separati a causa valori diversi in ticketing_deep_link_id.
Imposta valori coerenti per ticketing_type.	Il valore ticketing_type per una determinata fermata deve essere coerente in tutte le righe nel file stop_times.txt. Nota: un valore ticketing_type di 1 disattiva la vendita dei biglietti per tutte le corse che utilizzano quella fermata.
Mappa ticketing_stop_id per le fermate principali e secondarie.	Esegui la mappatura per tutte le fermate principali e secondarie che richiedono la vendita dei biglietti. Nella ticketing_identifiers.txt, i valori ticketing_stop_id non si propagano tra una fermata padre e le relative interruzioni secondarie.
Mappa ticketing_stop_id per ogni azienda che utilizza la stessa fermata nel feed.	Nel feed statico, se più aziende che abilitano l'acquisto di biglietti condividono la stessa fermata, la mappatura deve essere presente per ciascuna delle agenzie. Per ulteriori dettagli, consulta la sezione Definizioni dei campi per ticketing_identifiers.txt.
Utilizza Link per app Android quando è necessario un link diretto a un'app Android.	Se il partner vuole aprire un'app per Android da un link diretto, imposta il link diretto come un link per app Android. Nota: se il partner vuole aprire solo un sito web mobile, usano direttamente l'URL del sito web.
Utilizza i link universali di iOS quando è necessario un link diretto a un'app per iOS.	Se il partner vuole aprire un'app per iOS da un link diretto, imposta quest'ultimo come Link universale per iOS.