Introduction
Authentication
Map Embedding
Overview
Properties
Tile API
Data Platform

Map Embedding

Map Embedding puts a full Mountaya 3D map on your website with a single <iframe> tag. Display collections, routes, itineraries, and drawings — complete with terrain, weather overlays, and user interactivity — without writing any map code.

Example

This iframe is produced by a single line of HTML:

<iframe
  src="https://app.mountaya.com/studio/embed
    ?publishable_key=pk_...
    &session_token=sess_...
    &collection_id=0e9788ba-f680-4a74-8354-e7b7fe5ee061
    &route_id=b61e7f93-fa79-4326-9a30-937e53d110c6
    #view=11.50/45.88796/6.97656/176.3/59">
</iframe>

How it works

Mountaya iframes are shaped by three elements:

  • Safety rules restrict geographic boundaries, allowed domains, zoom levels, and feature access at the organization level.
  • Properties define defaults — like language, map controls, and active content — that can be customized per iframe.
  • Branding aligns the iframe with your website's color palette.

Authentication

Every iframe requires a publishable key (publishable_key) to identify your organization. If the require_session_token safety rule is enabled, a session_token must also be provided.

For a step-by-step guide on keys and tokens, see Authentication.

<iframe
  src="https://app.mountaya.com/studio/embed
    ?publishable_key=pk_...
    &session_token=sess_...
    &collection_id=uuid
    &route_id=uuid">
</iframe>

If require_session_token is disabled, you can omit the session_token parameter.