Point-Input
Fast jeder EFA-Request, der eine Haltestelle, Adresse, POI oder Koordinate als Ein- oder Ausgangspunkt braucht, verwendet dasselbe Parameterschema mit einem Usage-Suffix _<usage>. Diese Seite ist die einzige Quelle der Wahrheit — Endpoint-Seiten verlinken hierher.
Obligatorische Parameter
| Parameter | Beschreibung |
|---|---|
name_<usage> | Haltestellen-/Punkt-ID, Koordinate oder freier Suchtext (je nach type_<usage>) |
type_<usage> | any für ID/Suchtext, coord für Koordinateneingabe |
Gängige <usage>-Werte
| Suffix | Verwendet in |
|---|---|
origin | Trip, PS — Startpunkt |
destination | Trip, PS — Zielpunkt |
via | Trip, PS — Zwischenhalt (Aktivierung siehe Endpoint) |
sf | StopFinder |
sl | ServingLines (wenn mode=odv) |
dm | DM-Request |
ss | DMTTP-Request |
stt | StopTimetable |
ID-Eingabe
type_origin=any&name_origin=de:05911:5494IDs folgen dem DHID-Schema — siehe IDs & Koordinaten.
Koordinaten-Eingabe
type_<usage>=coord&name_<usage>=<x>:<y>:<CoordFormat>[:<FreeText>]<x>:<y>— Koordinaten im angegebenen Format<CoordFormat>— meistWGS84[dd.ddddd]<FreeText>— optionaler Bezeichner; ohne Angabe snappt der Server auf die nächste Straße
name_origin=6787835:51231000:WGS84[dd.ddddd]
name_origin=6787835:51231000:WGS84[dd.ddddd]:ein schöner OrtOptionale Parameter
| Parameter | Werte | Beschreibung |
|---|---|---|
deleteAssignedStops_<usage> | 1 | Keine umliegenden Haltestellen in der Antwort |
nameInfo_<usage> | ID oder invalid | Überschreibt name_<usage> bzw. deaktiviert |
typeInfo_<usage> | any, coord, invalid | Überschreibt type_<usage> bzw. deaktiviert |
Freitext-Suche (StopFinder-Kontext)
Wenn name_sf ein freier Suchtext ist (keine ID, keine Koordinate), muss type_sf=any gesetzt werden. Der StopFinder verifiziert den Text und liefert eine Trefferliste. Die verifizierte ID wird anschließend in Folge-Requests (z. B. DM, Trip) unter dem passenden Usage-Suffix übergeben.
Hinweise
- Bei fehlender Verifikation (mehrere Treffer oder unklarer Text) liefert der Server eine Liste zurück — zuerst auflösen, dann die resultierende ID weiterverwenden.
- In Kartenanwendungen kann der optionale
FreeText-Teil der Koordinate als angezeigter Name dienen (z. B. „Eigene Position").