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.
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
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.
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.
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.
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
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.
default and grayscale:
© Omniscale 2018 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL)
outdoor:
© Omniscale 2018 (https://maps.omniscale.com) – Map data: OpenStreetMap (License ODbL), ASTER GDEM is a product of NASA and METI
| 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
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
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.
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.) |
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