TripStopTimes-Request
Gibt die von einer konkreten Fahrt durchfahrenen Haltestellen mit geplanten/realen Zeiten zurück.
Endpoint
- Pfad:
XML_TRIPSTOPTIMES_REQUEST
- Methode: GET
Parameter (Auszug)
Parameter | Typ | Beschreibung |
---|---|---|
tripId | string | Eindeutige Fahrt-ID |
includeRealtime | 0/1 | Echtzeit hinzufügen |
Beispiel-Request
GET /XML_TRIPSTOPTIMES_REQUEST?tripId=1|VRR|12345|67890&includeRealtime=1
Antwort (Beispiel)
json
{
"stops": [
{ "id": "de:05513:1001", "name": "Essen Hbf", "schedDep": "08:22", "rtDep": "08:24" },
{ "id": "de:05513:1010", "name": "Ziel", "schedArr": "08:45", "rtArr": "08:46" }
]
}
JavaScript-Beispiel
js
async function getTripStopTimes(tripId, includeRealtime = 1) {
const base = 'https://server:port/virtuellesVerzeichnis/XML_TRIPSTOPTIMES_REQUEST'
const usp = new URLSearchParams({ tripId, includeRealtime: String(includeRealtime) })
const res = await fetch(`${base}?${usp}`)
if (!res.ok) throw new Error('HTTP ' + res.status)
return res.json()
}
title: TripStopTimes-Request (Durchfahrene Haltestellen) outline: deep
TripStopTimes-Request
Liefert alle Halte einer konkreten Fahrt (Trip) inklusive geplanter/realer An- und Abfahrtszeiten.
Endpoint
- Pfad:
XML_TRIPSTOPTIMES_REQUEST
- Methode: GET
Parameter (Auszug)
Parameter | Typ | Beschreibung |
---|---|---|
tripId | string | Eindeutige Trip-/Fahrt-ID |
date | string | Datum YYYYMMDD (optional, falls in Trip-ID kodiert) |
includeRealtime | 0/1 | Echtzeit berücksichtigen |
Beispiel-Request
GET /XML_TRIPSTOPTIMES_REQUEST?tripId=1|196|K|08:20|20250125&includeRealtime=1
Antwort (Beispiel)
json
{
"stops": [
{ "id": "de:05513:1001", "name": "Essen Hbf", "arr": null, "dep": "08:20", "rtDep": "08:22" },
{ "id": "de:05513:1020", "name": "Essen Kray", "arr": "08:42", "rtArr": "08:43" }
]
}
JavaScript-Beispiel
js
async function getTripStops(tripId, { date, includeRealtime = 1 } = {}) {
const base = 'https://server:port/virtuellesVerzeichnis/XML_TRIPSTOPTIMES_REQUEST'
const usp = new URLSearchParams({ tripId, includeRealtime: String(includeRealtime) })
if (date) usp.set('date', date)
const res = await fetch(`${base}?${usp}`)
if (!res.ok) throw new Error('HTTP ' + res.status)
return res.json()
}