prettymaps：一行 Python 调用，把任意地名变成海报级地图

项目概览

prettymaps 是一个极简的 Python 库，用于从 OpenStreetMap 数据绘制定制化地图，README 明确列出其底层的四个包：osmnx、matplotlib、shapely 和 vsketch。文档里的一行示例就是全部卖点——prettymaps.plot('Porto Alegre, Brazil')——输入一个地名字符串，输出一张风格化城市地图。在截至 2026-08-21 的趋势窗口内，它新增 627 颗星、排名第 8，这正是'成品图值得装框'的截图型库特有的传播速度。

对一个如此小的项目而言，它的学习面异常完整。文档站托管在 GitHub Pages，包含 index、tutorial.md、usage.md 和 api.md；README 指向的完整 markdown 教程覆盖 Plot 数据类字段、layers 与 style 参数、预设、multiplot、山体阴影和 keypoints。同一份教程以 marimo 笔记本形式放在 notebooks/tutorial.py，并提供 Google Colaboratory 版本；仓库还内置 Streamlit 前端，用 streamlit run app.py 即可启动。初学者从 pip install 到图形界面，全程不需要写一个循环。

定制方式就是两个字典。layers 决定画什么——perimeter、streets（带 width 参数）、buildings、water；style 决定每层长什么样，使用 matplotlib 风格的 fc/ec 颜色键。prettymaps.plot('Tokyo, Japan', save_as='tokyo_map.png') 把结果写入磁盘，文档特性列表还提到 PNG 之外的 SVG 与绘图仪友好格式导出。预设让喜欢的风格跨城市复用，keypoints 高亮特定地点，hillshade 增加山体阴影营造伪 3D 效果。

治理条款与功能同等重要。项目采用 GNU AGPL v3.0 许可：README 说明可以商用、分发和修改，但必须连同许可与版权声明公开源码。成品图需保留对仓库和 OpenStreetMap 的署名，README 称这是 OSM 许可的强制要求。作者还明确表示不授权任何形式的 NFT 用途，点名 AeternaCivitas 与 geoartnft 两个未署名售卖 NFT 的项目，并因此关闭了自己的其他生成艺术项目。

为什么现在变热

• 趋势窗口内新增 627 星、2026-08-21 排名第 8：海报级成图天然适合社交传播，每个用户的渲染图都是一次自来水宣传。
• README 保存了 Hacker News 首页的存档链接，并链接 r/prettymaps_ 子版块——两条持续带来新访客的发现渠道。
• 从 pip install prettymaps 到出图只差一次函数调用，不需要任何 GIS 背景。
• 教程导览用 Heerhugowaard（默认预设）对比 Macau（自定义参数），两张图就展示了定制上限。
• Google Colab 演示加 Streamlit 前端，意味着第一次尝试可以完全跳过本地安装。

解决什么问题

• 做艺术感城市地图，传统上要么在桌面 GIS 软件里调几十个制图参数，要么在设计工具里手工描图。
• 自己拉取 OpenStreetMap 几何数据，意味着为想画的每一层去处理 osmnx 查询、GeoPandas 表和 matplotlib 图元。
• 绘图仪创作者需要干净的矢量几何，而不是网页地图的栅格截图。
• 手工在多个城市复刻同一套风格不可持续，而这正是预设系统自动化的事情。

工作原理

1. 运行 pip install prettymaps 安装；README 徽章要求 Python 3.11+。在 Colab 上使用 !pip install -e "git+https://github.com/marceloprates/prettymaps#egg=prettymaps"，导入前需重启运行时。
2. 跑快速开始：prettymaps.plot('Stad van de Zon, Heerhugowaard, Netherlands') 会拉取该查询的 OpenStreetMap 要素并渲染。
3. 按 docs/usage.md 的两个字典模式定制：layers={'perimeter': {}, 'streets': {'width': 8}, 'buildings': {}, 'water': {}}，再配一个含 fc/ec 颜色的 style 字典。
4. 用 prettymaps.plot('Tokyo, Japan', save_as='tokyo_map.png') 保存结果；docs/index.md 列出 PNG、SVG 和绘图仪友好导出。
5. 通过 docs/tutorial.md 进阶——预设、keypoints、山体阴影、multiplot——或直接用 streamlit run app.py 跳过写代码。
6. 跟随 notebooks/tutorial.py 的 marimo 笔记本或其 Google Colaboratory 副本完整学习。

产品演示与界面预览

谁适合关注

风险与注意事项

• 地图数据经由 osmnx 走网络获取；输入是地名字符串而非凭据。
• Colab 安装命令直接从 GitHub 仓库安装（git+https），若在意供应链来源，应固定并审查所执行的提交。
• README 与文档未描述任何账号、密钥或遥测机制。
• 主要审计项是许可合规：衍生作品须随附 AGPL v3 许可文本与版权声明。

替代方案比较

这个趋势说明了什么