Riferimenti degli orari GTFS di Google Transit e differenze

In questa pagina vengono descritte le principali differenze tra la programmazione GTFS ufficiale e L'implementazione delle specifiche da parte di Google Transit nelle seguenti aree:

  • Specifiche ufficiali ignorate: questi campi fanno parte delle GTFS. Google Transit importa questi dati senza errori, ma non li utilizza in modo proattivo. i dati.

  • Interpretazione diversa:questi campi includono le parti della documentazione GTFS che Google Transit interpreta in modo diverso dalla definizione GTFS di quelle parti.

  • Supporto sperimentale:questi campi sono sperimentali nell'interfaccia di Google Transit implementazione. Se vuoi implementare un nuovo campo sperimentale, contatta il Il team di Google Transit.

  • Estensione supportata da Google Transit: questa estensione non fa parte della GTFS ufficiale. L'estensione supportata da Google Transit include entrambe le estensioni pubbliche e quelle specifiche per Google Transit. Qualsiasi partner può inviare queste informazioni a Trasporto pubblico nel loro feed.

Transito statico

Le seguenti sezioni documentano le principali differenze tra il feed GTFS ufficiale e l'implementazione del feed statico da parte di Google Transit.

Specifiche ufficiali ignorate nei feed statici

Alcune specifiche ufficiali che vengono ignorate da Google Transit sono sperimentali. A per saperne di più vai a gtfs.org.

La tabella 1 elenca i file GTFS non supportati da Transit nei feed statici. Inoltre, nessuno dei campi definiti in questi file è supportato Trasporto pubblico.

Tabella 1. File GTFS non supportati nei feed statici
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

La tabella 2 elenca tutti i campi definiti da GTFS che vengono ignorati da Transit nel feed statici.

Tabella 2. Campi GTFS ignorati nei feed statici
Nome file Campo ignorato definito in GTFS Tipo di campo
fare_attributes.txt payment_method Enum
feed_info.txt default_lang Codice lingua
feed_info.txt feed_publisher_name Testo
pathways.txt max_slope Float
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id ID
routes.txt route_desc Testo
routes.txt route_sort_order Numero intero non negativo
stops.txt level_id ID
stops.txt stop_desc Testo
stops.txt stop_url URL
stops.txt tts_stop_name Testo
trips.txt bikes_allowed Enum

Interpretazione diversa nei feed statici

Transit accetta alcuni campi definiti da GTFS, ma Transit li interpreta in modo diverso rispetto a GTFS.

La tabella 3 mostra i campi nei feed statici implementati in modo diverso da Transit rispetto a quello descritto nel GTFS.

Tabella 3. Campi del feed statico implementati in modo diverso
Nome file Campo definito in GTFS Tipo di campo Richiesto da Google Transit? Dettagli implementazione Google Transit
fare_attributes.txt transfers Enum Obbligatorio

Estensione Google Transit.

Il GTFS pubblico limita i valori a un intervallo da 0 a 2. Google Transit accetta valori da 0 a 5.

Utilizza questo campo per impostare il numero massimo di cambi consentiti con la tariffa. Non sono inclusi i cambi a blocchi, noti anche come cambi dal sedile trasferimenti. Se non vuoi impostare limiti al numero di trasferimenti per lascia il campo transfers vuoto.

pathways.txt pathway_mode Enum Facoltativo Quando il campo pathway_mode viene specificato, se viene lasciato vuoto, Google Transit lo accetta e lo considera sconosciuto.
stop_times.txt arrival_time Ora Obbligatorio in modo condizionale Le ore sono limitate ai valori compresi tra 00 e 99, che è più che sufficiente per viaggi di tre giorni.
transfers.txt transfer_type Enum Obbligatorio

I valori di 4 e 5 non sono supportati e vengono ignorati.

Google Transit supporta i valori 0, 1, 2 e 3.

trips.txt block_id ID Facoltativo Per scoprire di più, vedi Esempio di blocco del trasferimento.

Supporto sperimentale nei feed statici

Se hai bisogno di assistenza per integrare nuovi campi sperimentali in questa categoria, contatta Google Transit.

Estensioni supportate da Google Transit nei feed statici

La tabella 4 fornisce informazioni sulle estensioni di Google Transit. Questi campi non fanno parte del feed GTFS ufficiale.

Tabella 4. Estensioni dei feed statici supportate
Nome file Campo Tipo di campo Richiesto da Google Transit? Dettagli implementazione Google Transit
fare_attributes.txt ic_price Float Facoltativo

Questa estensione di Google Transit è disponibile solo per i partner in Japan.

Il campo ic_price rappresenta l'importo scontato di denaro da pagare per questa tariffa tramite una smart card. Se non sono presenti sconti fornita per questa tariffa o la smart card non è supportata, Il valore del campo ic_price deve essere -1.

fare_rules.txt contains_route_id ID Facoltativo

Estensione Google Transit.

Questa tariffa si applica solo ai viaggi che visitano un insieme esatto di percorsi identificato dal valore route_id in tutte le righe per questo una combinazione di fare_id, origin_id e destination_id colonne.

Se la colonna contains_route_id non è presente o tutte le relative colonne valori per questa tariffa sono null, la tariffa non è limitata in questo . Se il campo contains_route_id viene fornito per un , il campo route_id deve essere vuoto.

routes.txt checkin_duration Numero intero Facoltativo

Estensione Google Transit.

Il campo checkin_duration specifica il numero di secondi in anticipo si consiglia a un passeggero di arrivare prima della partenza prevista tra per fare il check-in e salire a bordo.

Se il passeggero si collega alla partenza tramite un cambio, qualsiasi il tempo di trasferimento definito sostituisce il valore checkin_duration.

Il valore checkin_duration è solo un consiglio solitamente forniti dall'operatore di trasporto pubblico. Potrebbe non riflettere il valore l'ultimo momento possibile in cui un passeggero può arrivare e salire a bordo veicolo.

routes.txt route_type Enum Obbligatorio

Estensione Google Transit.

Per scoprire in che modo Google Transit estende l'route_type accettato da GTFS le opzioni del valore, consulta Tipi di percorso GTFS estesi.

stop_times.txt stop_direction_name Testo Facoltativo

Estensione Google Transit.

Il campo stop_direction_name identifica un percorso per i passeggeri. La direzione viene archiviata come direction_name valore della partenza da questa fermata.

Se il campo stop_direction_name è vuoto, In alternativa, viene utilizzato il campo trip_direction_name supportato dal trasporto pubblico. Se trip_direction_name e stop_direction_name sono entrambi vuoti, dopodiché vengono lasciati vuoti da Transit Importer. Nel in questo caso, i partner possono utilizzare stop_headsign trip_headsign. I valori dell'attributo I campi stop_direction_name sono normalizzati in maiuscole e minuscole.

stops.txt signposted_as Testo Facoltativo

Estensione Google Transit.

Il campo signposted_as contiene il testo scritto sull'insegna della piattaforma. Esempi: "Verso il centro" e "Lato est e Brooklyn".

Il campo GTFS platform_code e le app supportate dal trasporto pubblico Il campo signposted_as può essere impostato contemporaneamente.

Differenze tra platform_code e I campi signposted_as includono i seguenti:

  • Lunghezza. In genere, il campo platform_code contiene un numero o una lettera come 2 o C.
  • Lingua. Il campo platform_code non contiene una lingua, ma i valori signposted_as possono avere delle traduzioni.
  • Stabilità. Il campo platform_code cambia molto meno spesso rispetto al campo signposted_as.
stops.txt vehicle_type Numero intero Facoltativo

Estensione Google Transit.

Il campo vehicle_type specifica il tipo di veicoli che in una fermata. Questo campo accetta il tipo di veicolo gerarchico (HVT) tipi di route. I valori HVT sono derivati dalla direttiva Standard Protocol Experts Group (TPEG).

agency.txt ticketing_deep_link_id ID Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Nel agency.txt, ticketing_deep_link_id rappresenta il link diretto utilizzato per inviare il biglietto delle corse di questo agenzia.

routes.txt ticketing_deep_link_id ID Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Nel routes.txt, ticketing_deep_link_id rappresenta il link diretto utilizzato per inviare il biglietto delle corse di questo percorso.

stop_times.txt ticketing_stop_time_id ID Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Se presente in stop_times.txt, ticketing_stop_time_id sostituisce l'identificatore che rappresenta l'ora di fine della vendita di ticket con link diretti.

stop_times.txt ticketing_type Enum Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Il campo ticketing_type specifica il tipo di vendita di biglietti applicabile a questo orario di interruzione.

Google Transit accetta i seguenti valori:

  • Empty. Valore predefinito, come definito dalla corsa.
  • 0. Disponibile solo se l'azienda di trasporto o il percorso ha un il link diretto per la vendita di biglietti abilitato.
  • 1. Non disponibile.
ticketing_deep_links.txt android_intent_uri URI Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Il campo android_intent_uri rappresenta l'URI dell'intent utilizzata per i link diretti su Android.

ticketing_deep_links.txt ios_universal_link_url URL Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Il campo ios_universal_link_url rappresenta l'universale URL del link utilizzato per i link diretti su iOS.

ticketing_deep_links.txt ticketing_deep_link_id ID Obbligatorio

Estensione per l'acquisto di biglietti di Google Transit.

Il campo ticketing_deep_link_id rappresenta l'identificatore del link diretto.

ticketing_deep_links.txt web_url URL Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Il campo web_url rappresenta l'URL utilizzato per i link diretti sul web.

ticketing_identifiers.txt agency_id ID Obbligatorio

Estensione per l'acquisto di biglietti di Google Transit.

Per specificare l'agenzia della fermata ticketing_stop_id predefinita , il campo agency_id contiene l'ID dal GTFS agency.txt.

ticketing_identifiers.txt stop_id ID Obbligatorio

Estensione per l'acquisto di biglietti di Google Transit.

Per specificare la fermata predefinita ticketing_stop_id viene definito, il campo stop_id contiene l'ID di il GTFS stops.txt.

ticketing_identifiers.txt ticketing_stop_id ID Obbligatorio

Estensione per l'acquisto di biglietti di Google Transit.

Il campo ticketing_stop_id contiene l'ID ticketing che viene applicato alla fermata. (Facoltativo) Un'agenzia qualifica l'ID.

trips.txt exceptional Enum Facoltativo

Questo campo indica le corse eccezionali. Operano al di fuori programma regolare o vengono dirottati rispetto al solito percorso a causa di speciali eventi o interruzioni pianificate (come il monitoraggio e così via).

Google accetta le seguenti opzioni di valore:

  • 0. Servizi regolari
  • 1. Eccezione di servizio. Ad esempio, servizi aggiunte a causa di eventi speciali o servizi allontanati da il solito percorso a causa di interruzioni pianificate.
trips.txt ticketing_trip_id ID Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

Se è presente il campo ticketing_trip_id, il relativo valore sostituisce il campo trip_id per identificare la corsa per la vendita di biglietti con link diretti.

trips.txt ticketing_type Enum Facoltativo

Estensione per l'acquisto di biglietti di Google Transit.

La ticketing_type specifica il tipo di vendita di biglietti applicabile alla corsa in questione.

Google Transit accetta i seguenti valori:

  • 0. Predefinita. Disponibile solo se l'azienda di trasporto o il percorso ha un il link diretto per la vendita di biglietti abilitato.
  • 1. Non disponibile.
translations.txt lang Codice della lingua Facoltativo

Estensione Google Transit.

Il campo lang non fa parte del file GTFS ufficiale, ma Google Il trasporto pubblico utilizza questo valore quando è presente.

Per specificare la traduzione di una frase, usa lang . Il relativo valore non deve essere vuoto o und (un lingua non definita).

translations.txt trans_id ID Facoltativo

Estensione Google Transit.

Il campo trans_id non fa parte del file GTFS ufficiale, ma Google Transit utilizza questo valore quando è presente.

specificare il token ID della frase fornita dalla traduzione. utilizza il campo trans_id. Ogni riga della tabella translations.txt indica che in la lingua lang, la frase trans_id si traduce in translation.

trips.txt original_trip_id ID Facoltativo

Estensione Google Transit.

Se è presente nel trips.txt, il valore original_trip_id sostituisce il valore trip_id per l'utilizzo da parte di altri sistemi. Un è la corrispondenza in tempo reale.

trips.txt trip_direction_name Testo Facoltativo

Estensione Google Transit.

Il campo trip_direction_name identifica un percorso per i passeggeri. Il valore in questo campo viene memorizzato come direction_name valore di ogni viaggio.

Se il valore stop_direction_name nella colonna stop_times modifiche alla tabella durante il viaggio, potrebbe sostituire il valore trip_direction_name valore.

I valori nel campo trip_direction_name sono minuscoli e minuscoli normalizzato.

trips.txt vehicle_category_id ID Facoltativo

Estensione Google Transit.

Nel trips.txt, vehicle_category_id identifica il veicolo assegnato a questa corsa. Quando questo è nel file trips.txt, il suo valore sostituisce il valore vehicle_category_id nel file routes.txt.