Beim Bereitstellen von GTFS-Realtime-Daten (General Transit Feed Specification) können sich Lücken in aufeinanderfolgenden Feedaktualisierungen negativ darauf auswirken, wie die betroffenden Ergebnisse in Google Maps dargestellt werden.
Im Allgemeinen ist beim Bereitstellen von GTFS-Realtime-Daten Folgendes zu beachten:
- Entitäten (Benachrichtigung, Fahrtaktualisierung, Fahrzeugposition) sollten nur dann aus einem GTFS-Realtime-Feed entfernt, d. h. verworfen werden, wenn sie für die Nutzer nicht mehr relevant sind.
- Aus Feedzeitstempeln sollte der Zeitpunkt der letzten Aktualisierung hervorgehen.
- In Entitätszeitstempeln (Fahrtaktualisierung und Fahrzeugposition) sollte angegeben sein, wann die Daten für diese Entität zuletzt aktualisiert wurden.
Wenn Ihr Feed den obigen Richtlinien entspricht, sollte es nicht zu den unten aufgeführten Szenarien kommen – aber für den Fall der Fälle können Sie sich hier einen Überblick verschaffen.
Feedaktualisierung mit verworfener Benachrichtigung
In diesem Fall enthält Ihr aktueller Feed eine Benachrichtigung zur Fahrtaktualisierung oder Fahrzeugposition für eine Fahrt, Haltestelle bzw. Route. In der Aktualisierung ist diese Entität jedoch verworfen. Im Folgenden werden die einzelnen Verhaltensweisen in Bezug auf den jeweiligen Feedtyp und die Situation betrachtet, in denen eine bestimmte Entität verworfen wird.
Wichtig:
- Jede einzelne Aktualisierung eines GTFS-Realtime-Feeds wird von Google als vollständiger Snapshot aller relevanten Informationen betrachtet. Es werden sämtliche Informationen aus dem vorherigen Feed vollständig überschrieben. Wenn eine in einem vorherigen Feed enthaltene Benachrichtigung in der Aktualisierung nicht mehr vorhanden ist, werden für diese spezifische Entität keine Echtzeitdaten angezeigt, es sei denn, die Nachricht wird in einer späteren Feedaktualisierung wiederhergestellt.
- Wenn Sie die manuellen Benachrichtigungen des Partner-Dashboards verwenden, weicht dieses Verhalten geringfügig ab, da Aktualisierungen hier additiv gehandhabt werden.
Benachrichtigung
Informative Benachrichtigung wird verworfen
Auswirkung: Schwerwiegend
Wird eine Benachrichtigungsentität zwischen Feedaktualisierungen verworfen, ist die zuvor noch vorhandene Benachrichtigung für Nutzer in Google Maps nicht mehr zu sehen.
Benachrichtigung mit Auswirkungswert NO_SERVICE wird verworfen
Auswirkung: Schwerwiegend
Bei Benachrichtigungen mit NO_SERVICE-Auswirkung wird die betroffene Fahrt zurückgestuft. Endnutzer können sie in Google Maps im separaten Abschnitt „Fahrten mit Störungen“ sehen.
Falls eine solche Benachrichtigung zwischen Feedaktualisierungen verworfen wird, wird – zusätzlich zum oben beschriebenen Verhalten – die zuvor zurückgestufte Fahrt für Nutzer als reguläres Ergebnis angezeigt, ohne Hinweis auf die vorhergehende Stornierung.
Fahrtaktualisierung
ScheduleRelationship-Wert CANCELLED wird verworfen
Auswirkung: Schwerwiegend
Eine gestrichene Fahrt wird aus den Fahrtergebnissen in Google Maps entfernt. Wird jedoch eine Nachricht mit dem ScheduleRelationship-Wert CANCELLED zwischen Feedaktualisierungen verworfen, ist die zuvor gestrichene Fahrt für Nutzer wieder zu sehen, und zwar ohne Echtzeitinformationen – also so, als wäre sie nicht gestrichen worden.
Dies kann dazu führen, dass Nutzer auf ein Transportmittel warten, das nicht kommt.
ScheduleRelationship-Wert ADDED wird verworfen
Auswirkung: Schwerwiegend
Eine Fahrt mit ScheduleRelationship-Ergebnissen vom Typ ADDED in einem zusätzlichen Dienst in den Fahrtergebnissen wird für Nutzer ergänzend zu bereits vorhandenen statischen Daten eingeblendet. Wird eine Fahrtaktualisierung dieser Art verworfen, sehen die Nutzer die zugehörige Fahrt nicht.
Dies führt dazu, dass Nutzer nicht wissen, dass es diesen zusätzlichen Dienst gibt.
ScheduleRelationship-Wert SCHEDULED wird verworfen
Auswirkung: Mittelschwer
Bei vorherigen Aktualisierungen wurde der Nutzer durch UI-Elemente darauf hingewiesen, dass für diese Fahrt die Abfahrts- und die Ankunftszeit in Echtzeit aktualisiert werden. Die Elemente sind in diesem Fall nicht zu sehen und die Ergebnisse enthalten keine Echtzeitinformationen.
Dies kann dazu führen, dass Nutzer zu früh oder zu spät an der Bushaltestelle ankommen.
StopTimeUpdate-Wert überspringt eine Haltestelle
Auswirkung: Schwerwiegend
Wird eine StopTimeUpdate-Entität verworfen, die zuvor auf einen nicht angefahrenen Stopp hingewiesen hat, ist für Nutzer in der Nähe möglicherweise diese Haltestelle als Abfahrtspunkt zu sehen.
Dies kann dazu führen, dass Nutzer auf ein Transportmittel warten, das für sie nicht anhält.
Fahrzeugposition
SCHEDULED-Entität wird verworfen
Auswirkung: Schwerwiegend
Bei vorherigen Bundle-Updates war auf der Benutzeroberfläche zu sehen, wo sich ein Bus auf der Karte befand. Auch Vorhersagen zu Ankunft und Abfahrt waren für den Endnutzer sichtbar.
Wird die Fahrzeugposition SCHEDULED für eine bestimmte Fahrt verworfen, sind in Google Maps weder die jeweilige Position des Fahrzeugs noch Vorhersagen zu Ankunfts- oder Abfahrtszeit zu sehen.
Das führt dazu, dass lediglich Ankunftszeiten angegeben werden, die auf dem statischen Fahrplan beruhen und von der realen Situation abweichen können.
ADDED-Entität wird verworfen
Auswirkung: Schwerwiegend
Bei vorherigen Bundle-Updates wurde eine neue Fahrt in den Fahrtergebnissen eingeblendet, die in dem zugrunde liegenden, statischen GTFS-Feed nicht zu sehen war. Dies betrifft auch die Fahrzeugposition sowie Vorhersagen zu Ankunfts- und Abfahrtszeit.
Wird eine Fahrzeugposition vom Typ ADDED für eine bestimmte Fahrt verworfen, wird die Fahrt, die im statischen GTFS-Feed nicht vorhanden ist, auch in den Fahrtergebnissen nicht eingeblendet.
Die Nutzer wissen in diesem Fall also nicht, dass es zusätzliche Dienste gibt.
Aufeinanderfolgende Bundles enthalten veraltete Daten
Wichtig:
- Wird ein ganzer Feed nicht innerhalb von 15 Minuten ab dem aktuellen Zeitpunkt aktualisiert, enthält der Echtzeit-Validierungsbericht eine Warnung vom Typ TIMESTAMP_PAST. Der Feed wird jedoch weiterhin verarbeitet.
- Wenn ein Feed immer wieder veraltete Angaben aufweist, kann es je nach Feedtyp zu den in diesem Abschnitt aufgeführten Verhaltensweisen kommen.
Benachrichtigung
Zeitstempelfeld in FeedHeader-Nachricht ist veraltet
Auswirkung: Gering
Dies hat auf die Daten von veralteten Benachrichtigungen keine Auswirkung. Die veralteten Benachrichtigungen werden weiter verarbeitet, es sei denn, es gibt eine Aktualisierung, in der sie nicht mehr enthalten sind. Bei Benachrichtigungen ist es im Gegensatz zu den Entitäten für Fahrtaktualisierung und Fahrzeugposition akzeptabel, wenn die zugehörigen Feeds nur etwa einmal pro Woche aktualisiert werden. Empfohlen wird jedoch, sie mindestens alle 10 Minuten auf den neuesten Stand zu bringen, damit Google Maps-Nutzer die neuesten Benachrichtigungen erhalten.
Wenn ein Benachrichtigungsfeed seit mehr als einer Woche nicht mehr aktualisiert wurde, werden Sie vom Google Transit-Team möglicherweise daran erinnert. Ohne Aktualisierung in diesem Zeitraum wird Ihr Benachrichtigungsfeed möglicherweise deaktiviert.
Fahrtaktualisierung
Zeitstempelfeld in FeedHeader-Nachricht ist veraltet
Auswirkung: Schwerwiegend
Ein Feed gilt nach 1 Stunde als veraltet, wenn er keinen aktualisierten Zeitstempel hat. Dann wird der gesamte Feed verworfen. Dem Endnutzer werden keine Echtzeitdaten angezeigt. Weitere Informationen zum Szenario „Nachfolgendes Bundle verwirft: Fahrtaktualisierung“
Zeitstempel liegt mehrmals hintereinander deutlich vor dem Zeitpunkt des Feedabrufs
Auswirkung: Schwerwiegend
Über mehrere Feedabrufe hinweg weicht ein bestimmter Zeitstempel für die Fahrtaktualisierung deutlich vom Zeitpunkt des Abrufs ab. Es handelt sich hierbei um die Zeit, zu der Google Ihren Feed abruft, nicht um den Zeitstempel des Feeds. Fahrtaktualisierungen für diese Fahrt werden verworfen, sofern der Zeitunterschied nicht geringer wird.
Auf der Benutzeroberfläche scheint die Fahrtaktualisierung im Feed überhaupt nicht vorhanden zu sein. Weitere Informationen zum Szenario „Nachfolgendes Bundle verwirft: Fahrtaktualisierung“
Fahrzeugpositionen
Zeitstempelfeld in FeedHeader-Nachricht ist veraltet
Auswirkung: Schwerwiegend
Der Feed wird verworfen. Weitere Informationen zum Szenario „Nachfolgendes Bundle verwirft: Fahrzeugposition“
Zeitstempelfeld in VehiclePosition-Nachricht ist veraltet
Auswirkung: Schwerwiegend
VehiclePosition-Nachrichten gelten als veraltet, wenn seit dem Zeitstempel im Zeitstempelfeld 15 Minuten vergangen sind. Ist dies der Fall, werden die VehiclePosition-Informationen verworfen. Weitere Informationen zum Szenario „Nachfolgendes Bundle verwirft: Fahrzeugposition“
Wenn Entitäten für diese Fahrt später wiederhergestellt werden, werden für die Berechnung von Ankunfts- und Abfahrtszeit weiterhin Positionsdaten früherer Entitäten verwendet.
Zeitstempel veralteter Daten werden aktualisiert
In diesem Szenario werden von einem Feed wiederholt veraltete Informationen zurückgegeben. Der Zeitstempel für den Feed selbst oder für die Entitäten in diesem Feed wird jedoch aktualisiert.
Zeitstempelfeld für FeedHeader wird aktualisiert, Feed enthält jedoch veraltete Daten
Auswirkung: Mittelschwer
Dies hat keine unmittelbare Auswirkung, wenn die jeweiligen Entitätsinformationen unverändert geblieben sind. Der Feed wird wie gewohnt interpretiert. Im Laufe der Zeit steigt jedoch die Wahrscheinlichkeit, dass einzelne Entitäten aufgrund veralteter Daten verworfen werden.
Zeitstempelfeld der VehiclePosition-Entität wird aktualisiert, die Positionsdaten sind jedoch veraltet
Auswirkung: Schwerwiegend
In diesem Fall wurde das Feld timestamp für eine Fahrzeugposition aktualisiert, obwohl die Entität veraltete Positionsdaten enthält. Im Zuge der Aktualisierung des Zeitstempels wird dies als neues Update betrachtet, aus dem zum fraglichen Zeitpunkt hervorgeht, dass das Fahrzeug nicht bewegt wurde.
Dies hat in den meisten Fällen negative Auswirkungen auf die sofortige Ankunfts- und Abfahrtsprognosen, die basierend auf der Fahrzeugposition berechnet werden. Der Grund hierfür ist, dass das Fahrzeug scheinbar nicht bewegt wurde und möglicherweise Verspätung hat. Auch zukünftige Vorhersagen für diese Fahrt sowie potenzielle künftige Fahrten werden hiervon beeinträchtigt.
Wurde das Fahrzeug tatsächlich nicht bewegt, ist alles in Ordnung. Wenn es jedoch bewegt wurde, werden dem Nutzer fehlerhafte Daten angezeigt und auch die Richtigkeit von Prognosen zur Ankunftszeit wird beeinträchtigt.
Neues Bundle wird nicht hochgeladen
Auswirkung: Mittelschwer
In diesem Fall wird ein Bundle hochgeladen (per Push-Vorgang, nicht durch Abruf), ein weiteres jedoch für längere Zeit nicht.
Je nach Feed wird weiterhin dieselbe zuletzt hochgeladene Feednachricht verarbeitet, bis alle relevanten Entitäten schließlich als veraltet gelten.
- Benachrichtigungen gelten nie als veraltet und werden so lange eingeblendet, bis entweder ein neuer Feed ohne die fragliche Entität hochgeladen oder der Feed selbst deaktiviert wird.
- Fahrtaktualisierungen werden nach 1 Stunde als nicht mehr aktuell eingestuft und sorgen in diesem Zeitraum mit großer Wahrscheinlichkeit dafür, dass die Nutzer veraltete Informationen erhalten.
- Fahrzeugpositionen gelten nach 15 Minuten als veraltet.