IDs & Koordinaten
Konventionen für Haltestellen-IDs, Koordinatenformate und Bounding-Boxen — request-übergreifend gültig.
Haltestellen-IDs (DHID)
Die Schnittstelle nutzt global eindeutige IDs nach dem DHID-Schema (Deutsche Haltestellen-ID):
de:<Gemeindeschlüssel>:<lokaleId>[:<Steig>[:<Bereich>]]| Bestandteil | Beispiel | Bedeutung |
|---|---|---|
de | de | Länderpräfix |
<Gemeindeschlüssel> | 05911 | Amtlicher Gemeindeschlüssel (AGS) |
<lokaleId> | 5494 | lokaler Haltepunkt |
<Steig> | 51 | optional: konkreter Bahnsteig/Steig |
<Bereich> | 1 | optional: Bereich innerhalb eines Steigs |
TIP
Für Auskunfts-Requests genügt die dreistellige Form (de:05911:5494). Nur Steig/Bereich anhängen, wenn ein konkreter Abfahrtsort gemeint ist.
Koordinatenformat WGS84[dd.ddddd]
Standardformat der Schnittstelle. Zwei Schreibweisen:
- Als Parameterwert:
<x>:<y>:WGS84[dd.ddddd] - In JSON-Antworten: meist
{ "lat": …, "lon": … }oder als Tupel[lat, lon]
Für Kartenbibliotheken (Mapbox GL, Leaflet GeoJSON) muss die Tupel-Reihenfolge oft zu [lon, lat] invertiert werden:
const toGeoJson = ([lat, lon]) => [lon, lat]Weitere unterstützte Formate (z. B. GK4, MRCV) sind deployment-spezifisch — für Neuanbindungen immer WGS84[dd.ddddd].
Punkt-Eingabe mit Koordinate
Im Point-Input-Schema:
type_<usage>=coord&name_<usage>=<x>:<y>:WGS84[dd.ddddd][:<FreeText>]Details: Point-Input.
Bounding-Boxen
CoordInfo und Geoobject akzeptieren alternativ eine Bounding-Box:
| Parameter | Format |
|---|---|
boundingBox | (Flag ohne Wert) |
boundingBoxLU | <x>:<y>:WGS84[dd.ddddd] — linke obere Ecke |
boundingBoxRL | <x>:<y>:WGS84[dd.ddddd] — rechte untere Ecke |
NOTE
Eine Bounding-Box ist immer dann vorzuziehen, wenn der Kartenausschnitt bereits feststeht — spart den Kompromiss zwischen Radius und Bildschirmdiagonale.
Linien- und Richtungs-IDs
Siehe Line-Input für das vollständige Schema <Teilnetz>:<DIVALiniennummer>:<Ergänzung>:<Richtung>.
Zeit- und Datumsformate
Siehe Datum & Uhrzeit für die vollständige Parameter-Familie itdDate* / itdTime* / timeOffset.