cityposter 0.1.0__tar.gz

cityposter-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-2026 Ankur Gupta (original maptoposter)
+Copyright (c) 2026 cityposter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cityposter-0.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: cityposter
+Version: 0.1.0
+Summary: Generate beautiful, minimalist map posters for any city — now with offline SinoGDB support for Chinese cities.
+Author-email: Ankur Gupta <originalankur@github.com>
+License: MIT
+Keywords: map,poster,osm,openstreetmap,art,visualization,china,sinogdb
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.14.1
+Requires-Dist: certifi==2026.1.4
+Requires-Dist: charset-normalizer==3.4.4
+Requires-Dist: contourpy==1.3.3
+Requires-Dist: cycler==0.12.1
+Requires-Dist: fonttools==4.61.1
+Requires-Dist: geocode-amap>=0.1.0
+Requires-Dist: geographiclib==2.1
+Requires-Dist: geopandas==1.1.2
+Requires-Dist: geopy==2.4.1
+Requires-Dist: idna==3.11
+Requires-Dist: kiwisolver==1.4.9
+Requires-Dist: lat-lon-parser==1.3.1
+Requires-Dist: matplotlib==3.10.8
+Requires-Dist: networkx==3.6.1
+Requires-Dist: numpy==2.4.0
+Requires-Dist: osmnx==2.0.7
+Requires-Dist: packaging==25.0
+Requires-Dist: pandas==2.3.3
+Requires-Dist: pillow==12.1.0
+Requires-Dist: pyogrio==0.12.1
+Requires-Dist: pyparsing==3.3.1
+Requires-Dist: pyproj==3.7.2
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: pytz==2025.2
+Requires-Dist: requests==2.32.5
+Requires-Dist: scipy==1.16.3
+Requires-Dist: shapely==2.1.2
+Requires-Dist: six==1.17.0
+Requires-Dist: tqdm==4.67.1
+Requires-Dist: tzdata==2025.3
+Requires-Dist: urllib3==2.6.3
+Dynamic: license-file
+
+# CityPoster — 城市地图海报生成器
+
+基于 [maptoposter](https://github.com/originalankur/maptoposter) 改造，专注中国城市离线地图海报。
+
+## 安装
+
+```bash
+git clone https://github.com/songwupei/cityposter.git
+cd cityposter
+uv sync
+```
+
+### SinoGDB 数据 (中国城市离线生成)
+
+下载 [SinoGDB-PackSet](https://docs.qq.com/smartsheet/DSHBNQ1FUTEZJek9q)，设置路径：
+
+```bash
+export SINOGDB_DIR="$HOME/Downloads/SinoGDB-PackSet_gpkg_20260208"
+```
+
+## 使用
+
+```bash
+# 中国城市 — 完全离线，秒级出图
+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` 时自动加载：
+
+```json
+[
+  {"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](https://github.com/originalankur/maptoposter) by Ankur Gupta. MIT License.
+
+SinoGDB data derived from OpenStreetMap, processed by QGIS.

cityposter-0.1.0/README.md

@@ -0,0 +1,125 @@
+# CityPoster — 城市地图海报生成器
+
+基于 [maptoposter](https://github.com/originalankur/maptoposter) 改造，专注中国城市离线地图海报。
+
+## 安装
+
+```bash
+git clone https://github.com/songwupei/cityposter.git
+cd cityposter
+uv sync
+```
+
+### SinoGDB 数据 (中国城市离线生成)
+
+下载 [SinoGDB-PackSet](https://docs.qq.com/smartsheet/DSHBNQ1FUTEZJek9q)，设置路径：
+
+```bash
+export SINOGDB_DIR="$HOME/Downloads/SinoGDB-PackSet_gpkg_20260208"
+```
+
+## 使用
+
+```bash
+# 中国城市 — 完全离线，秒级出图
+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` 时自动加载：
+
+```json
+[
+  {"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](https://github.com/originalankur/maptoposter) by Ankur Gupta. MIT License.
+
+SinoGDB data derived from OpenStreetMap, processed by QGIS.

cityposter-0.1.0/cityposter/cli.py

@@ -0,0 +1,353 @@
+#!/usr/bin/env python3
+"""
+CLI entry point for maptoposter.
+"""
+
+import argparse
+import sys
+import os
+import traceback
+from datetime import datetime
+from pathlib import Path
+
+from cityposter.config import (
+    DEFAULT_THEME,
+    DEFAULT_DISTANCE_M,
+    DEFAULT_WIDTH_IN,
+    DEFAULT_HEIGHT_IN,
+    POSTERS_DIR,
+    CHINA_DEFAULT_DISTANCE_M,
+)
+from cityposter.themes.manager import load_theme, get_available_themes, list_themes
+from cityposter.fonts.manager import load_fonts
+from cityposter.rendering.poster import (
+    create_poster_osmnx,
+    create_poster_sinogdb,
+    generate_output_filename,
+)
+from cityposter.coordinate_systems import is_out_of_china, gcj02_to_wgs84, wgs84_to_gcj02
+from cityposter.data.sinogdb import fetch_china_city_data, SinoGDBReader
+
+
+def parse_coord(val: str) -> float:
+    """Parse a coordinate value supporting DMS and decimal formats."""
+    try:
+        return float(val)
+    except ValueError:
+        from lat_lon_parser import parse
+        return parse(val)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Generate beautiful map posters for any city",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Chinese city with SinoGDB (offline, fast)
+  maptoposter --lat 39.9042 --lon 116.4074 -dc "北京" -dC "中国" --font-family "Noto Sans SC"
+
+  # International city with OSMnx
+  maptoposter -c "Paris" -C "France" -t pastel_dream -d 10000
+
+  # GCJ-02 coordinates from Amap/Gaode
+  maptoposter --lat 39.9151 --lon 116.4040 --gcj02 -dc "北京" -dC "中国"
+        """,
+    )
+
+    # Location
+    parser.add_argument("--city", "-c", type=str, help="City name")
+    parser.add_argument("--country", "-C", type=str, help="Country name")
+    parser.add_argument("--latitude", "-lat", type=str, help="Latitude (WGS-84 or GCJ-02 with --gcj02)")
+    parser.add_argument("--longitude", "-lon", type=str, help="Longitude (WGS-84 or GCJ-02 with --gcj02)")
+    parser.add_argument("--display-city", "-dc", type=str, help="Display name for city")
+    parser.add_argument("--display-country", "-dC", type=str, help="Display name for country")
+    parser.add_argument("--country-label", type=str, help="Override country text on poster")
+
+    # Data source
+    parser.add_argument("--data-source", choices=["sinogdb", "osmnx", "overpass"],
+                        default=None,
+                        help="Data source (sinogdb for China, osmnx/overpass for international)")
+    parser.add_argument("--sinogdb-dir", type=str,
+                        help="SinoGDB data directory path")
+
+    # Theme
+    parser.add_argument("--theme", "-t", type=str, default=DEFAULT_THEME, help="Theme name")
+    parser.add_argument("--all-themes", action="store_true", help="Generate posters for all themes")
+    parser.add_argument("--list-themes", action="store_true", help="List all available themes")
+
+    # Map geometry
+    parser.add_argument("--distance", "-d", type=int, default=None,
+                        help="Map radius in meters")
+    parser.add_argument("--width", "-W", type=float, default=DEFAULT_WIDTH_IN,
+                        help="Image width in inches (max 20)")
+    parser.add_argument("--height", "-H", type=float, default=DEFAULT_HEIGHT_IN,
+                        help="Image height in inches (max 20)")
+
+    # Format
+    parser.add_argument("--format", "-f", default="png", choices=["png", "svg", "pdf"],
+                        help="Output format (default: png)")
+
+    # Fonts
+    parser.add_argument("--font-family", type=str,
+                        help='Google Fonts family name (e.g., "Noto Sans SC")')
+
+    # China-specific
+    parser.add_argument("--gcj02", action="store_true",
+                        help="Treat input coordinates as GCJ-02 (convert to WGS-84 for OSM data)")
+
+    # Road styling
+    parser.add_argument("--road-width-boost", type=float, default=None,
+                        help="Multiplier for road line widths (default: 2.5 for sinogdb, 1.0 for osmnx)")
+
+    # POI
+    parser.add_argument("--poi", action="store_true", default=False,
+                        help="Show all POI markers (landmarks, nature, schools, etc.). Default: subway + train only")
+    parser.add_argument("--custom-poi", nargs="?", dest="custom_pois", default=None,
+                        const=[], metavar="NAME,LAT,LON,CATEGORY",
+                        help="Load config/custom-poi/ POIs and optional CLI custom POI")
+
+    args = parser.parse_args()
+
+    # ── No args: show help ──────────────────────────────────
+    if len(sys.argv) == 1:
+        parser.print_help()
+        return
+
+    # ── List themes ─────────────────────────────────────────
+    if args.list_themes:
+        list_themes()
+        return
+
+    # ── Validate location ───────────────────────────────────
+    if not args.latitude or not args.longitude:
+        if not args.city or not args.country:
+            print("Error: Provide either (--lat AND --lon) or (--city AND --country).\n")
+            parser.print_help()
+            sys.exit(1)
+
+    # ── Parse coordinates ───────────────────────────────────
+    lat = parse_coord(args.latitude) if args.latitude else None
+    lon = parse_coord(args.longitude) if args.longitude else None
+
+    # GCJ-02 conversion
+    if args.gcj02 and lat is not None and lon is not None:
+        print(f"Input (GCJ-02): {lat:.6f}, {lon:.6f}")
+        lon, lat = gcj02_to_wgs84(lon, lat)
+        print(f"Converted (WGS-84): {lat:.6f}, {lon:.6f}")
+
+    # ── Auto-detect data source ─────────────────────────────
+    data_source = args.data_source
+    if data_source is None:
+        if lat is not None and lon is not None and not is_out_of_china(lon, lat):
+            data_source = "sinogdb"
+            print("✓ Auto-detected China location → using SinoGDB (offline)")
+        else:
+            data_source = "osmnx"
+
+    # ── Distance defaults ───────────────────────────────────
+    if args.distance is None:
+        if data_source == "sinogdb":
+            args.distance = CHINA_DEFAULT_DISTANCE_M
+        else:
+            args.distance = DEFAULT_DISTANCE_M
+
+    # ── Dimension limits ────────────────────────────────────
+    if args.width > 20:
+        print(f"⚠ Width {args.width} exceeds max (20). Using 20.")
+        args.width = 20.0
+    if args.height > 20:
+        print(f"⚠ Height {args.height} exceeds max (20). Using 20.")
+        args.height = 20.0
+
+    # ── Themes ──────────────────────────────────────────────
+    available_themes = get_available_themes()
+    if not available_themes:
+        print("No themes found in 'themes/' directory.")
+        sys.exit(1)
+
+    if args.all_themes:
+        themes_to_generate = available_themes
+    else:
+        if args.theme not in available_themes:
+            print(f"Error: Theme '{args.theme}' not found.")
+            print(f"Available: {', '.join(available_themes)}")
+            sys.exit(1)
+        themes_to_generate = [args.theme]
+
+    # ── Display names ───────────────────────────────────────
+    display_city = args.display_city or args.city or ""
+    display_country = args.display_country or args.country_label or args.country or ""
+
+    # Coordinates for display — use GCJ-02 if China
+    display_lat, display_lon = lat, lon
+    if data_source == "sinogdb" and not args.gcj02:
+        # Data is WGS-84; convert to GCJ-02 for display (matches Chinese user expectation)
+        display_lon, display_lat = wgs84_to_gcj02(lon, lat)
+
+    # ── Fonts ───────────────────────────────────────────────
+    # Priority: user-specified > LXGWNeoZhiSong + Fraunces > Noto Sans SC > Roboto
+    custom_fonts = None
+    if args.font_family:
+        custom_fonts = load_fonts(args.font_family)
+
+    if data_source == "sinogdb" and not custom_fonts:
+        # 1st: local LXGWNeoZhiSong (CJK serif) + Fraunces (Latin serif)
+        lxgw = Path("fonts/LXGWNeoZhiSong.ttf")
+        fraunces = Path("fonts/Fraunces_72pt-Regular.ttf")
+        if lxgw.exists():
+            custom_fonts = {
+                "bold": str(lxgw),      # LXGW covers both CJK + Latin
+                "regular": str(lxgw),
+                "light": str(lxgw),
+            }
+            print(f"✓ Using LXGW Neo ZhiSong + Fraunces")
+        else:
+            # 2nd: Google Fonts Noto Sans SC
+            print("Auto-loading Chinese font...")
+            custom_fonts = load_fonts("Noto Sans SC")
+            if not custom_fonts:
+                # 3rd: local cache
+                cached = Path("fonts/cache")
+                local = {
+                    "bold": str(cached / "noto_sans_sc_bold.ttf"),
+                    "regular": str(cached / "noto_sans_sc_regular.ttf"),
+                    "light": str(cached / "noto_sans_sc_light.ttf"),
+                }
+                if all(Path(p).exists() for p in local.values()):
+                    custom_fonts = local
+                    print("✓ Using cached Noto Sans SC")
+
+    # ── Generate ────────────────────────────────────────────
+    print("=" * 50)
+    print("City Map Poster Generator")
+    print(f"Data source: {data_source}")
+    print("=" * 50)
+
+    # Resolve city/country names
+    city_name = args.city or args.display_city or f"{lat:.4f},{lon:.4f}"
+    country_name = args.country or args.display_country or ""
+
+    # Coordinates
+    if lat is None or lon is None:
+        # Need geocoding (OSMnx path)
+        from cityposter.geocoding import get_coordinates
+        lat, lon = get_coordinates(args.city, args.country)
+        display_lat, display_lon = lat, lon
+
+    point = (lat, lon)
+    display_point = (display_lat, display_lon)
+
+    # Build reproduction shell command (will be updated per theme)
+    shell_cmd_base = "cityposter " + " ".join(
+        f'"{a}"' if " " in a else a for a in sys.argv[1:]
+    )
+
+    try:
+        for theme_name in themes_to_generate:
+            theme = load_theme(theme_name)
+            output_file = generate_output_filename(city_name, theme_name, args.format)
+
+            if data_source == "sinogdb":
+                print(f"\nGenerating SinoGDB poster for {display_city or city_name}...")
+                sino_data = fetch_china_city_data(
+                    lat, lon, args.distance,
+                    data_dir=args.sinogdb_dir,
+                    include_pois=True,  # always fetch railway/transport for custom POIs too
+                    include_buildings=False,
+                )
+                # Inject custom POIs (only when --custom-poi flag is used)
+                if args.custom_pois is not None:
+                    from geopandas import GeoDataFrame
+                    from shapely.geometry import Point as ShapelyPoint
+
+                    # 1. CLI inline custom-poi value
+                    if args.custom_pois:  # non-empty list
+                        spec = args.custom_pois if isinstance(args.custom_pois, str) else args.custom_pois[0]
+                        parts = spec.split(",")
+                        if len(parts) >= 4:
+                            name, clat, clon, cat = parts[0], float(parts[1]), float(parts[2]), parts[3]
+                            cli_gdf = GeoDataFrame(
+                                [{"name": name, "station": cat, "geometry": ShapelyPoint(clon, clat)}],
+                                crs="EPSG:4326"
+                            )
+                            if sino_data.get("railway_stations") is not None:
+                                sino_data["railway_stations"] = GeoDataFrame(
+                                    list(sino_data["railway_stations"].to_dict("records")) +
+                                    cli_gdf.to_dict("records"), crs="EPSG:4326"
+                                )
+                            else:
+                                sino_data["railway_stations"] = cli_gdf
+                            print(f"✓ Custom POI: {name}")
+
+                    # 2. Config file POIs
+                    from cityposter.config_poi import load_custom_pois
+                    config_gdf = load_custom_pois(city=display_city)
+                    if not config_gdf.empty:
+                        config_records = config_gdf.to_dict("records")
+                        if sino_data.get("railway_stations") is not None and not sino_data["railway_stations"].empty:
+                            sino_data["railway_stations"] = GeoDataFrame(
+                                list(sino_data["railway_stations"].to_dict("records")) + config_records,
+                                crs="EPSG:4326"
+                            )
+                        else:
+                            sino_data["railway_stations"] = config_gdf
+                        print(f"✓ Custom POI: {len(config_gdf)} from config/")
+                # Default road width boost for SinoGDB: thicker lines compensate for
+                # the fact that SinoGDB roads are individual line segments (vs OSMnx graph edges)
+                road_boost = args.road_width_boost if args.road_width_boost is not None else 2.5
+                create_poster_sinogdb(
+                    city=display_city,
+                    country=display_country,
+                    sino_data=sino_data,
+                    point=display_point,
+                    dist=args.distance,
+                    theme=theme,
+                    output_file=output_file,
+                    output_format=args.format,
+                    width=args.width,
+                    height=args.height,
+                    display_city=display_city,
+                    display_country=display_country,
+                    fonts=custom_fonts,
+                    road_width_boost=road_boost,
+                    include_pois=args.poi,
+                    shell_cmd=shell_cmd_base,
+                )
+            else:
+                # OSMnx path (existing)
+                from cityposter.data.fetcher import fetch_osmnx_data
+                print(f"\nGenerating OSMnx poster for {display_city or city_name}...")
+                g, water, parks = fetch_osmnx_data(point, args.distance, args.width, args.height)
+
+                create_poster_osmnx(
+                    city=display_city,
+                    country=display_country,
+                    g=g,
+                    water=water,
+                    parks=parks,
+                    point=display_point,
+                    dist=args.distance,
+                    theme=theme,
+                    output_file=output_file,
+                    output_format=args.format,
+                    width=args.width,
+                    height=args.height,
+                    display_city=display_city,
+                    display_country=display_country,
+                    fonts=custom_fonts,
+                    shell_cmd=shell_cmd_base,
+                )
+
+        print("\n" + "=" * 50)
+        print("✓ Poster generation complete!")
+        print("=" * 50)
+
+    except Exception as e:
+        print(f"\n✗ Error: {e}")
+        traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()