Skip to content
ALIGN ALIGN Docs

Mapillary

Mapillary is a platform of crowdsourced street-level imagery — photos and 360° panoramas captured by a community of contributors, covering streets, paths and places worldwide. It is the open, community-sourced counterpart to Google Street View.

What it enables in ALIGN

Section titled “What it enables in ALIGN”

Connecting a Mapillary access token unlocks Mapillary as an imagery source for the Street View widget. With the widget set to Mapillary, your end-users click any point on the map and the panel shows the closest available Mapillary imagery, with a marker on the map indicating the viewing position and direction.

You choose Mapillary or Google Street View per map, as the creator — see the Street View widget page for the widget parameters.

How to get the key

Section titled “How to get the key”

Mapillary uses a client access token (it starts with MLY|…) for read-only access to public imagery. That is the token ALIGN needs.

  1. Sign in at the Mapillary developer dashboard and open Register an application.
  2. Fill the form:
    • Application name / Description / Company name / Company website — free text, only visible in your own dashboard.
    • Redirect URL — required by the form, but not used by the Street View widget: it only matters for the OAuth flow where an app acts on behalf of a user, which ALIGN does not do. Any valid URL is fine.
    • Allow this application to (scopes) — enable read access to public data (the read scope). That is enough to display images and sequences. You do not need write or upload access.
  3. After creating the application, Mapillary generates a client token (MLY|…). Copy it.
  4. In ALIGN, go to Dashboard → Integrations and paste the token for Mapillary.

Your key stays yours

Section titled “Your key stays yours”

The Mapillary token is stored on your ALIGN account and resolved at runtime when the widget loads. It never enters the map document: a map you save, publish or share carries no credential. If no token is configured, the Street View widget shows a “setup required” message instead of failing silently.

Even though a Mapillary client token is technically read-only public, ALIGN handles it as an account-scoped secret — the same treatment as any other integration key.

Section titled “Related”