Overview

Educational map generation API.

Map Generation

Generate educational maps programmatically. Perfect for geography apps, quizzes, and learning platforms.

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"
  }'

What You Can Create

  • Country maps — Any country with accurate borders
  • State/province maps — US states, Canadian provinces, Mexican states
  • Highlighted regions — Quiz-ready maps with colored states
  • River and lake overlays — Hydrological features

Themes

ThemeDescription
modernClean, minimalist design
vintageTraditional atlas style
satelliteSatellite imagery aesthetic
monochromeHigh-contrast black and white
blueprintTechnical drawing style

See Themes for details.

Output Formats

FormatUse Case
pngWeb display, downloads
svgScalable, editable
pdfDocuments, printing

Dimensions

  • Width: 400–4096 pixels
  • Height: 300–2160 pixels
  • DPI: 72, 150, or 300

See Pricing for token costs.

Next Steps

Create Map

Full API reference.

Locations

Find countries, states, and cities.

Highlighting

Create quiz-ready maps.

Themes

Visual theme options.