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.viewistlon,lat,zoom[,bearing],sizeist Breite mal Höhe, zum Beispiel600x400, mit optionalem@2xund Endung.pngoder.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
autostatt der Ansicht passt sich der Ausschnitt den Overlays an. - Stile:
streets,streets-dawn,streets-dusk,streets-night,satellite(Orthofoto),satellite-streetsundoutdoors(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.pngStraß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.pngIn 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
@2xbis 2560 mal 2560. Die Neigung (Pitch) ist immer 0. - Zoomstufen:
satellitevon 5 bis 18,outdoorsvon 5 bis 16. - Bilder liegen in der Zone
heavymit 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.