Questa pagina è stata tradotta dall'API Cloud Translation.

Riferimenti e differenze tra gli orari GTFS di Google Transit

Questa pagina descrive le principali differenze tra la pianificazione GTFS ufficiale e l'implementazione della specifica da parte di Google Transit nelle seguenti aree:

Specifiche ufficiali ignorate:questi campi fanno parte del GTFS ufficiale. Google Transit importa questi dati senza errori, ma non li utilizza in modo proattivo.
Interpretazione diversa: questi campi includono le parti del GTFS ufficiale che Google Transit interpreta in modo diverso rispetto alla definizione GTFS di queste parti.
Supporto sperimentale:questi campi sono sperimentali nell'implementazione di Google Transit. Se vuoi implementare un nuovo campo sperimentale, contatta il team di Google Transit.
Estensione supportata da Google Transit: questa estensione non fa parte del GTFS ufficiale. L'estensione supportata per i trasporti pubblici include sia le estensioni pubbliche sia quelle specifiche di Google Transit. Qualsiasi partner può inviare queste informazioni a Transit nel proprio feed.

Mezzi pubblici statici

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

Specifiche ufficiali ignorate nei feed statici

Alcune specifiche ufficiali ignorate da Transit sono sperimentali. Per scoprire di più, visita il sito gtfs.org.

Nella tabella 1 sono elencati i file GTFS non supportati da Transit nei feed statici. Inoltre, nessuno dei campi definiti in questi file è supportato da Transit.

**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 nei 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

Sebbene Transit accetti determinati campi definiti da GTFS, li interpreta diversamente da GTFS.

La tabella 3 mostra i campi nei feed statici che Transit implementa in modo diverso rispetto a quanto descritto nel GTFS.

**Tabella 3.** Campi del feed statico implementati in modo diverso
Nome file	Campo definito in GTFS	Tipo di campo	Obbligatorio per Google Transit?	Dettagli sull'implementazione di Google Transit
`fare_attributes.txt`	`transfers`	Enum	Obbligatorio	Estensione Google Transit. I valori GTFS pubblici sono limitati a un intervallo compreso tra `0` e `2`. Google Transit accetta valori da `0` a `5`. Utilizza questo campo per impostare il numero massimo di trasferimenti consentiti con la tariffa. Non sono inclusi i cambi a blocchi, noti anche come cambi da seduti. Se non vuoi impostare limiti al numero di trasferimenti per un valore, lascia vuoto il campo `transfers`.
`pathways.txt`	`pathway_mode`	Enum	Facoltativo	Quando il campo `pathway_mode` è specificato, se viene lasciato vuoto, Google Transit lo accetta e lo tratta come sconosciuto.
`stop_times.txt`	`arrival_time`	Ora	Obbligatorio condizionalmente	Le ore sono limitate ai valori da `00` a `99`, più che sufficienti per viaggi di tre giorni.
`transfers.txt`	`transfer_type`	Enum	Obbligatorio	I valori `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ù, consulta l'esempio di trasferimento a blocchi.

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 GTFS ufficiale.

**Tabella 4.** Estensioni dei feed statici supportate
Nome file	Campo	Tipo di campo	Obbligatorio per Google Transit?	Dettagli sull'implementazione di Google Transit
`fare_attributes.txt`	`ic_price`	Float	Facoltativo	Questa estensione di Google Transit è disponibile solo per i partner in Giappone. Il campo `ic_price` rappresenta l'importo scontato da pagare per questa tariffa con una smart card. Se non vengono previsti sconti per questa tariffa o se 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 identificati dal valore `route_id` in tutte le righe per questa combinazione di colonne `fare_id`, `origin_id` e `destination_id`. Se la colonna `contains_route_id` non è presente o se tutti i suoi valori per questa tariffa sono null, la tariffa non è limitata in questo parametro. Se per una tariffa viene specificato il campo `contains_route_id`, il campo `route_id` deve essere vuoto.
`routes.txt`	`checkin_duration`	Numero intero	Facoltativo	Estensione Google Transit. Il campo `checkin_duration` specifica quanti secondi prima della partenza programmata è consigliabile che un passeggero arrivi per effettuare il check-in e salire a bordo. Se il passeggero si collega alla partenza con un trasferimento, qualsiasi tempo di trasferimento definito sostituisce il valore `checkin_duration`. Il valore `checkin_duration` è solo un consiglio che viene solitamente fornito dall'operatore di trasporto pubblico. Potrebbe non riflettere l'ultimo momento possibile in cui un passeggero può arrivare e salire sul veicolo.
`routes.txt`	`route_type`	Enum	Obbligatorio	Estensione Google Transit. Per scoprire in che modo Google Transit estende le opzioni di valore `route_type` accettate da GTFS, consulta Tipi di percorso GTFS estesi.
`stop_times.txt`	`stop_direction_name`	Testo	Facoltativo	Estensione Google Transit. Il campo `stop_direction_name` identifica la direzione di un viaggio per i passeggeri. La direzione viene memorizzata come valore `direction_name` della partenza da questa fermata. Se il campo `stop_direction_name` è vuoto, viene utilizzato il campo Supportato dai trasporti pubblici `trip_direction_name`. Se i campi `trip_direction_name` e `stop_direction_name` sono entrambi vuoti, l'importatore dei dati sui trasporti li lascia vuoti. In questo caso, i partner possono utilizzare il valore `stop_headsign` o `trip_headsign`. I valori del campo `stop_direction_name` sono normalizzati alle maiuscole.
`stops.txt`	`signposted_as`	Testo	Facoltativo	Estensione Google Transit. Il campo `signposted_as` contiene il testo esatto scritto sulla segnaletica della piattaforma. Alcuni esempi sono "Verso il centro" e "East Side e Brooklyn". È possibile impostare contemporaneamente il campo GTFS `platform_code` e il campo supportato dal trasporto pubblico`signposted_as`. Le differenze tra i campi `platform_code` e `signposted_as` includono quanto segue: Lunghezza. In genere, il campo `platform_code` contiene un numero o una lettera, ad esempio 2 o C. Lingua. Il campo `platform_code` non ha una lingua, ma i valori `signposted_as` possono avere traduzioni. Stabilità. Il campo `platform_code` cambia molto meno spesso del campo `signposted_as`.
`stops.txt`	`vehicle_type`	Numero intero	Facoltativo	Estensione Google Transit. Il campo `vehicle_type` specifica il tipo di veicoli utilizzati in una fermata. Questo campo accetta tipi di percorsi di tipo HVT (tipo di veicolo gerarchico). I valori HVT sono ricavati dallo standard TPEG (European Transport Protocol Experts Group).
`agency.txt`	`ticketing_deep_link_id`	ID	Facoltativo	Estensione per l'acquisto di biglietti di Google Transit. Nel file `agency.txt`, il campo `ticketing_deep_link_id` rappresenta il link diretto utilizzato per acquistare i biglietti per le corse di questa azienda.
`routes.txt`	`ticketing_deep_link_id`	ID	Facoltativo	Estensione per l'acquisto di biglietti di Google Transit. Nel file `routes.txt`, il campo `ticketing_deep_link_id` rappresenta il link diretto utilizzato per emettere i biglietti per le corse di questo percorso.
`stop_times.txt`	`ticketing_stop_time_id`	ID	Facoltativo	Estensione per l'acquisto di biglietti di Google Transit. Se presente nel file `stop_times.txt`, il campo `ticketing_stop_time_id` sostituisce l'identificatore che rappresenta l'ora di interruzione per l'acquisto di biglietti 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 biglietto applicabile a questo orario di fermata. Google Transit accetta i seguenti valori: `Empty`. Predefinito: come definito dalla corsa. `0`. Disponibile solo se l'azienda o il percorso ha un link diretto per l'acquisto 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 utilizzato 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'URL del link universale 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'azienda della fermata per la quale è definito il campo `ticketing_stop_id` predefinito, il campo `agency_id` contiene l'ID del file GTFS `agency.txt`.
`ticketing_identifiers.txt`	`stop_id`	ID	Obbligatorio	Estensione per l'acquisto di biglietti di Google Transit. Per specificare la fermata per la quale è definito il campo `ticketing_stop_id` predefinito, il campo `stop_id` contiene l'ID del file 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 biglietto applicato alla fermata. Facoltativamente, un'agenzia convalida l'ID.
`trips.txt`	`exceptional`	Enum	Facoltativo	Questo campo indica i viaggi eccezionali. Operano al di fuori del programma regolare o vengono deviati dal percorso abituale a causa di eventi speciali o interruzioni pianificate (ad es. lavori sulla linea, ecc.). Google accetta le seguenti opzioni di valore: `0`. Servizi regolari `1`. Eccezione di servizio. Ad esempio, servizi aggiunti a causa di eventi speciali o servizi dirottati dal percorso abituale a causa di interruzioni pianificate.
`trips.txt`	`ticketing_trip_id`	ID	Facoltativo	Estensione per l'acquisto di biglietti di Google Transit. Se il campo `ticketing_trip_id` è presente, il relativo valore override il campo `trip_id` per identificare la corsa per l'acquisto di biglietti con link diretti.
`trips.txt`	`ticketing_type`	Enum	Facoltativo	Estensione per l'acquisto di biglietti di Google Transit. Il campo `ticketing_type` specifica il tipo di biglietto applicabile a questo viaggio. Google Transit accetta i seguenti valori: `0`. Valore predefinito. Disponibile solo se l'azienda o la linea ha un link diretto per l'acquisto di biglietti abilitato. `1`. Non disponibile.
`translations.txt`	`lang`	Codice della lingua	Facoltativo	Estensione Google Transit. Il campo `lang` non fa parte del GTFS ufficiale, ma Google Transit utilizza questo valore se è presente. Per specificare la traduzione di una frase, utilizza il campo `lang`. Il relativo valore non deve essere vuoto o `und` (una lingua non definita).
`translations.txt`	`trans_id`	ID	Facoltativo	Estensione Google Transit. Il campo `trans_id` non fa parte del GTFS ufficiale, ma Google Transit utilizza questo valore se è presente. Per specificare il token ID della frase per la quale viene fornita la traduzione, utilizza il campo `trans_id`. Ogni riga della tabella `translations.txt` indica che nella lingua `lang` la frase `trans_id` viene tradotta in `translation`.
`trips.txt`	`original_trip_id`	ID	Facoltativo	Estensione Google Transit. Se è presente nel file `trips.txt`, il valore `original_trip_id` sostituisce il valore `trip_id` per l'utilizzo da parte di altri sistemi. Un esempio è la corrispondenza in tempo reale.
`trips.txt`	`trip_direction_name`	Testo	Facoltativo	Estensione Google Transit. Il campo `trip_direction_name` identifica la direzione di un viaggio per i passeggeri. Il valore in questo campo viene memorizzato come valore `direction_name` di ogni viaggio. Se il valore `stop_direction_name` nella tabella `stop_times` cambia durante il viaggio, potrebbe sostituire il valore `trip_direction_name`. I valori nel campo `trip_direction_name` sono normalizzati alle lettere maiuscole.
`trips.txt`	`vehicle_category_id`	ID	Facoltativo	Estensione Google Transit. Nel file `trips.txt`, il campo `vehicle_category_id` identifica il veicolo assegnato a questo viaggio. Quando questo campo si trova nel file `trips.txt`, il relativo valore sostituisce il valore `vehicle_category_id` nel file `routes.txt`.