TripStopTimes-Request

Liefert alle Halte einer konkreten Fahrt (Trip) inklusive geplanter und ggf. realer An-/Abfahrtszeiten — typischer Use-Case: Fahrt­verlauf-Anzeige in einer App.

Endpoint

• Pfad: XML_TRIPSTOPTIMES_REQUEST
• Methode: GET

Obligatorische Parameter

Parameter	Format	Beschreibung
line	<Teilnetz>:<DIVALiniennummer>:<Ergänzung>:<Richtung>	Linien-ID der Fahrt — siehe Line-Input
stopID	Halte-ID (DHID)	Ausgangshalt der Abfrage
tripCode	String	Fahrt-Schlüssel — üblicherweise aus einer Trip-Request-Antwort übernommen
date	YYYYMMDD	Abfahrtsdatum
time	HHMM	Abfahrtszeit am stopID

Optionale Parameter

Parameter	Werte	Beschreibung
tStOTType	ALL (Default) | NEXT | PREVIOUS	Filter auf die Halte-Sequenz: alle, nur nach stopID, nur davor
useRealtime	1	Echtzeit-Daten anreichern (departureTimeEstimated, arrivalTimeEstimated, realtimeStatus)

Beispiel-Request

GET /XML_TRIPSTOPTIMES_REQUEST
    ?outputFormat=JSON
    &line=apb:05136:12b:R
    &stopID=de:05911:5494
    &tripCode=20250125-0822-196-01
    &date=20250125
    &time=0822
    &tStOTType=NEXT
    &useRealtime=1

Antwort (Beispiel)

{
  "stops": [
    {
      "id": "de:05513:1001",
      "name": "Essen Hbf",
      "arrivalTimePlanned": null,
      "departureTimePlanned": "2025-01-25T08:22:00Z",
      "departureTimeEstimated": "2025-01-25T08:24:00Z",
      "realtimeStatus": "MONITORED"
    },
    {
      "id": "de:05513:1020",
      "name": "Essen Kray",
      "arrivalTimePlanned": "2025-01-25T08:42:00Z",
      "arrivalTimeEstimated": "2025-01-25T08:43:00Z"
    }
  ]
}

JavaScript-Beispiele

Browser

async function getTripStops({ line, stopID, tripCode, date, time, direction = 'NEXT' } = {}) {
  const base = 'https://server:port/virtuellesVerzeichnis/XML_TRIPSTOPTIMES_REQUEST'
  const usp = new URLSearchParams({
    outputFormat: 'JSON',
    line,
    stopID,
    tripCode,
    date,
    time,
    tStOTType: direction,
    useRealtime: '1'
  })
  const res = await fetch(`${base}?${usp}`)
  if (!res.ok) throw new Error('HTTP ' + res.status)
  return res.json()
}

Node — nur Folgehalte

export async function getOnwardStops(trip: { line: string; stopID: string; tripCode: string; date: string; time: string }) {
  return getTripStops({ ...trip, direction: 'NEXT' })
}

Hinweise

• tripCode stammt typischerweise aus einer vorangegangenen Trip-Request-Antwort — für Ad-hoc-Abfragen ohne Routing-Kontext ist StopSeqCoord-Request die passendere Ergänzung.
• tStOTType=PREVIOUS gibt die Halte vor stopID zurück; NEXT die danach; ALL die komplette Sequenz.