ServingLines-Request

Ermittelt Linien — entweder anhand einer Haltestelle (Bedienungslinien) oder anhand eines Liniennamens (direkte Linienauswahl).

Endpoint

• Pfad: XML_SERVINGLINES_REQUEST
• Methode: GET

Obligatorische Parameter

Parameter	Werte	Beschreibung
mode	odv | line	Suchmodus: über Haltestelle (odv) oder über Liniennamen (line)
lineReqType	Bitmaske	Linientypen — additive Flags 2 (STT), 4 (TTB), 8 (ROB), 16 (StationTT); 0 = alle

Wenn mode=odv (Liniensuche über Haltestelle)

Zusätzlich Point-Input mit Suffix _sl:

mode=odv&type_sl=any&name_sl=de:05911:5494

Wenn mode=line (direkte Liniensuche)

Parameter	Beschreibung
lineName	Publikums-Bezeichnung der Linie (z. B. 196)

Beispiel-Request

GET /XML_SERVINGLINES_REQUEST?outputFormat=JSON&mode=odv&lineReqType=0&type_sl=any&name_sl=de:05911:5494

GET /XML_SERVINGLINES_REQUEST?outputFormat=JSON&mode=line&lineReqType=2&lineName=196

Antwort (Beispiel)

{
  "servingLines": [
    { "name": "196", "number": "196", "mot": 5, "direction": "Essen Kray" },
    { "name": "RE2", "number": "RE2", "mot": 13, "direction": "Düsseldorf Hbf" }
  ]
}

Die mot-ID verweist auf Verkehrsmittel-IDs.

JavaScript-Beispiele

Browser — über Halt

async function getServingLinesByStop(stopId) {
  const base = 'https://server:port/virtuellesVerzeichnis/XML_SERVINGLINES_REQUEST'
  const usp = new URLSearchParams({
    outputFormat: 'JSON',
    mode: 'odv',
    lineReqType: '0',
    type_sl: 'any',
    name_sl: stopId
  })
  const res = await fetch(`${base}?${usp}`)
  if (!res.ok) throw new Error('HTTP ' + res.status)
  return res.json()
}

Browser — über Name

async function getServingLineByName(lineName) {
  const base = 'https://server:port/virtuellesVerzeichnis/XML_SERVINGLINES_REQUEST'
  const usp = new URLSearchParams({
    outputFormat: 'JSON',
    mode: 'line',
    lineReqType: '0',
    lineName
  })
  const res = await fetch(`${base}?${usp}`)
  if (!res.ok) throw new Error('HTTP ' + res.status)
  return res.json()
}

Hinweise

• Soll nur eine Verkehrsart angezeigt werden, ist die Kombination lineReqType + exclMOT_<ID> stabiler als alleinige lineReqType-Filterung.
• Für die komplette Haltestellenliste einer Linie nicht diesen Endpoint verwenden, sondern LineStop-Request.