Questa pagina è stata tradotta dall'API Cloud Translation.

Riferimenti degli orari GTFS di Google Transit e differenze

Questa pagina descrive le principali differenze tra l'implementazione ufficiale della specifica GTFS 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 quelle 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 da Transit include estensioni pubbliche ed estensioni specifiche per Google Transit. Tutti i partner possono inviare queste informazioni a Transit nel proprio feed.

Trasporto pubblico statico

Le seguenti sezioni descrivono le principali differenze tra l'implementazione del feed statico di GTFS ufficiale e quella di Google Transit.

Specifiche ufficiali ignorate nei feed statici

Alcune specifiche ufficiali che vengono ignorate da Transit sono sperimentali. Per ulteriori informazioni, 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 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 nel 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`	In virgola mobile
`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
`stops.txt`	`bikes_allowed`	Enum

Interpretazione diversa nei feed statici

Sebbene Transit accetti alcuni campi definiti da GTFS, Transit li interpreta in modo diverso rispetto a GTFS.

La Tabella 3 mostra i campi dei feed statici che Google Transit implementa in modo diverso rispetto a quanto descritto in GTFS.

**Tabella 3.** Campi del feed statico implementati in modo diverso
Nome file	Campo definito nel GTFS	Tipo di campo	Richiesto da Google Transit?	Dettagli sull'implementazione di Google Transit
`fare_attributes.txt`	`transfers`	Enum	Obbligatorie	Estensione di 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 trasbordi consentiti con la tariffa. Non sono inclusi i trasferimenti a blocchi, noti anche come trasferimenti all'interno della utenza. Se non vuoi impostare limiti al numero di trasferimenti per una tariffa, lascia vuoto il campo `transfers`.
`pathways.txt`	`pathway_mode`	Enum	Facoltativo	Una volta specificato il campo `pathway_mode`, se viene lasciato vuoto, Google Transit lo accetta e lo considera sconosciuto.
`stop_times.txt`	`arrival_time`	Ora	Obbligatoria condizionalmente	Gli orari sono limitati ai valori da `00` a `99`, che sono più che sufficienti per le corse di tre giorni.
`transfers.txt`	`transfer_type`	Enum	Obbligatorie	I valori di `4` e `5` non sono supportati e vengono ignorati. Google Transit supporta valori di `0`, `1`, `2` e `3`.
`trips.txt`	`block_id`	ID	Facoltativo	Per scoprire di più, vedi Esempio di trasferimento con blocco.

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	Richiesto da Google Transit?	Dettagli sull'implementazione di Google Transit
`fare_attributes.txt`	`ic_price`	In virgola mobile	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 sono 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 di 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 delle colonne `fare_id`, `origin_id` e `destination_id`. Se la colonna `contains_route_id` non è presente o tutti i valori per questa tariffa sono nulli, la tariffa non è limitata in questo parametro. Se il campo `contains_route_id` viene fornito per una tariffa, il campo `route_id` deve essere vuoto.
`routes.txt`	`checkin_duration`	Numero intero	Facoltativo	Estensione di Google Transit. Il campo `checkin_duration` specifica il numero di secondi di anticipo di un passeggero che deve arrivare prima della partenza programmata per fare il check-in e salire a bordo. Se il passeggero si collega alla partenza tramite un cambio, il tempo di cambio definito sostituisce il valore `checkin_duration`. Il valore `checkin_duration` è solo un suggerimento generalmente fornito dall'operatore di trasporto pubblico. Potrebbe non riflettere l'ultimo momento possibile in cui un passeggero può arrivare e salire a bordo del veicolo.
`routes.txt`	`route_type`	Enum	Obbligatorie	Estensione di Google Transit. Per scoprire in che modo Google Transit estende le opzioni per i valori `route_type` accettate da GTFS, consulta la sezione Tipi di percorso GTFS esteso.
`stop_times.txt`	`stop_direction_name`	Testo	Facoltativo	Estensione di Google Transit. Il campo `stop_direction_name` identifica la direzione di una corsa verso 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 `trip_direction_name` supportato dal trasporto pubblico. Se i campi `trip_direction_name` e `stop_direction_name` sono entrambi vuoti, l'importatore per il trasporto pubblico li lascia vuoti. In questo caso, i partner possono utilizzare invece il valore `stop_headsign` o `trip_headsign`. I valori del campo `stop_direction_name` sono normalizzati tra maiuscole e minuscole.
`stops.txt`	`signposted_as`	Testo	Facoltativo	Estensione di Google Transit. Il campo `signposted_as` contiene il testo letterale scritto sull'insegna della piattaforma. Alcuni esempi sono "Towards Central" e "East Side & Brooklyn". I campi GTFS `platform_code` e `signposted_as` supportati da Transit possono essere impostati contemporaneamente. Le differenze tra i campi `platform_code` e `signposted_as` includono: Lunghezza. Il campo `platform_code` di solito 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 traduzioni. Stabilità. Il campo `platform_code` cambia con una frequenza molto minore rispetto al campo `signposted_as`.
`stops.txt`	`vehicle_type`	Numero intero	Facoltativo	Estensione di Google Transit. Il campo `vehicle_type` specifica il tipo di veicoli utilizzati in una fermata. Questo campo accetta i tipi di percorso gerarchico di veicoli (HVT). I valori HVT sono derivati 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 acquistare 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 fine della vendita di biglietti con i 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 dei biglietti applicabile a questo orario di fermata. Google Transit accetta i seguenti valori: `Empty`. Valore predefinito, come definito dalla corsa. `0`. Disponibile solo se l'azienda o il percorso dispone di un link diretto per l'acquisto di biglietti attivato. `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 di 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	Obbligatorie	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	Obbligatorie	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	Obbligatorie	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	Obbligatorie	Estensione per l'acquisto di biglietti di Google Transit. Il campo `ticketing_stop_id` contiene l'ID per l'acquisto di biglietti applicato alla fermata. Facoltativamente, un'agenzia qualifica l'ID.
`trips.txt`	`exceptional`	Enum	Facoltativo	Questo campo indica corse eccezionali. Lavorano al di fuori del normale orario o vengono deviati dal percorso abituale a causa di eventi speciali o interruzioni pianificate (come lavori dei binari e così via). Google accetta le seguenti opzioni di valore: `0`. Servizi standard `1`. Eccezione di servizio. Ad esempio, i servizi che vengono aggiunti a causa di eventi speciali o i servizi deviati 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 è presente il campo `ticketing_trip_id`, il suo 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. Il campo `ticketing_type` specifica il tipo di acquisto di biglietti applicabile a questa corsa. Google Transit accetta i seguenti valori: `0`. Impostazione predefinita. Disponibile solo se l'azienda o il percorso dispone di un link diretto per l'acquisto di biglietti attivato. `1`. Non disponibile.
`translations.txt`	`lang`	Codice della lingua	Facoltativo	Estensione di Google Transit. Il campo `lang` non fa parte del GTFS ufficiale, ma Google Transit utilizza questo valore quando è presente. Per specificare la traduzione di una frase, utilizza il campo `lang`. Il valore non deve essere vuoto o `und` (una lingua non definita).
`translations.txt`	`trans_id`	ID	Facoltativo	Estensione di Google Transit. Il campo `trans_id` non fa parte del GTFS ufficiale, ma Google Transit utilizza questo valore quando è presente. Per specificare il token ID della frase per cui viene fornita la traduzione, utilizza il campo `trans_id`. Ogni riga della tabella `translations.txt` indica che nella lingua `lang`, la frase `trans_id` si traduce in `translation`.
`trips.txt`	`original_trip_id`	ID	Facoltativo	Estensione di 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 di Google Transit. Il campo `trip_direction_name` identifica la direzione di una corsa verso i passeggeri. Il valore in questo campo viene archiviato come valore `direction_name` di ogni corsa. Se il valore `stop_direction_name` nella tabella `stop_times` cambia durante il percorso, potrebbe sostituire il valore `trip_direction_name`. I valori nel campo `trip_direction_name` sono normalizzati tra maiuscole e minuscole.
`trips.txt`	`vehicle_category_id`	ID	Facoltativo	Estensione di Google Transit. Nel file `trips.txt`, il campo `vehicle_category_id` identifica il veicolo assegnato a questa corsa. Quando questo campo si trova nel file `trips.txt`, il suo valore sostituisce il valore `vehicle_category_id` nel file `routes.txt`.