Sie können den OpenStreetMap-Kartendienst von Omniscale gekachelt oder als einzelnes Bild einbinden. Hierfür stehen drei Methoden zur Verfügung.
Wenn Ihre Webanwendung die Web-Mercator-Projektion unterstützt, können Sie die Kacheln direkt abrufen. Die Web-Mercator-Projektion ist unter anderem mit Google Maps, Mapbox, Bing Maps und OpenStreetMap kompatibel.
Kachel-URL
https://maps.omniscale.net/v2/{api-key}/style.default/{z}/{x}/{y}.png
Web- und Desktopanwendungen nutzen denselben WMS-Dienst und dasselbe URL-Format. Für Desktopanwendungen benötigen Sie einen privaten API-Key.
Nutzen Sie unseren WMS-Dienst für beliebige Projektionen und Maßstäbe.
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 beliebige Maßstäbe und Kachelgitter verwenden und müssen hierfür keine komplizierten Konfigurationen vornehmen. In Webanwendungen müssen Sie eine feste Auswahl an Maßstäben vorgeben.
In unserer Hilfe finden Sie Beispiele für die Einbindung mit den JavaScript-Bibliotheken OpenLayers und Leaflet.
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, falls 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, eine andere Kartenprojektion als Web-Mercator benötigen oder die Karten drucken möchten.
Die drei Dienste (Kacheldienst, WMS und WMTS) können Sie über Parameter in der URL anpassen. Diese Parameter werden in der Regel als Segment in dem URL-Pfad hinzugefügt. Folgende Parameter sind erforderlich.
Die URL der Kartendienste beinhaltet Ihren {api-key}, den Sie im Bereich URLs und API-Keys erstellen können. Der API-Key ist ein eindeutiger Code und dient zur Abrechnung der Anfragen mit Ihrem Nutzerkonto. Der API-Key besteht aus einer frei wählbaren Kennung und einer von uns zufällig generierten Zeichenfolge. Wenn Sie mehrere Anwendungen betreuen, können Sie über die Kennung die einzelnen Anwendungen unterscheiden.
Der API-Key ist zwingend als zweiter Pfad (hinter /v2/) anzugeben. In Beispielen ist hier in der Regel der Test-API-Key demo angegeben.
Über den style-Parameter in der URL können Sie das Layout der Karten auswählen. Sie können hier folgende Werte eintragen:
default Standard Kartenlayout
grayscale Karte in der Graustufen-Variante
outdoor Outdoor-Karte mit Geländeschummerung
Anfrage https://maps.omniscale.net/v2/{api-key}/style.{name}/map? Beispiel Karte farbig https://maps.omniscale.net/v2/demo/style.default/map Beispiel Karte in Graustufen https://maps.omniscale.net/v2/demo/style.grayscale/map Beispiel Outdoorkarte https://maps.omniscale.net/v2/demo/style.outdoor/map
Unsere Dienste unterstützen weitere Parameter die in der Regel als URL-Segment übergeben werden können (d.h. /option.wert/).
| Option | Wert | Beschreibung |
|---|---|---|
| attribution | true oder false |
Bei ungekachelten WMS-Anfragen ist die Quellenangabe standardmäßig im Kartenbild enthalten. Wenn Sie sie ausblenden, müssen Sie sie an anderer Stelle auf Ihrer Website oder in Ihrem Dokument anzeigen. |
| dpi | Auflösung in DPI (z. B. 300) | Erstellen Sie Karten für den Druck mit 300 DPI und höherer Auflösung. Standard: 90,7 DPI.
Diese Option ist nur mit privaten API-Keys verfügbar.
Mehr Informationen zum Drucken finden Sie auf unserer Hilfeseite. |
| hq | true oder false |
Liefert Karten mit doppelter Auflösung zurück, optimiert für Smartphones und Tablets mit HQ-Displays. Wirkt sich nur auf Kachelanfragen aus. Beispiele finden Sie in der Hilfe für Webanwendungen. |
| layers | Kommaseparierte Liste mit layer, +layername oder -layername |
Beschränkt die Standardlayer des angebotenen Dienstes. |
| epsg | Nummer des EPSG Koordinatensystems | Beschränkt den WMS Dienst auf ein einziges Koordinatensystem. Nur für WMS GetCapabilities Anfragen gültig. Dieser Parameter muss als Anfrage-Parameter gesendet werden (d.h. /map?epsg=25832). |
Beispiel Graustufen WMS-Anfrage ohne Attribution und mit 300 DPI https://maps.omniscale.net/v2/demo/style.grayscale/attribution.false/dpi.300/map Beispiel Outdoor WMS-Anfrage ohne Beschriftung https://maps.omniscale.net/v2/demo/style.outdoor/layers.-labels/map
Bei der Nutzung unserer Karten ist eine Quellenangabe erforderlich. Bei ungekachelten WMS-Anfragen ist diese standardmäßig im Kartenbild enthalten.
Sie können sie ausblenden, indem Sie attribution.false zur URL hinzufügen. In diesem Fall müssen Sie sie an anderer Stelle auf Ihrer Website oder in Ihrem Dokument anzeigen.
Stellen Sie sicher, dass die folgende Quellenangabe (Copyright-Hinweis) enthalten ist, wenn Sie unsere Karten auf einer Website oder in Dokumenten verwenden.
default und grayscale:
© Omniscale 2026 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL)
outdoor:
© Omniscale 2026 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL), ASTER GDEM is a product of NASA and METI
Unsere Dienste unterstützen eine Vielzahl von Koordinatensystemen, die im WMS-Capabilities-Dokument angeboten werden. Manche Desktop-Anwendungen verwenden jedoch immer das erste aufgelistete Koordinatensystem. In diesem Fall können Sie das benötigte EPSG-Koordinatensystem durch Angabe in der GetCapabilities-URL explizit vorgeben.
Beispiel https://maps.omniscale.net/v2/demo/style.grayscale/map?epsg={epsg-code} Beispiel Get-Capabilities Anfrage mit EPSG 25833 https://maps.omniscale.net/v2/demo/style.grayscale/map?service=WMS&request=GetCapabilities&epsg=25833
Der epsg-Parameter ist nur für GetCapabilities Anfragen erforderlich.
osm ist der Standardlayer. Dieser Layer beinhaltet die wichtigsten Unterlayer.
Sie können, wie bei einem WMS-Dienst üblich, mehrere Layer als Kommaseparierte-Liste über den layers Query-Parameter auswählen. In einem Desktop-GIS wird dies für Sie übernommen.
Neben den layers Query-Parameter unterstützen unsere Dienste noch ein optionalen layers Parameter als URL-Segment. Hiermit kann die Standardauswahl beeinflusst werden und somit auch für Kacheldienste die Layer flexibel ausgewählt werden.
Sie können einzelne Layer auswählen, oder Layer aus der Standardauswahl hinzufügen oder entfernen.
Beispielsweise zeigt /layers.roads,buildings/ ausschließlich Straßen und Gebäude, /layers.-labels,-housenumbers/ die Standardkarte ohne Beschriftung und Hausnummern, und /layers.%2Bpois/ die Standardkarte mit zusätzlichen POIs.
Beachten Sie, dass ein + in der URL als %2B kodiert werden muss.
Alle aktiven Layer sind im osm-Layer enthalten.
| Name | Aktiv | Beschreibung |
|---|---|---|
| world | ✓ | Basis Hintergrund (Landflächen und Gewässer) |
| landusages | ✓ | Flächennutzung (Wälder, Parks, bebaute Flächen, etc.) |
| admin | ✓ | Grenzen |
| roads | ✓ | Straßen |
| buildings | ✓ | Gebäude |
| labels | ✓ | Beschriftungen |
| housenumbers | ✓ | Hausnummern |
| pois | Points of Interest (Geschäfte, Polizei, Krankenhäuser, Parkplätze, etc.) |
Kachelanfrage für Gebäude in hoher Qualität, für mobile Anwendungen https://maps.omniscale.net/v2/{api-key}/style.default/layers.buildings/hq.true/{z}/{x}/{y}.png Beispiel WMS-Anfrage nur Straßen https://maps.omniscale.net/v2/demo/style.default/layers.roads/map?LAYERS=osm&FORMAT=image/png&SERVICE=WMS&VERSION=1.1.1&SRS=EPSG:31467&REQUEST=GetMap&BBOX=3648808.05872,5599105.55872,3669808.05872,5621605.55872&WIDTH=420&HEIGHT=450 Beispiel WMS zum Einbinden in Desktop GIS, der keine Beschriftung darstellt https://maps.omniscale.net/v2/demo/style.default/layers.-labels,-housenumbers/map?SERVICE=WMS&REQUEST=GetCapabilities