EN DE
  • Sign up
  • Log in

API Documentation

  • API-Key
  • Required Parameters
  • Optional Parameters
  • Layer

API-key

You can use our OpenStreetMap service tiled or as single image. You can select from a large selection of coordinate systems by accessing our services with the WMS standard.

All our service URLs contain an {api-key}. An API-key is a short, unique code. We use this to assign any requests made by yourself or your users with your account. The API-key consists of an identifier which you can freely choose and a random number generated by us. The identifier is a short name that helps you and us to see for which application the API-key is.

Tile access

If your web-application use the Webmercator-projection, you can add the tiles directly. Webmercator is compatible with Google Maps, Bing Maps, Mapbox and OpenStreetMap.

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

Other providers offer multiple subdomains (a.myprovider.com, b.myprovider.com, etc.). This is a workaround to allow web clients to download more tiles in parallel. Our services support the new HTTP2 standard which allows unlimited parallel downloads. Multiple domains are therefore not necessary for our services. Please note that HTTP2 is only available for encrypted connections via our https-URLs.

WMS service

Use our WMS service if you need support for other map projections or map scales.

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

Our services are optimized for tile-requests (256×256 pixels) and they automatically identify the configuration of your application based on your tile requests. You can use your own tile grid, with your projection and your set of map scales. The only requirement is that your application predefines the map scales for your users.

We have documented the integration into OpenLayers and Leaflet with a few examples.

WMTS service

You can use our WMTS service for tiled access in desktop applications. WMTS is supported by more and more clients and allows faster display when zooming and panning.

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

Depending on your client, the image quality may be worse when using WMTS compared to WMS.
Please check the settings of your client if the maps are blurry or pixelated. QGIS for example offers the option "Smooth pixmap transform" to improve this.
Please use our WMS services if you are not satisfied with the image quality, if you need a different map projection than Webmercator or if you want to print our maps.

Style Parameter

With the {style}-parameter you are able to select the design of the map. You can select the following styles:

  • style.default Default map style
  • style.grayscale Grayscale map style
  • style.outdoor Outdoor map style with hillshading
Request
https://maps.omniscale.net/v2/{api-key}/{style}/style.default/map?

Example request default style
https://maps.omniscale.net/v2/demo/style.default/map

Example request grayscale style
https://maps.omniscale.net/v2/demo/style.grayscale/map
Attribution

You need to display the following attribution (copyright notice) if you use our maps on a website or on any document. Non-tiled map images already contain the attribution.

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

Optional Parameters

Option Value Description
attribution true or false

By default we show an attribution in the map for non-tiled requests.

In some cases it is necessary to hide the attribution on the map image. You are still required to show the attribution somewhere else, if you use our maps on your website or on any document.

dpi Number from 90 to 300 Create a high resolution map for printing. By default our maps will be rendered with 90.7 DPI.
You will find more information about printing on our print page.
hq true or false Returns maps with twice the resolution, optimized for smartphones and tablets with HQ/Retina displays. This applies only to tiled requests.
Please look at the HQ/Retina web examples.
Example
https://maps.omniscale.net/v2/demo/style.grayscale/{attribution}/{dpi}/map?

Example WMS request without attribution in 300 DPI
https://maps.omniscale.net/v2/demo/style.grayscale/attribution.false/dpi.300/map
Select your EPSG

Our OpenStreetMap WMS offers a large selection of coordinate systems. All SRS are added to the WMS capabilites document. A few desktop applications can not handle this and always use the first code. For these clients you can select the target EPSG code in the URL directly.

If you cannot find your required coordinate system, please contact us. We will try to provide the requested coordinate system.

Example
https://maps.omniscale.net/v2/demo/style.grayscale/map?epsg={epsg-code}

Example GetCapabilities request with EPSG 25833
https://maps.omniscale.net/v2/demo/style.grayscale/map?service=WMS&request=GetCapabilities&epsg=25833

Only GetCapabilities requests need the epsg-parameter

Layer

osm is the default layer. This layer contains the most relevant sub-layers. You can create a custom map by selecting specific layers with the layers=-parameter.

You can select multiple layers using a comma separated list. You can also include or exclude layers by prefixing them with + or -. (Note that + needs to be encoded as %2B in URLs.) For example layers=-labels,-housenumbers shows the default map without any labels and housenumbers, andlayers=%2Bpois shows the default map including POIs.

Available Layers

All default layers are included in the osm-layer.

Name Default Description
world ✓ Basic background (land areas and water)
landusages ✓ Land use (forests, parks, built-up areas, etc.)
admin ✓ Borders
roads ✓ Roads
buildings ✓ Buildings
labels ✓ Labels
housenumbers ✓ House numbers
pois Points of Interest (shops, police stations, hospitals, parking lots, etc.)
Example
WMS request: Streets and labels only
https://maps.omniscale.net/v2/demo/style.default/map?LAYERS=roads,labels&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

Help and Service

  • Register • Login
  • Interactive map
  • Plans and Pricing

Help and Service

  • Help/API
  • Available projections

About us

  • Imprint
  • Terms and Conditions
  • Privacy

Contact details

Omniscale GmbH & Co. KG
Moltkestraße 6a
26122 Oldenburg
Germany
Go to contact form ↝

Copyright © 2023 • Omniscale, Map data: OpenStreetMap (License: ODbL)

This offer only applies to tradesmen. All indicated prices are listed without VAT.

This offer only applies to tradesmen. All indicated prices are listed without VAT.