Outdoor Style

A comprehensive topographic map style built for hiking, cycling, skiing, and general outdoor navigation. Based on OpenStreetMap data, rendered with MapLibre GL.

Usage with MapLibre GL JS

const MAPRIOT_APIKEY = 'YOUR_API_KEY';

const map = new maplibregl.Map({
  container: 'map',
  style: 'https://api.mapriot.com/styles/outdoor.json',
  center: [14.42, 50.08],
  zoom: 13,
  transformRequest: (url) => {
    if (url.startsWith('https://api.mapriot.com') && !url.includes('apiKey')) {
      return {
        url: url + (url.includes('?') ? '&' : '?') + 'apiKey=' + MAPRIOT_APIKEY,
      };
    }
    return { url };
  },
});

The transformRequest callback is required to append your API key to all tile, font, and sprite requests that the style triggers. See the MapLibre GL JS example for a complete setup including 3D terrain.

Data sources

The style references four tile sources. Each source tile request costs 1 unit.

The terrain layers transition smoothly: relief provides broad terrain shape at low zoom (z0–4), then hillshading takes over from z5 for higher-resolution slope shading. Contour lines appear from z11.

What’s included

Terrain — contour lines (10 m or 5 m intervals depending on region), hillshading, 3D terrain support, low-zoom shaded relief

Trails and routes — color-coded hiking trails parsed from OSM osmc:symbol tags with proper stacking when routes share a path, cycling routes, hiking difficulty grading (SAC scale)

Winter sports — ski lifts, chairlifts, gondolas

Transportation — full road hierarchy from motorways to footpaths, with surface type distinction (paved/unpaved), bridges, tunnels

Places — city, town, village, hamlet, and neighbourhood labels with population-based ranking

Water — rivers, streams, lakes, coastlines, intermittent waterways, springs, waterfalls

Land cover and use — forests, parks, residential areas, farmland, glaciers, bare rock, scree, cliffs, military areas

Points of interest — mountain peaks (with prominence ranking), shelters, campsites, viewpoints, restaurants, public transport stops, parking areas, and more

Sprites and fonts

The style references sprite (icon) and font (glyph) assets hosted on the same API. These require your API key and are authenticated automatically via transformRequest. They are free — no billing.

Custom styles

If you build your own style using the mapriot vector source, you will need to supply your own sprite and font (glyph) assets. The ones served by our API are designed specifically for the outdoor style.

We can create custom map styles tailored to your project — contact us to discuss.

Style version

https://api.mapriot.com/styles/style-versions.json?apiKey=<key>

Returns the current version of each style. Poll this to check for updates without fetching the full style JSON.