Try out the Interactive Mapillary API Demo and let us know what you think!

Getting started with Mapillary API

If you've ever wondered how to bring the world of Mapillary into your custom projects, we have put together a new interactive, open-source demo of the Mapillary public API. It's designed to help you explore our API, understand exactly how Mapillary works, see the code behind it, and adapt and copy what you’d like. To keep things as accessible as possible, we built it using Manus, a vibe coding tool and vanilla HTML, CSS, and JavaScript. No frameworks, no build steps.

Screenshot of the Mapillary API Demo showing the split-panel layout with map coverage and street-level viewer

What This Demonstrates

The goal here was simple: create a sample implementation that showcases many of the core capabilities of the Mapillary platform in one place. Whether you’re a seasoned GIS developer or just getting started with our tools to map your local area, we hope this serves as a useful starting point.

Screenshot of the Mapillary API Demo showing the split-panel layout with map coverage and street-level viewer

The demo brings together several different API features that our community uses every day:

• Image Tiles & Map Features: You can view vector tile layers showing image coverage as green sequences, and toggle layers displaying detected map features (like fire hydrants or benches) and traffic signs.
• Street-Level Viewer: We’ve integrated MapillaryJS for full 360° and perspective image viewing with spatial navigation.
• Metadata & Detections: When you click on an image, you can retrieve its full metadata (coordinates, camera parameters, capture date) and a list of all object detections with classification values.
• Tile Filtering: You can filter the visible coverage by date range or limit it to 360° panoramas only.

Getting started with Mapillary API

Beyond just making API calls, we added a few features to make exploring the data easier. The left panel features an interactive map powered by MapLibre GL JS, complete with a geocoder search bar so you can easily fly to any location in the world.

This entire application was vibecoded using Manus, an AI agent that builds software through natural language conversation. No code was written manually; every line was generated iteratively based on conversational instructions.

Try It Out

The app is live and ready to use. We built it to be explored, forked, and extended by the community.

1. Use the Live Demo: Visit mapillary.github.io/api-demo. It loads with a default access token, so you can start clicking around immediately.
2. Run Locally: If you want to poke around the code, just clone the repo and open index.html in a browser. It’s that simple.
3. Use Your Own Access Token: Click “Change access token” in the header to enter your own Mapillary API token (which you can get from the Developer Portal).

The project is open source (MIT License) and available on GitHub at mapillary/api-demo. We’d love for you to try it out, fork it, and let us know what you think in the forum. If you run into any issues along the way, feel free to reach out to us at support@mapillary.com - we’re always happy to help.

Boris Masis