cityposter 0.2.3

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

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 (--custom-poi)

两处数据源，个人目录优先：

目录	用途
~/.config/cityposter/custom-poi/	个人专属，升级不丢
config/custom-poi/	项目通用，随代码分发

GeoJSON 格式（支持 .json / .geojson）：

{
  "type": "FeatureCollection",
  "coord_type": "gcj02",
  "features": [
    {
      "type": "Feature",
      "properties": {"name": "故宫", "category": "景点"},
      "geometry": {"type": "Point", "coordinates": [116.3972, 39.9163]}
    }
  ]
}

• coord_type: "gcj02" 高德坐标自动转 WGS-84，默认 "wgs84"
• category: 支持中文（"景点"）、英文（"Sightseeing"）、key（"sightseeing_spot"）
• 文件名含城市名 = 城市专属优先加载；不含 = 通用兜底
• _ 或 . 前缀文件忽略（禁用/备份）

| -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.