Differenze e riferimenti di Google Transit GTFS in tempo reale

Questa pagina descrive le principali differenze tra l'implementazione ufficiale della specifica GTFS Realtime e quella 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.

Trasporto pubblico in tempo reale

Le seguenti sezioni descrivono le principali differenze tra la specifica GTFS ufficiale e l'implementazione del feed in tempo reale di Google Transit.

Specifiche ufficiali ignorate nei feed in tempo reale

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

La tabella 1 elenca i campi definiti da GTFS che vengono ignorati da Transit nei feed in tempo reale.

Tabella 1. Campi ufficiali ignorati nei feed in tempo reale
Messaggio Campo ignorato definito in GTFS Tipo di campo
messaggio Alert image TranslatedImage
messaggio Alert image_alternative_text TranslatedString
messaggio Alert severity_level Enum
messaggio Alert tts_description_text Proto
messaggio Alert tts_header_text Proto
messaggio CarriageDetails id Stringa
messaggio CarriageDetails occupancy_percentage int32
messaggio Position bearing Float
messaggio Position odometer Doppio
messaggio Position speed Float
messaggio Shape encoded_polyline Stringa
messaggio Shape shape_id Stringa
messaggio StopTimeUpdate (in TripUpdate) arrival.uncertainty int32
messaggio StopTimeUpdate (in TripUpdate) stop_time_properties Proto
messaggio TripUpdate trip_properties Proto
messaggio TripUpdate vehicle VehicleDescriptor
messaggio VehicleDescriptor license_plate Stringa
messaggio VehicleDescriptor wheelchair_accessible WheelchairAccessible
messaggio VehiclePosition congestion_level Enum
messaggio VehiclePosition current_status VehicleStopStatus
messaggio VehiclePosition current_stop_sequence uint32
messaggio VehiclePosition multi_carriage_details.id Stringa
messaggio VehiclePosition occupancy_percentage uint32
messaggio VehiclePosition stop_id Stringa

Interpretazione diversa nei feed in tempo reale

Sebbene Transit accetti determinati campi GTFS, li interpreta diversamente rispetto al GTFS.

La tabella 2 elenca i campi definiti da GTFS nei feed in tempo reale che sono facoltativi o obbligatori in base alle condizioni di Transit. Per i campi facoltativi, la tabella indica se i valori dell'enum sono supportati o meno da Transit.

Tabella 2. Campi del feed in tempo reale interpretati in modo diverso
Nome file Campo definito in GTFS Tipo di campo Obbligatorio per Google Transit? Dettagli sull'implementazione di Google Transit
messaggio StopTimeUpdate (in TripUpdate) stop_id Stringa Obbligatorio condizionalmente

Quando viene fornita una stringa stop_id, deve soddisfare una delle seguenti condizioni:

  • La stringa stop_id deve essere la stessa del stops.txt file nel feed GTFS corrispondente.
  • Se viene utilizzata una stringa stop_id diversa, la stringa stop_id fornita deve essere una stringa sorella o figlia della stringa stop_id originale fornita nel GTFS statico. Deve essere fornito anche il campo stop_sequence corrispondente.
messaggio StopTimeUpdate schedule_relationship Enum Facoltativo

Google Transit supporta i seguenti valori enum:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
messaggio TripDescriptor schedule_relationship Enum Facoltativo

Google Transit non supporta i seguenti valori enum:

  • DUPLICATED
  • CANCELED, se non è per i record TripUpdate

Google supporta i seguenti valori enum:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED: supportato solo per i record TripUpdate

Supporto sperimentale nei feed in tempo reale

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

Estensioni supportate da Google Transit nei feed in tempo reale

Al momento della pubblicazione di questo articolo, nessun campo appartiene a questa categoria. Se hai bisogno di assistenza, contatta Google Transit.