MapMetrics Atlas API Overview
Welcome to the MapMetrics Atlas API documentation. Build powerful, location-based applications with our comprehensive suite of mapping, geocoding, and routing services.
What is MapMetrics Atlas API?
MapMetrics Atlas provides a complete set of location services including interactive maps, geocoding, turn-by-turn directions, and routing optimization. Our platform is built for developers who need reliable, high-performance mapping solutions.
Quick Start
⚠️ Important: You need an API key to use MapMetrics Atlas API. All API requests require authentication. Sign up now to get started!
Get started in three simple steps:
- Create an API Key - Sign up at MapMetrics Portal to get your API token and map style URL
- Build Your First Map - Follow our quick start guide
API Services
🗺️ Maps & Vector Tiles
Access customizable vector map tiles with dynamic styling options. Our maps support both light and dark themes and can be fully customized to match your application's design.
Features:
- High-performance vector tiles
- Customizable map styles (dark/light themes)
- Global map coverage
- Support for multiple zoom levels
Get Started:
📍 Geocoding Services
Convert addresses to coordinates (forward geocoding) and coordinates to addresses (reverse geocoding). Includes autocomplete search for building location-aware features.
Endpoints:
- Autocomplete - Real-time search suggestions
- Forward Geocoding - Address → Coordinates
- Reverse Geocoding - Coordinates → Address
Use Cases:
- Location search in apps
- Address validation
- Store locators
- Location-based forms
🧭 Directions & Routing
Calculate optimal routes, analyze reachability, and optimize multi-stop trips with our powerful routing engine.
Endpoints:
- Directions - Turn-by-turn navigation
- Optimization - Multi-stop route optimization
- Isochrone - Reachability analysis
- Matrix - Distance/time matrices
- Map Matching - GPS trace matching
- Elevation - Elevation profiles
Supported Transport Modes:
- 🚗 Auto (car, motorcycle, taxi)
- 🚴 Bicycle
- 🚶 Pedestrian
- 🚌 Bus
- 🚛 Truck
- 🛵 Motor Scooter
Use Cases:
- Navigation apps
- Delivery route optimization
- Fleet management
- Travel time analysis
SDKs & Platforms
Choose the right SDK for your platform:
| Platform | SDK | Status | Documentation |
|---|---|---|---|
| Web | MapMetrics GL JS | ✅ Stable | Get Started |
| iOS | MapMetrics Native | ✅ Stable | Get Started |
| Android | MapMetrics Native | ✅ Stable | Get Started |
| Flutter | MapMetrics Flutter | 🟡 Beta | Get Started |
Web SDK Features
- Interactive vector maps
- Markers, popups, and custom overlays
- 3D buildings and terrain
- Heatmaps and clustering
- Custom styling
Installation:
- CDN: Simple Map (CDN)
- NPM: Simple Map (NPM) - Package: @mapmetrics/mapmetrics-gl
- React: React Integration
Mobile SDK Features
- Native performance
- Offline map support
- Location tracking
- Custom annotations
- Gesture controls
Authentication
🔒 API Key Required: MapMetrics Atlas API requires authentication for all requests. Without a valid API key, maps won't load and API calls will return 401 Unauthorized errors.
All API requests require authentication using your API token. You must create an account on the MapMetrics Portal to get your API token and map style URL.
Get Started:
- Visit MapMetrics Portal
- Create your account (free to start)
- Get your complete map style URL (includes your API token)
- Copy and use it in your application
Detailed Guide: Create API Key
Don't Have an API Key Yet?
If you try to use MapMetrics without an API key:
- ❌ Maps will fail to load
- ❌ API requests will return authentication errors
- ❌ No access to geocoding or routing services
Solution: Create your free account in minutes!
Map Styles
All map styles are created and managed through the MapMetrics Portal. When you create an account, you'll receive a unique map style URL for your applications.
Getting Your Map Style URL
- Sign up at MapMetrics Portal
- Create a new style or use the default style provided
- Copy your complete style URL from the portal (it includes your API token)
- Paste it directly in your application code
The portal provides you with a ready-to-use URL - just copy and paste it into your application!
Example URL:
https://gateway.mapmetrics-atlas.net/styles/?fileName=753b9b14-2fcc-44d3-b273-c8b2b701647a/stylefile.json&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...Customize Your Map Style
Through the MapMetrics Portal, you can:
- Customize colors - Match your brand's color scheme
- Choose fonts - Select typography for map labels
- Add/remove layers - Control which map features are displayed
- Create multiple styles - Different styles for different use cases
- Dark/Light themes - Create styles optimized for different themes
Learn More: Style Creation Guide
Migration Guides
Switching from another mapping provider? We've got you covered:
Support & Resources
Documentation
- Code Examples - Ready-to-use code samples
- Migration Guides - Switch from other providers
Community
- Discord Community - Chat with developers
- Facebook - Latest updates
- YouTube - Video tutorials
Need Help?
- Browse our examples
- Join our Discord community
- Check out video tutorials
- Contact support for technical assistance
What's Next?
Ready to start building? Here are some recommended next steps:
- Create your account - Sign up and get your API key
- Display your first map - Quick start guide
- Add markers - Display points of interest
- Implement routing - Add turn-by-turn directions
- Customize your map style - Create custom styles in the portal
Let's build something amazing together! 🚀