{"id":7986,"date":"2026-11-02T12:07:29","date_gmt":"2026-11-02T12:07:29","guid":{"rendered":"https:\/\/staging.maptoolkit.com\/api\/static-maps-api\/"},"modified":"2026-11-06T15:49:09","modified_gmt":"2026-11-06T15:49:09","slug":"static-maps-api","status":"publish","type":"page","link":"https:\/\/staging.maptoolkit.com\/de\/api\/static-maps-api\/","title":{"rendered":"Static Maps API"},"content":{"rendered":"\n
\n
\n
\nStatic Maps API<\/span>\n\n

Kartenbilder f\u00fcr E-Mails, Dokumente und Inserate.<\/mark><\/h1>\n\n

Ein fertiges Kartenbild von jedem Ort, mit Ihren Markern und Routen. Es funktioniert \u00fcberall, wo ein normales Bild funktioniert: in Buchungsmails, PDFs, im Druck und in Suchergebnissen.<\/p>\n\n

\n
\nDemo buchen<\/a>\n\n<\/svg><\/span>Zur Dokumentation<\/span><\/a>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
<\/span><\/span><\/span>Posteingang<\/span><\/div>
<\/span>Ihre Buchung ist best\u00e4tigt<\/span><\/span><\/span><\/div>
Ihr Aufenthalt in Salzburg<\/span><\/span><\/span>\"\"Route anzeigen<\/span><\/span><\/span><\/div><\/div><\/div>\n<\/figure>\n<\/div>\n<\/section>\n\n
\n
\n
\nIhre Orte und Routen<\/span>\n\n

Marker, Routen und Fl\u00e4chen auf der Karte.<\/mark><\/h2>\n\n

Markieren Sie eine Adresse oder viele Orte, zeichnen Sie eine Route oder die Umrisse einer Region ein. Alles wird direkt ins Bild gezeichnet, in Ihren Farben.<\/p>\n<\/div>\n\n

\n
\n\"Karte
\n\n
\n

Marker<\/h3>\n\n

Ein oder viele Pins, mit dem Standardmarker oder Ihrem eigenen Symbol. Die Karte w\u00e4hlt den Ausschnitt automatisch.<\/p>\n<\/div>\n<\/div>\n\n

\n\"Karte
\n\n
\n

Routen<\/h3>\n\n

Eine Linie entlang der Route, in eigener Farbe und Breite, mit Pfeilen, die die Richtung zeigen.<\/p>\n<\/div>\n<\/div>\n\n

\n\"Karte
\n\n
\n

Fl\u00e4chen<\/h3>\n\n

Linien und Fl\u00e4chen aus einer Datei, etwa die Grenze eines Landes oder die Umrisse eines Skigebiets.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n

\n
\n
\nKartenstile<\/span>\n\n

Sieben Kartenstile zur Auswahl.<\/mark><\/h2>\n\n

Jedes Bild unten zeigt denselben Ort. Nur der Stil ist anders, von Outdoor-Karten bis zu einem ruhigen hellen oder dunklen Hintergrund.<\/p>\n<\/div>\n\n

\n
\n\"Kartenstil
\n\n

Summer<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Winter<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Hiking<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Cycling<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Street<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Light<\/h3>\n<\/figure>\n\n
\n\"Kartenstil
\n\n

Dark<\/h3>\n<\/figure>\n<\/div>\n\n
\n<\/svg><\/span>Die Stile auf der Live-Karte vergleichen<\/span><\/a>\n<\/div>\n<\/div>\n<\/section>\n\n
\n
\n
\n
\nF\u00fcr Entwickler<\/span>\n\n

Eine Webadresse pro Karte.<\/mark><\/h2>\n\n

Jede Karte ist eine Webadresse (URL), die Ort, Gr\u00f6\u00dfe, Stil und Inhalt beschreibt. Ihr System f\u00fcllt sie aus, und die API liefert das Bild.<\/p>\n\n

\n<\/svg><\/span>Static Maps API Referenz<\/span><\/a>\n<\/div>\n<\/div>\n\n
\n
\nDie Karte aus der E-Mail oben<\/span>
https:\/\/staticmap.maptoolkit.net\/\n  ?<\/span>center<\/span>=<\/span>47.8005,13.0438<\/span>\n  &<\/span>zoom<\/span>=<\/span>15<\/span>\n  &<\/span>size<\/span>=<\/span>480x200<\/span>\n  &<\/span>style<\/span>=<\/span>maptoolkit-maptoolkit.summer<\/span>\n  &<\/span>marker<\/span>=<\/span>center:47.8005,13.0438<\/span>\n  &<\/span>format<\/span>=<\/span>webp<\/span>\n  &<\/span>api_key<\/span>=<\/span>YOUR_API_KEY<\/span><\/code><\/pre>\n<\/div>\n\n
Die Anfrage liefert das Kartenbild mit dem Marker, fertig zum Einf\u00fcgen in eine E-Mail.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
\n<\/svg><\/span><\/span>\n\n
\n
PNG, JPEG oder WebP<\/h3>\n\n
Das Bild kommt im Format, das Sie brauchen. Standard ist PNG.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Bis zu 4096 x 4096 Pixel<\/h3>\n\n
Vom kleinen Vorschaubild bis zum gro\u00dfen Headerbild.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Scharf auf jedem Bildschirm<\/h3>\n\n
Doppelte oder vierfache Pixeldichte f\u00fcr hochaufl\u00f6sende Displays (ratio).<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Passend zu einem Gebiet<\/h3>\n\n
Geben Sie statt Mittelpunkt und Zoom eine Region an, und die Karte zeigt genau diesen Ausschnitt (bounds, bbox).<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Lange Routen per POST<\/h3>\n\n
Sehr lange Routen oder Fl\u00e4chen k\u00f6nnen Sie im Request-Body statt in der URL senden.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Zwei Stunden im Cache<\/h3>\n\n
Eine einmal angefragte Karte kommt standardm\u00e4\u00dfig zwei Stunden lang aus dem Cache (exptime).<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n
\n
\n
\nAnwendungsf\u00e4lle<\/span>\n\n
Wo Kartenbilder zum Einsatz kommen.<\/mark><\/h2>\n\n
\u00dcberall dort, wo eine Live-Karte zu viel w\u00e4re oder gar nicht funktioniert. Drei typische Beispiele:<\/p>\n<\/div>\n\n
\n\n
<\/span><\/span><\/span><\/span><\/div>
Wohnungen in Wien<\/span><\/span><\/span><\/span><\/span><\/div>
\"\"<\/span><\/span><\/span>\"\"<\/span><\/span><\/span>\"\"<\/span><\/span><\/span>\"\"<\/span><\/span><\/span>\"\"<\/span><\/span><\/span>\"\"<\/span><\/span><\/span><\/div><\/div><\/div><\/div><\/div>\n\n
\n
Suchergebnisse und Inserate<\/svg><\/span><\/h3>\n\n
Jedes Ergebnis in einer Liste bekommt eine eigene kleine Karte, so sieht man sofort, wo es liegt.<\/p>\n<\/div>\n<\/a>\n\n\n
Tag 2: Nordkette<\/span>4,1 km, 1.075 m Aufstieg<\/span>\"\"<\/span><\/span><\/span><\/div><\/div>\n\n
\n
Tourenbl\u00e4tter und PDFs<\/svg><\/span><\/h3>\n\n
Gedruckte Reisepl\u00e4ne und Tourenbeschreibungen zeigen die Route jedes Tages.<\/p>\n<\/div>\n<\/a>\n\n\n
Ihre Fahrt<\/div>
\"\"
Innsbruck nach Hall in Tirol<\/span>11,1 km<\/span>40 min<\/span><\/span><\/div><\/div><\/div><\/div><\/div><\/div>\n\n
\n
Zusammenfassungen in Apps<\/svg><\/span><\/h3>\n\n
Ein Bild der Route in einer Aktivit\u00e4ts\u00fcbersicht, einer Benachrichtigung oder einem geteilten Beitrag.<\/p>\n<\/div>\n<\/a>\n<\/div>\n\n
\n
Alle Karten auf dieser Seite sind Bilder aus der Static Maps API.<\/p>\n<\/div>\n<\/div>\n<\/section>\n\n
\n
\n
\n
\nFragen und Antworten<\/span>\n\n
Fragen zu statischen Karten.<\/mark><\/h2>\n\n
Kurze Antworten zu Quellenangaben, Caching, mehreren Routen auf einer Karte und Interaktivit\u00e4t.<\/p>\n<\/div>\n\n
\n
\n
\n
Enth\u00e4lt das Kartenbild die Quellenangabe?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Ja. Standardm\u00e4\u00dfig zeichnet die API eine kleine Quellenangabe f\u00fcr Maptoolkit und OpenStreetMap in die Ecke des Bildes, so tr\u00e4gt eine Karte in einer E-Mail oder einem PDF ihre eigene Quellenangabe. Mit attribution=false schalten Sie sie ab, etwa wenn mehrere Karten in einem Dokument stehen. Statische Bilder brauchen genauso eine Quellenangabe wie interaktive Karten, setzen Sie dann eine sichtbare Quellenangabe in die N\u00e4he der Karten.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
Wie bekomme ich ein neues Bild statt des gecachten?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Eine Karte bleibt standardm\u00e4\u00dfig zwei Stunden im Cache, und in dieser Zeit liefert dieselbe Webadresse dasselbe Bild. F\u00fcr eine eigene Cache-Dauer erg\u00e4nzen Sie exptime mit einem Wert in Sekunden, zum Beispiel exptime=600 f\u00fcr zehn Minuten. Mit exptime=-1 umgehen Sie den Cache f\u00fcr eine einzelne Anfrage, das hilft beim Testen von \u00c4nderungen.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
Kann ich mehrere Routen und Marker auf einer Karte zeigen?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Ja. Wiederholen Sie den Parameter marker f\u00fcr jeden Pin und den Parameter path oder geojson f\u00fcr jede Linie. Jede bekommt ihre eigene Farbe und Breite. Farben sind achtstellige Hex-Werte mit der Transparenz am Ende: FF0000FF ist deckendes Rot, FF000066 ein durchscheinendes Rot. Sechsstellige Hex-Werte und Farbnamen funktionieren nicht.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
Kann man eine statische Karte zoomen oder verschieben?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Nein. Die API liefert ein fertiges Bild, es gibt also nichts zu zoomen, zu verschieben oder anzuklicken. Deshalb funktioniert es in E-Mails, PDFs und Benachrichtigungen, wo keine Skripte laufen. Wenn Nutzer die Karte selbst erkunden sollen, verwenden Sie die Vector Tiles API oder die Raster Tiles API, mit denen Sie eine interaktive Karte auf Ihrer Website oder in Ihrer App einbinden.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n