Die Fahrzeugposition wird verwendet, um automatisch generierte Informationen zum Standort eines Fahrzeugs bereitzustellen, etwa von einem GPS-Gerät an Bord. Für jedes Fahrzeug, das seine Position senden kann, sollte eine Fahrzeugposition angegeben werden.
Die aktuelle Fahrt des Fahrzeugs sollte durch eine Fahrtbeschreibung identifiziert werden. Sie können auch eine Fahrzeugbeschreibung angeben, um ein genaues Fahrzeug festzulegen, für das Sie Updates bereitstellen. Die entsprechende Dokumentation finden Sie unten.
Es kann ein Zeitstempel bereitgestellt werden, der angibt, wann die Position ermittelt wurde. Dieser Wert ist nicht mit dem Zeitstempel im Feed-Header identisch, der angibt, wann diese Nachricht vom Server generiert wurde.
Der aktuelle Abschnitt kann ebenfalls angegeben werden (als stop_sequence oder stop_id). Dies ist ein Verweis auf die Haltestelle, zu der das Fahrzeug unterwegs ist oder an der es bereits gehalten hat.
Position
Das Feld position enthält die Standortdaten innerhalb von VehiclePosition. Längen- und Breitengrad sind Pflichtangaben, alle anderen Felder sind optional. Die Datentypen sind:
- Breitengrad: Grad nördlicher Breite im WGS-84-Koordinatensystem
- Längengrad: Grad östlicher Länge im WGS-84-Koordinatensystem
- Richtung: Richtung, in die das Fahrzeug zeigt
- Kilometerzähler: Strecke, die das Fahrzeug zurückgelegt hat
- Geschwindigkeit: Aktuelle Geschwindigkeit des Fahrzeugs in Metern pro Sekunde
Stauneigung
Über die Fahrzeugposition kann der Betreiber auch die aktuelle Stauneigung des Verkehrsnetzes für das Fahrzeug angeben. Die Stauneigung kann in folgende Kategorien eingeordnet werden:
- Unbekannte Stauneigung
- Reibungsloser Verkehr
- Stop-and-go-Verkehr
- Überlastung
- Starke Überlastung
Die verschiedenen Stauneigungsstufen müssen vom jeweiligen Verkehrsverbund klassifiziert werden. Wir empfehlen, die Kategorie „Starke Überlastung“ nur in Fällen zu verwenden, in denen die Menschen aufgrund der Überlastung ihr Auto verlassen.
Auslastung
Über die Fahrzeugposition kann der Betreiber auch Angaben zur Passagierauslastung des Fahrzeugs machen. Die Auslastung kann in folgende Kategorien eingeordnet werden:
- Leer
- Viele freie Sitzplätze
- Wenige freie Sitzplätze
- Nur Stehplätze
- Stehplätze knapp
- Voll
- Keine weiteren Passagiere
Dieses Feld ist noch experimentell und kann sich ändern. Es wird unter Umständen in der Zukunft offiziell eingeführt.
VehicleStopStatus
Der Haltestatus eines Fahrzeugs macht den Status eines Fahrzeugs aussagekräftiger, wenn es sich gerade einer Haltestelle nähert oder sich bereits dort befindet. Dieser Status kann einen dieser Werte haben.
- Ankunft an. Das Fahrzeug wird bald an der angegebenen Haltestelle ankommen.
- Angehalten an: Das Fahrzeug hält derzeit an der angegebenen Haltestelle.
- Unterwegs nach (Standard): Die angegebene Haltestelle ist die nächste Haltestelle für das Fahrzeug.
Fahrzeugbeschreibung
Mit der Fahrzeugbeschreibung wird ein genaues Fahrzeug definiert. Sie kann beliebige der folgenden Attribute enthalten:
- ID: Internes System zur Identifikation des Fahrzeugs. Dieser Wert sollte für das Fahrzeug eindeutig sein.
- Label: Ein für den Nutzer sichtbares Label, etwa der Name eines Zugs
- Kennzeichen: Das Kfz-Kennzeichen des Fahrzeugs