Riferimento e differenze GTFS di Google Transit in tempo reale

Questa pagina descrive le principali differenze tra l'implementazione delle specifiche di GTFS in tempo reale e l'implementazione delle specifiche 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 in tempo reale

Le seguenti sezioni documentano le principali differenze tra l'implementazione ufficiale di GTFS e l'implementazione del feed Realtime Transit di Google Transit.

Specifiche ufficiali ignorate nei feed in tempo reale

Alcune specifiche ignorate sono sperimentali. Per scoprire di più, vai su 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 nel 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 In virgola mobile
messaggio Position odometer Matrimoniale
messaggio Position speed In virgola mobile
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

Transit accetta alcuni campi GTFS, ma li interpreta in modo diverso dal 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 di enumerazione sono supportati o meno da Transit.

Tabella 2. Campi del feed in tempo reale interpretati diversamente
Nome file Campo definito nel GTFS Tipo di campo Richiesto da Google Transit? Dettagli sull'implementazione di Google Transit
messaggio StopTimeUpdate (in TripUpdate) stop_id Stringa Obbligatoria condizionalmente

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

  • La stringa stop_id deve essere la stessa del file stops.txt del feed GTFS corrispondente.
  • Se viene utilizzata una stringa stop_id diversa, la stringa stop_id fornita deve essere una stringa sorella o secondaria della stringa stop_id originale fornita nel GTFS statico. Devi specificare 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: quando 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.