maps.gurudocs
Documentation

Quick Start

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...
Warning

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://api.maps.guru/v1/styles/basic/style.json?key=YOUR_API_KEY',
      center: [0, 20],
      zoom: 2
    });
  </script>
</body>
</html>

4. Make an API Call

Test geocoding with a simple curl command:

curl "https://api.maps.guru/v1/geocode?q=London&key=YOUR_API_KEY"

Response:

{
  "results": [
    {
      "name": "London",
      "country": "United Kingdom",
      "lat": 51.5074,
      "lng": -0.1278
    }
  ]
}

5. Monitor Usage

Check your usage in the Dashboard → Usage page. You'll see real-time request counts for each service.

What's Next?