Map Generation

Generate beautiful, educational maps programmatically. Perfect for geography quizzes, educational materials, and learning applications.

What You Can Create

• Country Maps - Any country with accurate borders
• State/Province Maps - US states, Canadian provinces, etc.
• Highlighted Regions - Quiz-ready maps with specific areas highlighted
• River & Lake Overlays - Hydrological features on any map

Available Themes

Output Options

Quick Example

curl -X POST 'https://api.smavatar.com/api/v1/projects/{project_id}/jobs/maps' \
  -H 'Authorization: Bearer {api_key}' \
  -H 'Content-Type: application/json' \
  -d '{
    "location_id": "bdd56f14-e776-418a-ab18-89c8138df978",
    "width": 1400,
    "height": 900,
    "theme": "modern",
    "output_format": "png"
  }'

How It Works

1. Choose a location - Country, state, or city
2. Select a theme - Visual style for your map
3. Add features (optional) - Rivers, lakes, highlighted regions
4. Submit job - Our API generates your map
5. Download - Get your high-resolution image

Discovery with MCP

Use our MCP server to discover locations and features:

# List available countries
curl 'https://api.smavatar.com/api/mcp/tools/list-locations?type=country'

# List US states
curl 'https://api.smavatar.com/api/mcp/tools/list-locations?type=subdivision&parent=us'

# List themes
curl 'https://api.smavatar.com/api/mcp/tools/list-themes'

Cost

Map generation costs 50 tokens regardless of size or complexity.

Next Steps