Getting Started
Rate Limits
Understand request limits and quotas for each subscription tier.
maps.guru enforces rate limits to ensure fair usage and platform stability. Limits vary by subscription tier and are tracked per organization.
Tier Quotas
| Service | Free | Pro ($49/mo) | Enterprise |
|---|---|---|---|
| Maps (tile requests) | 10,000/mo | 500,000/mo | Unlimited |
| Geocoding | 5,000/mo | 100,000/mo | Unlimited |
| Routing | 5,000/mo | 100,000/mo | Unlimited |
How Limits Work
Monthly Reset
All quotas reset on the first day of each calendar month (UTC). Unused requests do not roll over.
Real-Time Tracking
Usage is tracked in real-time using Cloudflare Durable Objects. You can monitor current usage from the dashboard or via the API:
curl -H "Authorization: Bearer mapx_your_key" \
"https://maps.guru/api/v1/usage/current"
Quota Exceeded
When you exceed your quota, the API returns a 429 Too Many Requests response:
{
"statusCode": 429,
"message": "Monthly quota exceeded for maps service. Upgrade your plan at https://maps.guru/dashboard/billing"
}
Rate Limit Headers
Every API response includes rate limit information:
X-RateLimit-Limit: 500000
X-RateLimit-Remaining: 499234
X-RateLimit-Reset: 2025-02-01T00:00:00Z
Upgrading
If you're consistently hitting limits, consider upgrading your plan:
- Go to Dashboard → Billing
- Select a higher tier
- Quotas are updated immediately — no waiting for the next billing cycle
Enterprise plans include custom quotas and SLAs. Contact us for pricing.