API Keys
API keys authenticate your requests to maps.guru services. Every request must include a valid API key.
Key Format
All keys use the mapx_ prefix:
mapx_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Default Key
When you create an account, a default API key is automatically generated with access to all services. Find it at Dashboard → API Keys.
Creating Keys
- Navigate to Dashboard → API Keys
- Click Create New Key
- Enter a descriptive name (e.g., "Production Backend", "Dev Testing")
- Select the scopes this key needs
- Click Create
Warning
The full key is only shown once at creation. Copy it immediately and store it securely.
Key Properties
| Property | Description |
|---|---|
| Name | Human-readable label for identification |
| Prefix | First 8 characters visible in dashboard (mapx_a1b2...) |
| Scopes | Services the key can access (maps, geocoding, routing) |
| Created | Creation timestamp |
| Last Used | Most recent successful request |
| Status | Active or Revoked |
Revoking Keys
Revoked keys are immediately invalidated — any in-flight requests using that key will fail.
- Go to Dashboard → API Keys
- Find the key to revoke
- Click the revoke button
- Confirm the action
Tip
Revocation is permanent. If you need the same scopes, create a new key.
Key Rotation
Rotate keys periodically to limit exposure from potential leaks:
- Create a new key with the same scopes
- Update your application configuration
- Verify the new key works
- Revoke the old key
Multiple Keys
Create separate keys for different purposes:
| Key Name | Scopes | Environment |
|---|---|---|
| Production API | maps, geocoding, routing | Production |
| Dev Testing | maps, geocoding | Development |
| Analytics Backend | geocoding | Analytics pipeline |
| Mobile App | maps | iOS/Android app |