Static Maps API

Willkommen zur Dokumentation der SmartMaps Static Maps REST API. Dieser Dienst ermöglicht es Ihnen, statische Karten für die Verwendung auf Ihrer Website oder in Mailings zu erstellen. Mit der hier beschriebenen Schnittstelle können Sie statische Karten in verschiedenen Formaten und Konfigurationen generieren.

Verfügbarkeit des Satellite-Stils

Der Stil satellite ist weltweit verfügbar. Hochauflösendes Bildmaterial wird derzeit für Deutschland, die Schweiz, Frankreich und Dänemark bereitgestellt, während andere Regionen niedriger aufgelöstes Bildmaterial verwenden. Siehe die Verfügbarkeitstabelle.

Endpunkte

Der Dienst bietet die folgenden Endpunkte:

Zentrumsbasiert

https://tiles.smartmaps.cloud/styles/v1/smartmaps/{style}/static/{lon},{lat},{zoom}[/{width}x{height}].{format}

Definiert den Kartenausschnitt über ein Koordinatenpaar (Längengrad, Breitengrad), eine Zoomstufe und optional die Bildabmessungen und -auflösung.

Flächenbasiert

https://tiles.smartmaps.cloud/styles/v1/smartmaps/{style}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}.{format}

Definiert den Kartenausschnitt über ein umgebendes Rechteck, angegeben durch die Koordinaten der unteren linken und oberen rechten Ecke.

Autofit Path

https://tiles.smartmaps.cloud/styles/v1/smartmaps/{style}/static/auto/{width}x{height}[@2x].{format}

Passt den Kartenausschnitt automatisch an einen gegebenen Pfad an (siehe Query-Parameter).

Dabei gilt: - {style} ist einer der verfügbaren Kartenstile (essential, light, dark, grey, accessible, satellite) - {format} ist das gewünschte Bildformat (z. B. webp, png, jpg) - @2x ist optional und fordert ein hochauflösendes Bild an

Authentifizierung

Um die Schnittstelle zu nutzen, benötigen Sie einen von SmartMaps bereitgestellten API-Key. Zur Authentifizierung wird der API-Key als URL-Parameter übergeben und muss stets URL-codiert sein.

Parameter	Beschreibung
`apiKey`	API-Key - erhalten nach der Registrierung.

Beispiel

Static Map Example Map of Karlsruhe with marker at YellowMap

<!doctype html>
<html>
    <head>
        <title>Static Map Example</title>
    </head>
    <body>
        <img 
            src="https://tiles.smartmaps.cloud/styles/v1/smartmaps/light/static/8.43,49.02,12/800x300.webp?apiKey=[INSERT API-KEY]" 
            alt="Map of Karlsruhe" />
    </body>
</html>

Kartenstile

SmartMaps bietet mehrere vordefinierte Kartenstile, die Sie in Ihren Static-Maps-Anfragen verwenden können. Jeder Stil bietet ein anderes visuelles Erscheinungsbild für die Karte. Die verfügbaren Stile sind:

Essential: Ein ausgewogener, universeller Kartenstil, der für die meisten Anwendungen geeignet ist.
Light: Ein heller, klarer Stil mit hellen Farben, ideal zum Überlagern zusätzlicher Informationen.
Dark: Ein elegantes, dunkel gehaltenes Kartenstil, perfekt für nächtliche oder lichtarme Umgebungen.
Grey: Ein monochromer Stil in Grautönen, nützlich für dezente Hintergrundkarten.
Accessible: Ein kontrastreicher Stil, entwickelt für bessere Lesbarkeit und Barrierefreiheit.
Satellite: Hochauflösendes Satellitenbildmaterial, das eine realistische Ansicht der Landschaft bietet.

Skalierungsfaktoren

Die Static Maps API unterstützt hochauflösende Bilder durch die Verwendung von Skalierungsfaktoren. Sie können Bilder mit erhöhter Auflösung anfordern, indem Sie einen Skalierungsfaktor an die Bildabmessungen anhängen. Die verfügbaren Skalierungsfaktoren sind:

@1x (Standard): Standardauflösung
@2x: Doppelte Auflösung
@3x: Dreifache Auflösung

Um einen Skalierungsfaktor zu verwenden, hängen Sie ihn an die Breiten- und Höhenparameter Ihrer Anfrage an. Zum Beispiel:

https://tiles.smartmaps.cloud/styles/v1/smartmaps/light/static/8.43,49.02,12/800x600@2x.webp?apiKey=[INSERT API-KEY]

Dies liefert ein Bild mit einer Größe von 1600x1200 Pixeln, jedoch mit dem Detailgrad eines 800x600-Bildes. Dies ist besonders nützlich für hochauflösende Displays oder wenn Sie hochwertige Bilder für Druckmaterialien erzeugen müssen.

Beachten Sie, dass höhere Skalierungsfaktoren zu größeren Dateigrößen führen und die Generierung und der Download länger dauern können. Bedenken Sie außerdem, dass es maximale Größenbeschränkungen für die generierten Bilder geben kann, typischerweise um 4096x4096 Pixel. Wenn Sie größere Bilder benötigen, müssen Sie sich möglicherweise für individuelle Vereinbarungen an den SmartMaps-Support wenden.

Denken Sie bei der Verwendung von Skalierungsfaktoren daran, die Abmessungen Ihres HTML-img-Tags entsprechend anzupassen, damit das Bild in der beabsichtigten Größe angezeigt wird:

<img 
  src="https://tiles.smartmaps.cloud/styles/v1/smartmaps/light/static/8.43,49.02,12/800x600@2x.webp?apiKey=[INSERT API-KEY]"
  width="800" 
  height="600" 
  alt="High-resolution map of Karlsruhe" 
/>

Dies zeigt ein hochauflösendes Bild in der ursprünglich beabsichtigten Größe an, was zu schärferen Details auf hochauflösenden Displays führt.

Funktionen

Die folgenden Funktionen sind verfügbar:

Kartengrößen und Zoomstufen: Passen Sie verschiedene Kartengrößen und Zoomstufen basierend auf einem beliebigen Radius an.
Punktdaten und Icons: Zeichnen Sie Punktdaten und wählen Sie aus verschiedenen Icons.
Benutzerdefinierte Linien: Zeichnen Sie selbst definierte Linien auf der Karte.