Skip to main content

Generate beautiful, minimalist map posters for any city — now with offline SinoGDB support for Chinese cities.

Project description

CityPoster — 城市地图海报生成器

基于 maptoposter 改造,专注中国城市离线地图海报。

安装

git clone https://github.com/songwupei/cityposter.git
cd cityposter
uv sync

SinoGDB 数据 (中国城市离线生成)

下载 SinoGDB-PackSet,设置路径:

export SINOGDB_DIR="$HOME/Downloads/SinoGDB-PackSet_gpkg_20260208"

使用

# 中国城市 — 完全离线,秒级出图
cityposter --lat 39.9042 --lon 116.4074 -dc "北京" -dC "中国" -t noir --poi
cityposter --lat 30.5728 --lon 104.0668 -dc "成都" -dC "中国" -t gongqiang --poi

# 国际城市 — 走 OSMnx
cityposter -c "Paris" -C "France" -t pastel_dream -d 10000

参数

参数 说明 默认
--lat, --lon 中心坐标 (WGS-84)
--gcj02 坐标视为 GCJ-02
-dc, -dC 显示名称
-t 主题 terracotta
-d 半径 (米) 8000(中国)
--poi POI 标注 关闭
开启后显示:地铁站、火车站、景点、学校、医院等

--poi 详情

开启后从 SinoGDB 拉取以下数据并标注(最多 50 个标记、15 个标签):

数据源 类型 标记
railway_point 地铁站 ○ 空心圆环 + 站名
火车站 ■ 方块
transport_point 公交站/机场/港口 ●/◆ 按类型
natural_point 山峰/洞穴/温泉 ▲/★
landuse (学校/医院/寺庙) 学校/医院/寺庙 ●/■/▲

不加 --poi 则不显示任何标注,纯地图。

自定义 POI

config/custom-poi/ 放置 JSON 文件,--poi 时自动加载:

[
  {"name": "故宫", "lat": 39.9163, "lon": 116.3972, "category": "landmark"},
  {"name": "天安门", "lat": 39.9087, "lon": 116.3975, "category": "sightseeing_spot"}
]

支持 category: landmark, sightseeing_spot, museum, park, temple, school, cafe, mall 等。

| -W, -H | 画布 (英寸) | 12x16 | | -f | png/svg | png | | --font-family | Google Fonts | Noto Sans SC(中国) |

所有主题 (41)

主题 名称 风格
autumn Autumn 秋日橙红
blueprint Blueprint 建筑蓝图
brutalist_concrete Brutalist Concrete 粗野主义
carbon_fiber Carbon Fiber 碳纤维黑
contrast_zones Contrast Zones 高对比度
copper_patina Copper Patina 铜绿氧化
cotton_candy Cotton Candy 棉花糖粉紫
cyberpunk_neon Cyberpunk Neon 赛博朋克
desert_rose Desert Rose 沙漠玫瑰
emerald Emerald City 翡翠绿
forest Forest 森林绿
forest_moss Forest Moss 苔藓绿金
gilded_noir Gilded Noir 黑金奢华
glitch_purple Glitch Purple 故障紫绿
gongqiang 宫墙 Gongqiang 红底鎏金
gradient_roads Gradient Roads 渐变道路
japanese_ink Japanese Ink 日式水墨
lavender_mist Lavender Mist 薰衣草雾
matcha_latte Matcha Latte 抹茶拿铁
mediterranean_summer Mediterranean Summer 地中海蓝橙
mediterranean_summer_plus Mediterranean Summer + Rail 地中海+铁路
midnight_blue Midnight Blue 午夜蓝金
monochrome_blue Monochrome Blue 单色蓝
neon_cyberpunk Neon Cyberpunk 霓虹赛博朋克
noir Noir 纯黑白
nordic_frost Nordic Frost 北欧冰霜
ocean Ocean 海洋蓝
ocean_abyss Ocean Abyss 深海深渊
pastel_dream Pastel Dream 梦幻粉彩
qingzhuan 青砖 Qingzhuan 胡同灰砖
red_alert Red Alert 红色警报
royal_velvet Royal Velvet 皇家天鹅绒
sakura_branch Sakura Branch 樱花粉
shuimo 水墨 Shuimo 水墨白底
solarized_dark Solarized Dark Solarized 暗色
sulfur_slate Sulfur & Slate 硫磺金灰
sunset Sunset 落日橙粉
terra_clay Terra Clay 陶土暖色
terracotta Terracotta 地中海陶
vintage_nautical Vintage Nautical 复古航海
warm_beige Warm Beige 暖米色

Credit

Forked from maptoposter by Ankur Gupta. MIT License.

SinoGDB data derived from OpenStreetMap, processed by QGIS.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cityposter-0.1.1.tar.gz (40.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cityposter-0.1.1-py3-none-any.whl (43.7 kB view details)

Uploaded Python 3

File details

Details for the file cityposter-0.1.1.tar.gz.

File metadata

  • Download URL: cityposter-0.1.1.tar.gz
  • Upload date:
  • Size: 40.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for cityposter-0.1.1.tar.gz
Algorithm Hash digest
SHA256 9beb57c5ce6a01dab969c08f5c630db8bf8e9411a5f963e870a57c55467b1e09
MD5 e14d8bb74de24a6175d32389f1c16b6f
BLAKE2b-256 6524f748f2e1a4354d269486b21d4d85080915fe2e253a57ab48591f2aaf44f8

See more details on using hashes here.

File details

Details for the file cityposter-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: cityposter-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 43.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for cityposter-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 70b26381b7d77945927fba5e1c9dcef3cf3bcd729a38716f270f4e0942a861c7
MD5 acd3c19484c91c240bf4340a70ddf53f
BLAKE2b-256 587cfbc4a5b6abc361e0affaa3a6a49c9e3d7dc3de45381f139f49ae60484f26

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page