Zum Inhalt springen

Statische Karten: Karte als Bild für Berichte, E-Mails und Exposés

Die Static-Images-API rendert ein Kartenbild für einen Ausschnitt und eine Größe, auf Wunsch mit Pins, Linien und Flächen. Das Ergebnis ist ein PNG oder WebP, das du per URL in PDFs, E-Mails, Exposés oder Vorschauen einbindest. Sie richtet sich an Entwickler, die dort eine Karte brauchen, wo keine interaktive Karte möglich ist.

Was die Schnittstelle kann

  • GET /v1/static/{style}/{view}/{size}: Kartenbild ohne Overlay. view ist lon,lat,zoom[,bearing], size ist Breite mal Höhe, zum Beispiel 600x400, mit optionalem @2x und Endung .png oder .webp.
  • GET /v1/static/{style}/{overlay}/{view}/{size}: Kartenbild mit Overlays. Pins (pin-s+ff0000(lon,lat)), Pfade (kodierte Polyline) und GeoJSON mit einfachen Stilangaben, bis zu 50 Overlays.
  • Mit auto statt der Ansicht passt sich der Ausschnitt den Overlays an.
  • Stile: streets, streets-dawn, streets-dusk, streets-night, satellite (Orthofoto), satellite-streets und outdoors (Höhenlinien mit Schummerung).

Beispiel

Luftbild von Wien als Bild:

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/static/satellite/16.3725,48.2085,15/600x400" -o result.png

Straßenkarte mit einem roten Pin:

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/static/streets/pin-s%2Bff0000(16.3725,48.2085)/16.3725,48.2085,14/600x400" -o result.png

In einer HTML-Seite oder E-Mail steht der Token in der URL (access_token), weil Bilder keine Header senden. Dafür einen öffentlichen Token verwenden:

<img alt="Wiener Innenstadt" width="600" height="400"
     src="https://api.mapx.at/v1/static/streets/16.3725,48.2085,14/600x400.png?access_token=YOUR_TOKEN">

Woher die Daten kommen

Die Bilder werden aus denselben amtlichen Daten gerendert wie die interaktive Karte: die Straßenstile aus der Vektor-Basiskarte, satellite aus dem Orthofoto des BEV, outdoors aus dem Geländemodell des BEV. Die Daten stehen unter CC BY 4.0.

Einschränkungen

  • Nur Österreich.
  • Höchstens 1280 mal 1280 Pixel, mit @2x bis 2560 mal 2560. Die Neigung (Pitch) ist immer 0.
  • Zoomstufen: satellite von 5 bis 18, outdoors von 5 bis 16.
  • Bilder liegen in der Zone heavy mit 30 Anfragen pro Minute je Token. Bilder sind cachebar (ETag, 304): speichere sie auf deiner Seite zwischen und fordere sie nicht bei jedem Seitenaufruf neu an.
  • Die Quelle muss neben dem Bild sichtbar stehen, zum Beispiel als Zeile Quelle: BEV, CC BY 4.0. Den Text je Datensatz findest du in der Doku zur Quellenangabe.

Loslegen

Der Zugang ist kostenlos mit Konto und Token. Alle Parameter und Overlay-Formate stehen im Guide zu statischen Bildern und in der Referenz zur Static-Images-API.