Limits & Quotas

This guide documents the actual rate limits and quotas in Mapiry based on the codebase implementation.

Plan Comparison

See Pro Features for complete plan comparison.

AI Credit System

Mapiry uses a credit-based system for AI operations. Different operations cost different amounts of credits based on their computational cost.

Credit Costs

Credit Limits by Plan

Free: 50 AI credits per day (resets at midnight) Pro: 3,000 AI credits per month (resets on billing date)

This means:

• Free users can generate ~2 full maps OR 50 descriptions per day

• Pro users can generate ~120 full maps OR 3,000 descriptions per month

• Free limits reset at midnight daily (UTC)

• Pro limits reset on your billing anniversary date

• Both plans use the same AI model (GPT-4o-mini)

What uses credits:

• Creating a new map with AI (25 credits)
• Adding locations to an existing map with AI (15 credits)
• Generating or regenerating location descriptions (1 credit each)

Check your remaining credits in your billing dashboard.

Anonymous Users

Anonymous (not logged in) users have much stricter limits:

Total Limit: 50 AI credits lifetime (IP-based)

• Once you use all credits, you must create an account to continue
• Counter is tracked by IP address
• Does not reset

Rate Limit: 3 requests per minute

• Prevents rapid automated requests
• Temporary cooldown if exceeded

Anonymous users get the same AI quality but with stricter usage limits to encourage account creation.

Geocoding Limits

Geocoding (converting addresses to coordinates) has a separate limit:

All logged-in users: 1,000 geocoding requests per day

This limit applies to:

• Manually geocoding addresses
• Bulk CSV imports with address-to-coordinate conversion
• Using Google Places Search

Resets every 24 hours from your first request. Check Account Settings > Usage to see remaining geocoding requests.

Map Limits

Free Plan

Maximum maps: 10 maps total

Once you reach 10 maps, you must delete existing maps to create new ones. All maps are stored in the cloud and synced across devices.

Pro Plan

Maximum maps: Unlimited

Create as many maps as you need without worrying about limits.

Private Maps

Free Plan: Public maps only

• All maps you create are publicly visible on the Explore page
• Anyone can view your map if they have the link

Pro Plan: Private maps included

• Create private maps visible only to you
• Share private maps with temporary access tokens (24-hour expiration)
• Toggle visibility at any time

See Sharing for more about private maps.

Anonymous Maps

Anonymous maps (created without logging in) have special rules:

Expiration

Sliding window: 30 days from last access

• Anonymous maps expire 30 days after creation
• Each time you access the map, the expiration extends by 30 days
• This is a "sliding window" that keeps active maps alive

Deletion schedule:

• Soft delete after 30 days of no access
• Hard delete after 90 days total

Browser-Based Editing

Anonymous maps allow editing through your browser:

• Your browser remembers which maps you created
• You can edit from the same browser where you created the map
• Clearing browser data will remove your editing ability

Claiming on Signup

When you create an account, anonymous maps are automatically claimed:

1. Sign up from the same browser where you created maps
2. All your anonymous maps are automatically found
3. Maps are transferred to your new account
4. Maps become permanent (no expiration)

See Anonymous Users for detailed information about the anonymous workflow.

Temporary Access Tokens

When you share a private map (Pro feature), temporary access tokens are generated:

Expiration: 24 hours (not customizable)

• Single-use access tokens for viewing private maps
• Cannot be extended or customized
• New token must be generated after expiration

Note: Private maps are only available to Pro users. Free users can only create public maps.

Explore Page

The public Explore page has pagination limits:

Maps per page: 12 maps

Available filters:

• Search by title or description
• Filter by country
• Sort by popular, recent, or most locations

Embedding Limits

Coming Soon

The codebase references embed view limits in the plan configuration, but embed view tracking and limits are not fully implemented yet.

File Upload Limits

CSV Import

Currently, both Free and Pro users can import CSV files with:

• Location data (name, latitude, longitude required)
• Optional fields (description, category, hidden status)

See CSV Import for file format requirements.

KML/KMZ Import

Both Free and Pro users can import KML/KMZ files:

• Single and multi-layer KML supported
• Folder-to-category mapping
• Style preservation where possible

See KML Import for details.

Image Uploads

Location images are uploaded through Cloudinary with standard file size limits. Custom markers and category icons are not currently supported.

Rate Limit Response Codes

When you hit a rate limit, you'll receive clear error messages:

AI Credit Limit:

• Logged-in Free users: "You've used all your daily AI credits (50). Upgrade to Pro for 3,000 AI credits per month. Your credits reset at midnight."
• Logged-in Pro users: "You've used all your monthly AI credits (3,000). Your credits reset on [billing date]."
• Anonymous users (lifetime): "You've used all your free AI credits. Please sign up for a free account to get 50 credits per day."
• Anonymous users (rate): "Too many requests. Please wait X seconds before trying again."

Geocoding:

• "You've reached your daily limit of 1,000 geocoding requests."

Checking Your Usage

For Logged-In Users

Check your usage in the Billing dashboard:

• AI credits used this period (daily for Free, monthly for Pro)
• AI credits remaining
• Credit cost reference
• Geocoding requests remaining
• Total maps created
• Reset times

For Anonymous Users

Anonymous users can see:

• AI credits remaining (out of 50 lifetime)
• Maps created this session
• Edit tokens stored in browser

Note: Clearing browser data will cause you to lose editing access to your anonymous maps.

When Limits Reset

AI Credits (Free users): Daily at midnight UTC

• Full reset to 50 credits
• Unused credits don't roll over

AI Credits (Pro users): Monthly on billing date

• Full reset to 3,000 credits
• Unused credits don't roll over

AI Rate Limit (anonymous): 1 minute rolling window

• Can make 3 requests per 60-second period

Geocoding: 24 hours from first request

• Rolling 24-hour window
• Resets 24 hours after your first request of the period

Anonymous maps: 30-day sliding window from last access

Upgrading for Higher Limits

Consider upgrading to Pro if you:

• Need more than 50 AI credits per day
• Want to create more than 10 maps
• Need private maps
• Require white-label embeds
• Want priority support

Upgrade takes effect immediately with no downtime. See Pro Features for pricing.

What's Not Limited

These features have no limits on any plan:

• Locations per map (reasonable limits apply for performance)
• Categories per map
• Map views (public and private)
• Map edits and updates
• Location edits and updates
• Sharing maps (no limit on shares)

API Limits

Note: Public API access is not currently available. The plan configuration references API limits (100/hour for Free, 1,000/hour for Pro) but the API is not implemented yet.

What's Next?

• Pro Features - See what Pro unlocks
• Anonymous Users - How anonymous maps work
• AI Features - Using AI generation
• FAQ - Common questions about limits