Outdoor Tiles

Outdoor Tiles lets you add Mountaya's geospatial layers (weather overlays, snow depth, activity routes, collection data, custom drawings) directly into your own map. You keep full control over the UI and user experience while Mountaya handles the data pipeline.

Use it when you already have a map in your application and want to enrich it with Mountaya data. If you don't have a map yet and want a ready-made experience, use Map Embedding instead.

Authentication

Include your publishable key in the X-API-Key header of every request. If the require_session_token safety rule is enabled, also include a session token in the X-Session-Token header.

Your publishable key must have the tiles scope enabled. For a full guide on keys and tokens, see Authentication.

How it works

Every resource in Outdoor Tiles follows the same two-step pattern: fetch the specification once, then let your map library stream the tiles.

1. Specification. Returns metadata: source type (vector or raster), tile URLs, layer configuration, legend, and zoom bounds. Call this once when initializing your map.
2. Tiles. Returns the actual tile data at a given {z}/{x}/{y} coordinate. Your map library calls this automatically once you register the source.

The specification response tells you exactly how to configure everything, so there's no guesswork. It returns an array of sources, each containing its own tile URLs, layers, and zoom bounds.

Response shape

{
  "status": "OK",
  "data": {
    "sources": [
      {
        "id": "source-uuid",
        "type": "vector",
        "tiles": ["https://tiles.mountaya.com/v1/overlays/snowdepth/{z}/{x}/{y}"],
        "zoom_min": 7,
        "zoom_max": 14,
        "attribution": "<a href=\"...\">...</a>",
        "layers": [
          {
            "id": "layer-uuid",
            "type": "fill",
            "source_layer": "snowdepthLayer",
            "zoom_min": 7,
            "zoom_max": 14,
            "paint": { "fill-color": "...", "fill-opacity": 0.8 },
            "layout": {},
            "legend": { "kind": "row", "unit": "cm", "steps": ["..."] }
          }
        ]
      }
    ]
  }
}

Quick start

Fetch the specification for a resource, then register each source and its layers in your map. This example adds the snowdepth overlay. The same pattern works for activities, collections, and drawings; just swap the URL.

const PUBLISHABLE_KEY = "pk_your_publishable_key";
const BASE = "https://tiles.mountaya.com";

// 1. Fetch the specification.
const res = await fetch(`${BASE}/v1/overlays/snowdepth/specification`, {
  headers: { "X-API-Key": PUBLISHABLE_KEY },
});
const spec = await res.json();

// 2. Register each source and its layers.
for (const source of spec.data.sources) {
  map.addSource(source.id, {
    type: source.type,
    tiles: source.tiles.map((url) => `${url}?publishable_key=${PUBLISHABLE_KEY}`),
    minzoom: source.zoom_min,
    maxzoom: source.zoom_max,
    ...(source.attribution && { attribution: source.attribution }),
  });

  for (const layer of source.layers) {
    map.addLayer({
      id: layer.id,
      type: layer.type,
      source: source.id,
      "source-layer": layer.source_layer,
      paint: layer.paint,
      layout: layer.layout,
      minzoom: layer.zoom_min,
      maxzoom: layer.zoom_max,
      ...(layer.filter && { filter: layer.filter }),
    });
  }
}

API reference

For the full list of endpoints, request parameters, and response schemas, see the API Reference.