EN DE
  • Registrieren
  • Login

API Dokumentation

  • Dienste
  • Erforderliche Parameter
  • Optionale Parameter
  • Layer

Kartendienste

Sie haben die Möglichkeit, den Omniscale OpenStreetMap Kartendienst gekachelt oder als einzelnes Bild einzubinden. Hierfür stehen drei Methoden zur Verfügung.

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

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 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, 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.

Erforderliche Parameter

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.

API-Key

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.

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:

  • 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

Optionale Parameter

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

Attributierung

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.

  • Für default und grayscale:
    © Omniscale 2025 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL)
  • Für outdoor:
    © Omniscale 2025 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL), ASTER GDEM is a product of NASA and METI

EPSG Auswahl

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.

Layer

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.

Verfügbare Layer

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.)

Beispiel


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

Nützliches

  • Registrieren • Anmelden
  • Interaktive Karte
  • Preise, Pläne und Funktionen
  • Hilfe, Dokumentation & API
  • Verfügbare Kartenprojektionen

Über uns

  • Impressum
  • AGB
  • Datenschutz

Kontaktdaten

Omniscale GmbH & Co. KG
Moltkestraße 6a
26122 Oldenburg
Deutschland
Zum Kontaktformular ↝

Copyright © 2025 • Omniscale, Kartendaten: OpenStreetMap (Lizenz: ODbL)

* Angebote nur für Gewerbetreibende. Alle Preise zzgl. ges. MwSt.