Kartenbilder für E-Mails, Dokumente und Inserate.
Ein fertiges Kartenbild von jedem Ort, mit Ihren Markern und Routen. Es funktioniert überall, wo ein normales Bild funktioniert: in Buchungsmails, PDFs, im Druck und in Suchergebnissen.
Marker, Routen und Flächen auf der Karte.
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.
Marker
Ein oder viele Pins, mit dem Standardmarker oder Ihrem eigenen Symbol. Die Karte wählt den Ausschnitt automatisch.
Routen
Eine Linie entlang der Route, in eigener Farbe und Breite, mit Pfeilen, die die Richtung zeigen.
Flächen
Linien und Flächen aus einer Datei, etwa die Grenze eines Landes oder die Umrisse eines Skigebiets.
Sieben Kartenstile zur Auswahl.
Jedes Bild unten zeigt denselben Ort. Nur der Stil ist anders, von Outdoor-Karten bis zu einem ruhigen hellen oder dunklen Hintergrund.
Summer
Winter
Hiking
Cycling
Street
Light
Dark
Eine Webadresse pro Karte.
Jede Karte ist eine Webadresse (URL), die Ort, Größe, Stil und Inhalt beschreibt. Ihr System füllt sie aus, und die API liefert das Bild.
https://staticmap.maptoolkit.net/
?center=47.8005,13.0438
&zoom=15
&size=480x200
&style=maptoolkit-maptoolkit.summer
&marker=center:47.8005,13.0438
&format=webp
&api_key=YOUR_API_KEYDie Anfrage liefert das Kartenbild mit dem Marker, fertig zum Einfügen in eine E-Mail.
PNG, JPEG oder WebP
Das Bild kommt im Format, das Sie brauchen. Standard ist PNG.
Bis zu 4096 x 4096 Pixel
Vom kleinen Vorschaubild bis zum großen Headerbild.
Scharf auf jedem Bildschirm
Doppelte oder vierfache Pixeldichte für hochauflösende Displays (ratio).
Passend zu einem Gebiet
Geben Sie statt Mittelpunkt und Zoom eine Region an, und die Karte zeigt genau diesen Ausschnitt (bounds, bbox).
Lange Routen per POST
Sehr lange Routen oder Flächen können Sie im Request-Body statt in der URL senden.
Zwei Stunden im Cache
Eine einmal angefragte Karte kommt standardmäßig zwei Stunden lang aus dem Cache (exptime).
Wo Kartenbilder zum Einsatz kommen.
Überall dort, wo eine Live-Karte zu viel wäre oder gar nicht funktioniert. Drei typische Beispiele:
Suchergebnisse und Inserate
Jedes Ergebnis in einer Liste bekommt eine eigene kleine Karte, so sieht man sofort, wo es liegt.
Tourenblätter und PDFs
Gedruckte Reisepläne und Tourenbeschreibungen zeigen die Route jedes Tages.
Zusammenfassungen in Apps
Ein Bild der Route in einer Aktivitätsübersicht, einer Benachrichtigung oder einem geteilten Beitrag.
Alle Karten auf dieser Seite sind Bilder aus der Static Maps API.
Fragen zu statischen Karten.
Kurze Antworten zu Quellenangaben, Caching, mehreren Routen auf einer Karte und Interaktivität.
Enthält das Kartenbild die Quellenangabe?
Ja. Standardmäßig zeichnet die API eine kleine Quellenangabe für Maptoolkit und OpenStreetMap in die Ecke des Bildes, so trägt 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ähe der Karten.
Wie bekomme ich ein neues Bild statt des gecachten?
Eine Karte bleibt standardmäßig zwei Stunden im Cache, und in dieser Zeit liefert dieselbe Webadresse dasselbe Bild. Für eine eigene Cache-Dauer ergänzen Sie exptime mit einem Wert in Sekunden, zum Beispiel exptime=600 für zehn Minuten. Mit exptime=-1 umgehen Sie den Cache für eine einzelne Anfrage, das hilft beim Testen von Änderungen.
Kann ich mehrere Routen und Marker auf einer Karte zeigen?
Ja. Wiederholen Sie den Parameter marker für jeden Pin und den Parameter path oder geojson für 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.
Kann man eine statische Karte zoomen oder verschieben?
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.
Ihr Anwendungsfall auf einer Maptoolkit-Karte.
In der Demo führt Sie einer unserer Entwickler durch die Plattform, Ihre Daten und den Wechsel von Ihrem bisherigen Anbieter.