v5

latestOpenAPI 3.1.0Apache-2.02026-08-0212527433.1 KB
cities

ÖPNV-Haltestellen je Stadt (DELFI und HVV GTFS)

Normalisierte ÖPNV-Haltestellen einer Stadt aus dem bundesweiten DELFI-GTFS-Feed bzw. dem HVV-Feed im kanonischen Envelope. Die Daten werden offline aufbereitet und als Snapshot je Stadt gehalten, sodass der Abruf schnell antwortet, ohne den Feed pro Request zu parsen. Sonderfälle: sind beide Quellen deaktiviert, kommt 200 mit source_status="disabled"; liegt noch kein Snapshot vor, kommt 200 mit source_status="not_ingested" und leeren data, nie ein 5xx. Mit q (Namenssuche) oder near (Umkreissuche) lassen sich gezielt einzelne Haltestellen finden, statt die Vollliste abzurufen.

get/api/v1/cities/{slug}/transit

Path parameters

slugstring required

Query parameters

qstring

Case-insensitiver Substring-Filter auf den Haltestellennamen (stop_name), z.B. alsterdorf.

nearstring

"lat,lon"; liefert nur Haltestellen im Umkreis, aufsteigend nach Distanz sortiert. Ungültige Werte -> 400.

radius_minteger

Suchradius für near in Metern (Default 1000).

pageinteger

Seitennummer der Default-Paginierung ohne q/near (Default 50 Einträge, Cap 200); meta.pagination weist total/returned/limit/offset/truncated aus.

limitinteger

Einträge pro Seite der Default-Paginierung ohne q/near (Default 50, Cap 200).

Response

Transit-Envelope. data ist eine Liste von CanonicalRecord (TransitStopPayload) oder null/leer, je nach source_status ("ok"|"disabled"|"not_ingested").

Example response

{
  "data": [
    {
      "attribution": {
        "text": "Wikidata"
      }
    }
  ]
}