Getting Started
Quick Start
Get started with maps.guru in under 5 minutes.
Get your first map running in under 5 minutes.
1. Create an Account
Sign up at maps.guru/signup. A personal organization and default API key are created automatically.
2. Get Your API Key
Navigate to Dashboard → API Keys to find your default key. It starts with mapx_ and has access to all services (maps, geocoding, routing).
mapx_abc123def456...
Keep your API key secure. Never expose it in client-side code that gets committed to public repositories.
3. Load a Map
Add a map to your webpage using MapLibre GL JS:
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="https://unpkg.com/maplibre-gl/dist/maplibre-gl.css" />
<script src="https://unpkg.com/maplibre-gl/dist/maplibre-gl.js"></script>
<style>
#map { width: 100%; height: 400px; }
</style>
</head>
<body>
<div id="map"></div>
<script>
const map = new maplibregl.Map({
container: 'map',
style: 'https://maps.guru/api/v1/styles/standard/light/style.json?key=YOUR_API_KEY',
center: [0, 20],
zoom: 2
});
</script>
</body>
</html>
Try it live — enter your API key to see the map:
4. Fetch a Style
Retrieve a map style JSON with your API key:
curl "https://maps.guru/api/v1/styles/standard/light/style.json?key=YOUR_API_KEY"
This returns a complete MapLibre Style Specification JSON with all tile, sprite, and glyph URLs pre-configured.
5. Monitor Usage
Check your usage in the Dashboard → Usage page. You'll see real-time request counts for each service.
What's Next?
- Authentication — Understand API key scopes and security
- Rate Limits — Learn about request limits per tier
- Embed Maps — Embed interactive maps on your site