Sie haben die Möglichkeit, den Omniscale OpenStreetMap Kartendienst gekachelt oder als einzelnes Bild einzubinden. Hierfür stehen drei Methoden zur Verfügung.
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
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 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.
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 Administrationsbereich 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 |
Standardmäßig wird eine Copyright-Hinweis angezeigt. Wenn Sie ihn ausblenden, müssen Sie ihn an anderer Stelle darstellen. |
| dpi | Zahl von 90 bis 300 | Erstellen Sie Karten für den Druck in höheren Auflösungen. Standard: 90,7 DPI.
Die Option ist nur bei privaten Kartenzugänge möglich.
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/Retina-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
Die Nutzung der OpenStreetMap Karten erfordert die Angabe des Urhebers.
In nicht-gekachelten WMS Antworten ist diese Angabe (Attributierung)
bereits enthalten. Sie können die automatische Angabe entfernen, indem Sie attribution.false zu der URL hinzufügen.
Sie müssen sicherstellen, dass folgende Attributierung (Copyright-Hinweis) angeben wird, wenn Sie unsere Karten auf einer Website einbinden oder in Dokumenten darstellen.
default und grayscale:
© Omniscale 2025 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL)
outdoor:
© Omniscale 2025 (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