Übersichtspläne (Netzpläne & Kartenmarker)

Inhaltsverzeichnis

Collections: network-maps, map-markers

Ein Netzplan (NetworkMap) ist die visuelle Darstellung eines Verkehrsnetzes, z. B. ein Liniennetzplan.

Netzplan aller Bahnstationen in Berlin-Brandenburg, mit markierten Aufzugsstörungen.

Kartenmarker (MapMarker) verorten auf einem solchen Plan Objekte – wie Aufzüge, Haltestellen, Betriebszustände oder Organisationen.

Karten und Marker sind jeweils als Collections über die API abrufbar und werden auf dieser Seite gemeinsam beschrieben.


NetworkMap (Netzplan)

Collection: network-maps

Ein Netzplan bündelt ein Planbild (bevorzugt SVG) mit Metadaten und einer optionalen Georeferenzierung, sodass Weltkoordinaten auf Bildkoordinaten abgebildet werden können.

Allgemein

Feld

Typ

Beschreibung

published_by

Relation

Herausgebende Organisation (Verweis auf schema-organizations).

name

Text

Anzeigename des Netzplans.

description

Text

Kurzbeschreibung des Plans.

valid_from

Datum

Beginn des Gültigkeitszeitraums (optional).

valid_until

Datum

Ende des Gültigkeitszeitraums (optional).

source_url

Text

URL der Originalquelle des Plans.

Bild

Feld

Typ

Beschreibung

mapImageFile

Upload (media)

Bilddatei des Netzplans; SVG wird bevorzugt.

Koordinatensystem

Über das Koordinatensystem lässt sich das Planbild georeferenzieren: Die Weltkoordinaten der Eckpunkte werden mit der Anzeigefläche des Bildes verknüpft.

Feld

Typ

Beschreibung

coordinate_description

Textarea

Zusätzliche Angaben zum Koordinatensystem oder -format, falls erforderlich.

world_coordinates.crs

Enum

Koordinatenreferenzsystem als EPSG-Code: EPSG:4326 (WGS 84) oder EPSG:3857 (Web Mercator).

world_coordinates.northwest_corner

Koordinate

Nordwest-Eckpunkt des Plans als Längen-/Breitengrad (X/Y).

world_coordinates.southeast_corner

Koordinate

Südost-Eckpunkt des Plans als Längen-/Breitengrad (X/Y).

display_coordinates.units

Enum

CSS-Einheit der Anzeigefläche: px, pt, in, cm oder mm.

display_coordinates.width

Zahl

Intrinsische Breite der Anzeigefläche des Bildes.

display_coordinates.height

Zahl

Intrinsische Höhe der Anzeigefläche des Bildes.

MapMarker (Kartenmarker)

Collection: map-markers

Ein Kartenmarker verknüpft ein Objekt (subject) mit einer Position auf einem Netzplan (map). Die Position wird je nach Koordinatenmodus als Weltkoordinate oder als Anzeigekoordinate des Bildes interpretiert.

Felder

Feld

Typ

Beschreibung

subject

Relation (polymorph)

Verknüpftes Objekt: elevators, stop-places, status-spans oder schema-organizations.

map

Relation

Zugehöriger Netzplan (Verweis auf network-maps).

coordinate_mode

Enum

„world“ = Breiten-/Längengrad im KRS des Plans; „display“ = X/Y-Anzeigekoordinaten in der Anzeigefläche des Plans.

latitude

Zahl

Breitengrad (Modus „world“) bzw. Y-Wert (Modus „display“).

longitude

Zahl

Längengrad (Modus „world“) bzw. X-Wert (Modus „display“).

name

Text

Automatisch aus dem Subjekt erzeugter Anzeigename (schreibgeschützt).

API-Zugriff

Beide Collections sind über die REST-API erreichbar. Der Zugriff wird über API-Token-Berechtigungen (Scopes) gesteuert:

  • network_maps:read – Netzpläne lesen; network_maps:write – Netzpläne anlegen und ändern.
  • map_markers:read – Kartenmarker lesen; map_markers:write – Kartenmarker anlegen und ändern.

Ein Schreib-Scope schließt den zugehörigen Lese-Zugriff mit ein. Der Token wird als Bearer-Token im Authorization-Header übergeben.

# Netzpläne auflisten
curl -H "Authorization: Bearer <TOKEN>" \
  "https://transit.accessibility.cloud/api/network-maps"

# Einzelnen Netzplan abrufen
curl -H "Authorization: Bearer <TOKEN>" \
  "https://transit.accessibility.cloud/api/network-maps/<ID>"

# Kartenmarker eines Netzplans abrufen
curl -H "Authorization: Bearer <TOKEN>" \
  "https://transit.accessibility.cloud/api/map-markers?where[map][equals]=<ID>"