I percorsi descrivono il modo in cui le aziende di trasporto pubblico comunicano i loro servizi ai passeggeri. Puoi definire i percorsi nel file routes.txt
, che ha la seguente struttura:
Campi obbligatori
route_id,route_short_name,route_long_name,route_type
Campi facoltativi
agency_id,route_desc,route_url,route_color,route_text_color
Consulta il nostro file routes.txt per una descrizione dei campi che contiene.
Nell'esempio seguente è riportato un file routes.txt
semplice:
route_id,route_short_name,route_long_name,route_desc,route_type
17,A,Mission,"The ""A"" route travels from lower Mission to Downtown.",3
Informazioni su come progettare i percorsi
Importante: i percorsi progettati impropriamente possono compromettere alcune funzionalità, ad esempio la possibilità di cercare un percorso specifico.
Le voci contenute nel file routes.txt
devono essere organizzate nello stesso modo in cui comunichi i percorsi fisici o le linee ai passeggeri. Ad esempio, in routes.txt
raggruppa gli orari in base al percorso, proprio come faresti se dovessi presentarli su un sito web o in un opuscolo stampato. La struttura del file routes.txt
deve corrispondere ai percorsi indicati sugli orari.
Per creare i percorsi, attieniti alle seguenti best practice:
route_color
: i campiroute_color
eroute_text_color
aiutano gli utenti a identificare un percorso.- Il colore del percorso deve essere un numero di sei caratteri esadecimali, ad esempio 00FFFF. Se non specifichi un colore, il colore predefinito è bianco (FFFFFF).
- Questi valori devono essere coerenti con i colori degli orari, delle mappe, della segnaletica o delle insegne sui mezzi.
- Utilizza colori contrastanti per i campi
route_color
eroute_text_color
, perché vengono utilizzati rispettivamente come colore del testo e dello sfondo per la visualizzazione dei nomi di percorso. - Se la tua azienda di trasporto pubblico non utilizza i colori, lascia questi campi vuoti.
route_url
: imposta il camporoute_url
su una pagina web che fornisce informazioni sul percorso.route_desc
: inserisci una descrizione del percorso nel camporoute_desc
.
Assegnare un nome ai percorsi
I percorsi nel tuo feed GTFS devono avere gli stessi nomi dei percorsi fisici o delle linee comunicati dall'azienda di trasporto pubblico. Le reti di trasporto pubblico cittadine usano spesso numeri, lettere o colori per distinguere linee e percorsi differenti. Tuttavia, i treni intercity, gli autobus a lunga percorrenza o i traghetti sono spesso identificati in base al tipo o in base al nome dell'operatore. In questo caso, utilizza tali identificatori come nomi di percorso. Non includere parole come "linea" o "percorso" nei nomi di percorso.
Campi Route_short_name
e Route_long_name
Il valore del campo route_short_name
deve essere un numero o un identificatore breve. Non duplicare questo valore nel campo route_long_name
, poiché in genere vengono mostrati uno accanto all'altro. Se il percorso non ha né un route_long_name
né un route_short_name
, lascia vuoto uno dei due campi.
Ti consigliamo di visualizzare il route_short_name
. Se route_long_name
contiene invece il nome utilizzato per le comunicazioni, devi lasciare vuoto route_short_name
.
Differenza tra "percorso" e "corsa"
Ricorda che una "corsa" avviene a un'ora specifica e che un "percorso" non dipende dal tempo. Non suddividere un percorso fisico in più voci nel file routes.txt
per rappresentare diverse opzioni di percorso (ad es. la direzione di viaggio). Utilizza invece le caratteristiche di trips.txt per progettare tali varianti (come mostrato di seguito negli esempi di percorsi). Se il file routes.txt
contiene più voci con lo stesso route_short_name
o route_long_name
, i percorsi sono stati suddivisi inutilmente. Informazioni sui nomi dei campi di trips.txt e sul loro significato.
Esempi di percorsi
Le seguenti sezioni contengono alcuni modelli di percorso di esempio. Il primo modello crea correttamente i percorsi con varianti di percorso.
Esempio 1 (corretto)routes.txt
route_id,route_short_name,route_long_name,route_type
R10,10,Airport - Downtown,3
R20,20,University - Downtown,3
File
trips.txt
route_id,service_id,trip_id,trip_headsign,direction_id
R10,WD,T-10-1,Airport,0
R10,WE,T-10-2,Downtown,1
R20,WD,T-20-1,University,0
R20,WE,T20-2,Downtown,1
Esempio 2 (errato)
File routes.txt
route_id,route_short_name,route_long_name,route_type
R10-in,10,To Downtown,3
R10-out,10,To Airport,3
R20-in,20,To Downtown,3
R20-out,20,To University,3
Scenari di creazione del percorso
Scenario 1La linea di autobus 1 opera tra le fermate A - B - C - D - E - F. Alcune corse operano solo tra le fermate A e D, mentre altre saltano le fermate B, C ed E. Questo percorso è progettato come percorso "1" nel feed e include le corse da A a F.
File stops.txt
stop_id,stop_name,stop_lat,stop_lon
stopA,Stop A,-21.213049,-159.825975
stopB,Stop B,-21.227892,-159.828051
stopC,Stop C,-21.252230,-159.821118
stopD,Stop D,-21.260588,-159.800071
stopE,Stop E,-21.271595,-159.757365
stopF,Stop F,-21.269228,-159.739851
File routes.txt
route_id,route_short_name,route_long_name,route_type
BusLine1,1,,3
File trips.txt
route_id,service_id,trip_id
BusLine1,0,tripABCDEF
BusLine1,0,tripABCD
BusLine1,0,tripADF
File stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
tripABCDEF,06:00:00,06:00:00,stopA,1
tripABCDEF,06:10:00,06:12:00,stopB,2
tripABCDEF,06:20:00,06:22:00,stopC,3
tripABCDEF,06:30:00,06:32:00,stopD,4
tripABCDEF,06:40:00,06:42:00,stopE,5
tripABCDEF,06:50:00,06:50:00,stopF,6
tripABCD,08:00:00,08:00:00,stopA,1
tripABCD,08:10:00,08:12:00,stopB,2
tripABCD,08:20:00,08:22:00,stopC,3
tripABCD,08:30:00,08:30:00,stopD,4
tripADF,10:00:00,10:00:00,stopA,1
tripADF,10:30:00,10:32:00,stopD,2
tripADF,10:50:00,10:50:00,stopF,3
Utilizzando la stessa configurazione dello scenario precedente, supponiamo che le corse che saltano le fermate B, C ed E siano comunicate negli orari al pubblico come una linea separata ("1 Express"). In questo caso, anche le mappe e la segnaletica devono essere create come percorso separato "1 Express" nel feed.
File stops.txt
stop_id,stop_name,stop_lat,stop_lon
stopA,Stop A,-21.213049,-159.825975
stopB,Stop B,-21.227892,-159.828051
stopC,Stop C,-21.252230,-159.821118
stopD,Stop D,-21.260588,-159.800071
stopE,Stop E,-21.271595,-159.757365
stopF,Stop F,-21.269228,-159.739851
File routes.txt
route_id,route_short_name,route_long_name,route_type
BusLine1,1,,3
BusLine1Express,1 Express,,3
File trips.txt
route_id,service_id,trip_id
BusLine1,0,tripABCDEF
BusLine1,0,tripABCD
BusLine1Express,0,tripADF
File stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
tripABCDEF,06:00:00,06:00:00,stopA,1
tripABCDEF,06:10:00,06:12:00,stopB,2
tripABCDEF,06:20:00,06:22:00,stopC,3
tripABCDEF,06:30:00,06:32:00,stopD,4
tripABCDEF,06:40:00,06:42:00,stopE,5
tripABCDEF,06:50:00,06:50:00,stopF,6
tripABCD,08:00:00,08:00:00,stopA,1
tripABCD,08:10:00,08:12:00,stopB,2
tripABCD,08:20:00,08:22:00,stopC,3
tripABCD,08:30:00,08:30:00,stopD,4
tripADF,10:00:00,10:00:00,stopA,1
tripADF,10:10:00,10:12:00,stopD,2
tripADF,10:20:00,10:20:00,stopF,3
Esempi di denominazione dei percorsi
-
La rete di tram di Zurigo utilizza numeri e colori per identificare le diverse linee.
-
Zürich, Albisgütli
[route_short_name
: “13”,route_long_name
: “”,trip_headsign
: “Zürich, Albisgütli,route_color
: "FFCC00",route_text_color
: "000000"] -
Zürich, Zoo
[route_short_name
: “6”,route_long_name
: “”,trip_headsign
: “Zürich, Zoo”,route_color
: "CA7D3C",route_text_color
: "FFFFFF"]
-
-
I servizi ferroviari nazionali in Gran Bretagna utilizzano il nome dell'operatore.
-
London Waterloo
[route_short_name
: “South West Trains”,route_long_name
: “”,trip_headsign
: “London Waterloo”] -
Brighton
[route_short_name
: “Southern”,route_long_name
: “”,trip_headsign
: “Brighton”]
-
-
I servizi ferroviari nazionali in Europa utilizzano il tipo di treno (specificato nell'esempio con il campo
route_short_name
).-
ICE 801 Berlin Südkreuz
[route_short_name
: “ICE”,route_long_name
: “”,trip_headsign
: “Berlin Südkreuz”,trip_short_name
: 801] -
Interlaken Ost
[route_short_name
: “IC”,route_long_name
: “”,trip_headsign
: “Interlaken Ost”]
-
-
Gli autobus a lunga percorrenza in Argentina utilizzano il nome dell'operatore.
-
Cordoba
[route_short_name
: “Mercobus”,route_long_name
: “”,trip_headsign
: “Cordoba”] -
Rafael Castillo
[route_short_name
: “Rutatlantica”,route_long_name
: “”,trip_headsign
: “Rafael Castillo”]
-