Skip to content

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

ParameterBeschreibung
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

SuffixVerwendet in
originTrip, PS — Startpunkt
destinationTrip, PS — Zielpunkt
viaTrip, PS — Zwischenhalt (Aktivierung siehe Endpoint)
sfStopFinder
slServingLines (wenn mode=odv)
dmDM-Request
ssDMTTP-Request
sttStopTimetable

ID-Eingabe

type_origin=any&name_origin=de:05911:5494

IDs 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> — meist WGS84[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 Ort

Optionale Parameter

ParameterWerteBeschreibung
deleteAssignedStops_<usage>1Keine 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").