Fuso orario dell'azienda di trasporto pubblico
Il campo agency_timezone del file agency.txt consente di impostare il fuso orario dell'azienda di trasporto pubblico. Questo campo obbligatorio serve inoltre da valore di riferimento per gli orari di partenza e arrivo indicati nel feed GTFS. Tutte le aziende di trasporto incluse in un feed devono avere lo stesso valore agency_timezone.
Fuso orario delle fermate
Se un feed è relativo a più fusi orari, è necessario indicare nel campo stop_timezone i fusi orari delle fermate che non si trovano nel fuso orario agency_timezone. Imposta questo campo facoltativo nel file stops.txt. Se ometti il valore stop_timezone, il sistema presume che la fermata si trovi nel fuso orario specificato dal campo agency_timezone del file agency.txt. In questo caso, assicurati che gli orari delle corse siano accurati e coerenti, specificando orari di partenza e arrivo in base al fuso orario di agency_timezone per le fermate che si trovano al di fuori di questo.
Nei risultati relativi ai percorsi, gli orari di partenza e arrivo sono indicati nel fuso orario locale di ogni fermata.
Ora legale
Importante: l'orario nel file stops.txt dovrebbe sempre aumentare.
È possibile che alcune corse operino in corrispondenza della modifica dell'ora legale, per poi continuare come di consueto. Imposta queste corse utilizzando il giorno precedente come punto di riferimento in stop_times.txt. Rendi gli orari di partenza coerenti con il tempo di percorrenza del mezzo. Il nostro algoritmo calcola gli orari corretti da mostrare agli utenti.
Se in corrispondenza della modifica relativa all'ora legale i servizi seguono orari speciali (ad esempio prevedendo l'attesa di un'ora a una fermata), disabilita le corse normali per questa data e imposta una nuova corsa eccezionale.
Esempi
L'orologio si sposta avantiUn autobus parte il 2 ottobre alle 1:50 la notte in cui si verifica il passaggio (ad esempio, le 2:00 diventano le 3:00). La corsa viene impostata sul giorno precedente (1 ottobre):
| stop_sequence | Departure_times [GTFS] |
Orario di partenza visualizzato [Google Maps] |
|---|---|---|
| 1 | 25:50:00 (1 ottobre) | 01:50 (2 ottobre) |
| 2 | 26:10:00 (1 ottobre) | 03:10 (2 ottobre) * |
| 3 | 27:10:00 (1 ottobre) | 04:10 (2 ottobre) |
| 4 | 28:10:00 (1 ottobre) | 05:10 (2 ottobre) |
* visualizzato a causa del cambiamento dell'ora
Un autobus parte il 2 ottobre alle 1:50 la notte in cui si verifica il passaggio (ad esempio, le 3:00 diventano le 2:00). La corsa viene impostata sul giorno precedente (1 ottobre):
| stop_sequence | Departure_times [GTFS] |
Orario di partenza visualizzato [Google Maps] |
|---|---|---|
| 1 | 25:50:00 (1 ottobre) | 01:50 (2 ottobre) |
| 2 | 26:10:00 (1 ottobre) | 02:10 (2 ottobre) ** |
| 3 | 27:10:00 (1 ottobre) | 02:10 (2 ottobre) *** |
| 4 | 28:10:00 (1 ottobre) | 03:10 (2 ottobre) |
** visualizzato prima del cambio dell'ora effettivo
*** visualizzato dopo il cambio dell'ora effettivo
Avvisi di convalida relativi agli orari
È possibile che la convalida del feed restituisca avvisi che riguardano le impostazioni dei campi relativi agli orari.
Viaggio troppo veloce tra le fermate
Questo avviso indica che la velocità calcolata di una corsa è superiore alla velocità massima definita per il relativo valore route_type.
Se nel file stop_times.txt gli orari sono espressi nel fuso orario locale della fermata corrispondente (stop), anziché in quello definito in agency_timezone, è possibile che il sistema restituisca un avviso di "Viaggio troppo veloce tra le fermate". Ancora più importante, il sistema restituirà risultati errati relativi al percorso. L'algoritmo di elaborazione del percorso presume che gli orari del file stop_times.txt siano espressi nel fuso orario specificato in agency_timezone.
Puoi risolvere il problema definendo nel file stop_times.txt gli orari delle fermate nel fuso orario di agency_timezone.
Anche se nel file stops.txt hai impostato valori stop_timezone, è buona prassi che gli orari del file stop_times.txt vengano specificati a partire dalla mezzanotte nel fuso orario di agency_timezone nel file agency.txt. Con questa impostazione i valori degli orari di una corsa continuano ad aumentare lungo il tragitto, indipendentemente dai fusi orari attraversati. Nota inoltre che gli orari del file stop_times.txt devono essere sempre specificati nel fuso orario indicato nel campo agency_timezone (NON nel fuso orario locale della fermata corrispondente).
Questo avviso segnala in genere un problema di dati. Verifica quanto segue:
- Posizioni delle fermate (
stop): questo avviso viene attivato quando la fermata è troppo lontana dalla posizione corretta. - Che gli orari delle fermate siano accurati.
- Se l'avviso è dovuto alla modifica relativa all'ora legale, consulta la sezione Ora legale.