originalankur /maptoposter
Transform your favorite cities into beautiful, minimalist designs. MapToPoster lets you create and export visually striking map posters with code.
★ 14,307⑂ 1,251👁 44⑃ 130● 94▤ 0
+5
日增长
+35
周增长
+104
月增长
14,307
stars
1,251
forks
44
watchers
130
prs
94
issues
0
releases
README
City Map Poster Generator Generate beautiful, minimalist map posters for any city in the world. Examples | Country | City | Theme | Poster | |:------------:|:--------------:|:---------------:|:------:| | USA | San Francisco | sunset | | | Spain | Barcelona | warm_beige | | | Italy | Venice | blueprint | | | Japan | Tokyo | japanese_ink | | | India | Mumbai | contrast_zones | | | Morocco | Marrakech | terracotta | | | Singapore | Singapore | neon_cyberpunk | | | Australia | Melbourne | forest | | | UAE | Dubai | midnight_blue | | | USA | Seattle | emerald | | Installation With uv (Recommended) Make sure uv is installed. Running the script by prepending uv run automatically creates and manages a virtual environment. bash First run will automatically install dependencies uv run ./create_map_poster.py --city "Paris" --country "France" Or sync dependencies explicitly first (using locked versions) uv sync --locked uv run ./create_map_poster.py --city "Paris" --country "France" With pip + venv bash python -m venv .venv source .venv/bin/activate On Windows: .venv\Scripts\activate pip install -r requirements.txt Usage Generate Poster If you're using uv: bash uv run ./create_map_poster.py --city --country [options] Otherwise (pip + venv): bash python create_map_poster.py --city --country [options] Required Options | Option | Short | Description | |--------|-------|-------------| | --city | -c | City name (used for geocoding) | | --country | -C | Country name (used for geocoding) | Optional Flags | Option | Short | Description | Default | |--------|-------|-------------|---------| | OPTIONAL: --latitude | -lat | Override latitude center point (use with --longitude) | | | OPTIONAL: --longitude | -long | Override longitude center point (use with --latitude) | | | OPTIONAL: --country-label | | Override country text displayed on poster | | | OPTIONAL: --theme | -t | Theme name | terracotta | | OPTIONAL: --distance | -d | Map radius in meters | 18000 | | OPTIONAL: --list-themes | | List all available themes | | | OPTIONAL: --all-themes | | Generate posters for all available themes | | | OPTIONAL: --width | -W | Image width in inches | 12 (max: 20) | | OPTIONAL: --height | -H | Image height in inches | 16 (max: 20) | Multilingual Support - i18n Display city and country names in your language with custom fonts from google fonts: | Option | Short | Description | |--------|-------|-------------| | --display-city | -dc | Custom display name for city (e.g., "東京") | | --display-country | -dC | Custom display name for country (e.g., "日本") | | --font-family | | Google Fonts family name (e.g., "Noto Sans JP") | Examples: bash Japanese python create_map_poster.py -c "Tokyo" -C "Japan" -dc "東京" -dC "日本" --font-family
Top issues
#182Water layer rendered incorrectly8 comments · 2026-02-11#173Enhancement: Tracks8 comments · 2026-02-07#125Ideas for improvements8 comments · 2026-01-25#190Enhancement: Additionl themes4 comments · 2026-02-12#144Airports4 comments · 2026-01-29#169Option -d (--distance) isn't working3 comments · 2026-02-04#234add pre-commits/linters for better code2 comments · 2026-06-27#231Can't download streets2 comments · 2026-05-01
Discussions
#238--distance is reduced by /4, causing generated poster extent to differ from requested radius0 comments · 2026-07-28#220Coastline cities - Sea not getting proper water color1 comments · 2026-03-19#216Emoji integration0 comments · 2026-03-14#206Create a poster without label1 comments · 2026-03-04#205Indexed the repo with Mintlify's docs0 comments · 2026-03-04#197Bussiness on stolen project0 comments · 2026-02-16#196Potential rip-off (for profit) without attribution?3 comments · 2026-02-16#195Maps to printer paper size1 comments · 2026-02-16