Mit TripUpdates in Echtzeit Informationen zur Fahrt angeben

Wichtig: Mit dem TripUpdate-Feed können Sie Echtzeitinformationen zu einer Fahrt angeben. Weitere Informationen dazu finden Sie unter Fahrt mit TripDescriptor auswählen. Wenn es in Ihrem System nicht möglich ist, Vorhersagen für komplette Fahrten zu erstellen, sollten Sie mit einem einfachen TripUpdate-Feed prüfen, ob Ihr GTFS-Echtzeitfeed korrekt ist.

Zeiten, Gleise und Haltestellen einer Fahrt aktualisieren

Mit dem TripUpdates-Feed können Sie Ankunftszeiten, Gleisänderungen und die angefahrenen Haltestellen aktualisieren.

Ankunftszeit aktualisieren

Eine stop_time_update-Nachricht kann Informationen zur Ankunfts- oder Abfahrtszeit einer bestimmten Fahrt an einer Haltestelle enthalten. Wenn Sie die Ankunftszeit aktualisieren möchten, stellen Sie einen TripUpdates-Feed mit einem passenden TripDescriptor sowie die korrekten stop_time_update-Informationen für Haltestellen und den Zeitstempel zum Messen des Fortschritts zur Verfügung.

Dafür gelten die folgenden Grundvoraussetzungen:

• Der TripUpdates-Feed muss die bestmögliche Vorhersage für das nächste bevorstehende StopTimeUpdate enthalten.
• Der Feed sollte nach Möglichkeit weiterhin alle vorher angefahrenen Haltestellen enthalten. Verwenden Sie zur Angabe der Haltestellen StopTimeUpdates mit stop_id oder stop_sequence sowie Werte, die angeben, wann das Fahrzeug tatsächlich an der Haltestelle eintraf oder die Haltestelle verlassen hat.
• Geben Sie mit TripUpdate.timestamp an, wann die letzte Messung des zugehörigen Fahrzeugs erfolgte (falls verfügbar).

Wenn Sie eine Fahrtaktualisierung mit TripUpdate erstellt haben, unterstützen wir Änderungen der Routenführung auf Basis von tatsächlichen Abfahrts- und Ankunftszeiten, die aus GTFS-Feeds mit Echtzeitfahrtaktualisierungen (TripUpdate) stammen.

Wenn Sie für eine Fahrt sowohl TripUpdate als auch VehiclePosition angeben, entscheiden wir, welcher Nachrichtentyp verwendet wird:

• Eine TripUpdate-Nachricht mit den voraussichtlichen Ankunftszeiten, basierend auf stop_time_update-Informationen
• Eine VehiclePosition-Nachricht, basierend auf Positionsinformationen mit einer Schätzung der voraussichtlichen Ankunftszeiten aus unserem Prognosenalgorithmus

Beispiel

Die Fahrt T soll heute um 19:00 Uhr an Haltestelle S beginnen. Aus dem GTFS-Feed mit Echtzeitfahrtaktualisierungen (TripUpdate) geht hervor, dass die Fahrt an Haltestelle S eine Verspätung von 5 Minuten hat. Bei der Suche nach Verbindungen von Haltestelle S um 19:03 Uhr wird jetzt Fahrt T als eine der möglichen Verbindungen angezeigt, weil die in Echtzeit aktualisierte Abfahrtszeit von Fahrt T nach der gewünschten Abfahrtszeit liegt. Durch das Echtzeit-Update wurde die Abfahrtzeit von Fahrt T mit einer Uhrzeit nach der regulären Abfahrtszeit aktualisiert.

Beispielcode:

trip_update {
  trip {
    trip_id: xxx
    start_time: 12:34:56
  }
  stop_time_update {
    stop_sequence: 0
    stop_id: "child_stop_id"
    arrival {
      time: 1284457468
    }
  }
}

Beachten Sie bitte Folgendes:

• In trip_descriptor sollte der Wert für start_time mit dem Wert für static_time übereinstimmen, der im statischen Feed definiert ist.
• Nachdem der Wert start_time definiert wurde, damit der Bezug zur Fahrt bestehen bleibt, sollte er konstant bleiben.
• Geben Sie die Verspätung mit dem Wert für stop_time_update im Feld time oder delay an.

Bei Fahrplänen, die auf Häufigkeiten statt festen Uhrzeiten basieren, wird die Ankunftszeit der nächsten Fahrt immer grün und als pünktlich angezeigt.

Bei festen Zeitplänen wird die tatsächliche Verspätung angezeigt:

  

Bahnhof oder Gleise aktualisieren

Die Agentur kann die stop_id des StopTimeUpdate-Objekts aktualisieren, um auf eine Änderung bei den Haltestellen hinzuweisen. Der Wert stop_sequence muss angegeben werden und die ersetzte stop_id muss eine parent_station sein oder eine parent_station mit der neuen stop_id teilen.

Beispielcode:

trip_update {
  trip {
    trip_id: xxx
    start_time: 12:34:56
  }
  stop_time_update {
    stop_sequence: 0
    stop_id: "child_stop_id"
    arrival {
      time: 1284457468
    }
  }
}

So erhalten Nutzer Gleisinformationen:

 

 

Haltestelle überspringen

Verwenden Sie einen SKIPPED-Wert für schedule_relationship im StopTimeUpdate-Objekt.

• Wenn die nicht angefahrene Haltestelle ein Zu- oder Aussteigepunkt bei einer Suchanfrage ist, wird die entsprechende Fahrt aus den Suchergebnissen entfernt.
• Ist die betroffene Haltestelle nur Teil der Fahrt, aber kein Zu- oder Aussteigepunkt, wird die Fahrt weiterhin in den Suchergebnissen angezeigt.

Beispielcode:

trip_update {
  trip {
    trip_id: xxx
    start_time: 12:34:56
  }
  stop_time_update {
    stop_sequence: 0
    schedule_relationship: SKIPPED
  }
}