API Dokumentation

API-Key

Sie haben die Möglichkeit den OpenStreetMap Kartendienst gekachelt oder als einzelnes Bild einzubinden. Über die WMS-Schnittstelle haben Sie zudem die Möglichkeit die Karten in einer Vielzahl von Projektionen abrufen zu können.

Die URL des Kartendienstes beinhaltet Ihren {api-key}. Diesen können Sie im Administrationsbereich erstellen. Der API-Key ist ein eindeutiger Code und dient zur Identifizierung der Anfragen. Der API-Key besteht aus einer Kennung die Sie frei wählen können und einer von uns zufällig generierten Zeichenfolge. Wenn Sie mehrere Anwendungen betreuen, können Sie über die Kennung die einzelnen Anwendungen unterscheiden.

Kachel-Zugriff

Wenn Sie die Karten in einer Webanwendung verwenden, die die Web-Mercator-Projektion unterstützt, dann können Sie die Kacheln direkt ansprechen. Die Web-Mercator-Projektion ist unter anderem mit GoogleMaps, MapBox, Bing Maps und OpenStreetMap kompatibel.

Kachel-URL
https://maps.omniscale.net/v2/{api-key}/style.default/{z}/{x}/{y}.png

Subdomains

Andere Kartenanbieter verwenden mehrere Subdomains (a.myprovider.com, b.myprovider.com, etc.). Dies ist eine Abhilfe um es Webclients zu ermöglichen mehrere Kacheln parallel herunterzuladen. Unsere Dienste unterstützen den neuen HTTP2 Standard, der unbegrenzt parallele Downloads unterstützt. Mehrere Subdomains sind daher für unsere Dienste nicht notwendig. Bitte beachten Sie, dass HTTP2 nur für verschlüsselte Verbindungen über unsere https-URLs unterstützt wird.

WMS-Zugriff

Für die Unterstützung beliebiger Projektionen und Maßstäbe, können Sie auf unseren WMS Dienst zugreifen.

Basis WMS URL des Kartendienstes
https://maps.omniscale.net/v2/{api-key}/style.default/map?

Unsere WMS Dienste sind optimiert für Kachelanfragen (256×256 Pixel) und erkennen anhand der Anfragen automatisch die Konfiguration Ihrer Anwendung. Sie können also beliebige Maßstäbe und Kachelgitter verwenden und müssen hierfür keine komplizierten Konfigurationen vornehmen.

In unserer Hilfe, finden Sie Beispiele wie der Kartendienst in die zwei bekannten Javascript-Bibliotheken OpenLayers und Leaflet eingebunden wird.

WMTS-Zugriff

Für das Einbinden unserer gekachelten Dienste in Desktop-Anwendungen unterstützen wir den WMTS Standard. WMTS wird von immer mehr Desktop-Anwendungen unterstützt und ermöglicht eine schnellere Darstellung der Karten beim Zoomen und Verschieben.

WMTS Capabilities URL
https://maps.omniscale.net/v2/{api-key}/WMTSCapabilities.xml

Je nach Anwendung kann die Bildqualität bei der Verwendung von WMTS im Vergleich zu WMS schlechter sein.
Bitte überprüfen Sie die Einstellungen Ihrer Anwendung, wenn die Karten unscharf oder pixelig dargestellt werden. QGIS bietet hierfür z.B. die Option "Smooth pixmap transform", bzw. "Pixmap-Transformation glätten".
Verwenden Sie bitte unsere WMS Dienste, wenn Sie mit der Bildqualität nicht zufrieden sind, Sie eine andere Kartenprojektion als Web-Mercator benötigen, oder wenn Sie die Karten drucken möchten.

Style-Parameter

Über den {style}-Parameter in der URL können Sie das Layout der Karten auswählen. Sie können hier folgende Werte eintragen:

• style.default Standard Kartenlayout
• style.grayscale Karte in der Graustufen-Variante
• style.outdoor Outdoor-Karte mit Geländeschummerung

Anfrage
https://maps.omniscale.net/v2/{api-key}/{style}/style.default/map?

Beispiel Anfrage Farbig
https://maps.omniscale.net/v2/demo/style.default/map

Beispiel Graustufen
https://maps.omniscale.net/v2/demo/style.grayscale/map

Attributierung

Sie müssen die folgende Attributierung (Copyright-Hinweis) angeben, wenn Sie unsere Karten in einer Website einbinden oder in Dokumenten darstellen. In nicht-gekachelten WMS Antworten ist die Attributierung bereits enthalten.

• Für default und grayscale:

  © Omniscale 2023 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL)

• Für outdoor:

  © Omniscale 2023 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL), ASTER GDEM is a product of NASA and METI