# 杭州湖山沙盘 V3 · 地理与视觉来源

制作与检索日期：2026-09-06。范围是西湖及周边山城、钱塘江北岸，不是整个杭州市域。此版保留诗径的古意视觉，不声称复原某个朝代。

## 本次直接用于建模的数据

### OpenStreetMap

- 版权与许可：https://www.openstreetmap.org/copyright （© OpenStreetMap contributors，ODbL 1.0）。
- 查询接口：https://overpass-api.de/api/interpreter 。
- 本地可复查查询、时间和元素数量：`data/raw/download.json`。
- 原始下载：`data/raw/details-osm.json`，18,791 个元素。仅制作时使用，不由客户端加载。
- 客户端派生数据：`data/geography.json`。包含 11,448 个建筑轮廓、6,426 段道路、731 个林地/农业用地面、188 条水道；111 个水面片段包括复用的原版湖岸和新取的钱塘江水面。
- 水岸保留多边形孔洞；小瀛洲不是实心圆岛。建筑用实际轮廓，道路用实际走向。渲染时会剔除落水的建筑中心及与手工地标重叠的轮廓。
- 提供派生数据、生成脚本与原始下载，便于按 ODbL 检查和继续使用。发布时保留页面署名以及 ODbL 链接，不把这些地理数据宣称为原创。

### 高程

- 来源：https://registry.opendata.aws/terrain-tiles/ 。
- 复用此前保存在 `../data/raw/` 的 4 张 Mapzen Terrarium / Terrain Tiles z12 瓦片：3414/1686、3414/1687、3415/1686、3415/1687。
- 本次覆盖经纬度：`[120.066, 30.165, 120.206, 30.292]`，约 13.5 × 14.1 km。
- 280 × 280 展示采样网格；原始 z12 栅格在杭州约为几十米级。加密显示网格没有创造新的测绘细节。
- 为总览可读性，高程相对水位采用 2.4 倍纵向放大。湖面保持平整；路面与模型底部采样同一地形。
- 没有使用 Google 地图截图、商业三维瓦片或未经授权下载的摄影纹理。

### 原站内容

沿用 `../data/atlas.json` 中 16 条路线、61 处诗地、原坐标和诗词关联。本次没有重新认定文学出处，也不将坐标的精度等同于诗地关系已被全面核实。净因亭继续保持“休憩、诗文关系待考”的处理。

地标模型与诗地停驻点区分：雷峰塔模型对齐本次下载的 OSM `way/229726934` 建筑轮廓中心（120.14501305, 30.23388415），不因此改动原站的诗地停驻坐标。其他地标采用原站点位或邻近的展示锚点。

## 参考资料：决定空间与形态，不作为贴图

| 来源 | 使用角色 |
| --- | --- |
| [UNESCO：West Lake Cultural Landscape of Hangzhou](https://whc.unesco.org/en/list/1334/) | 三面山、一面城；长堤、人工岛、庭园与塔影共同组织景观，决定本版湖山城关系。 |
| [杭州官方：Baochu Pagoda](https://www.ehangzhou.gov.cn/2018-07/12/c_271636.htm) | 北岸宝石山上的保俶塔，以纤细塔身与南岸重檐雷峰塔区分。 |
| [杭州官方：Longjing Imperial Tea Garden](https://www.ehangzhou.gov.cn/2018-08/15/c_262281.htm) | 龙井、狮峰与茶园的山谷关系；茶垄不覆盖所有林地。 |
| [杭州官方：Wengjiashan tea village](https://ehangzhou.gov.cn/2026-03/02/c_296900.htm) | 西南茶山和西湖、钱塘江之间的关系。 |
| [杭州官方：Lingyin Temple](https://www.ehangzhou.gov.cn/2018-06/14/c_242885.htm) | 灵隐的山林寺院场景与位置参考。 |
| [杭州官方：West Lake route](https://ehangzhou.gov.cn/2020-07/10/c_270616.htm) | 断桥、白堤、平湖秋月、湖中岛与雷峰塔等景观联系。 |
| [浙江广电航拍页面](https://www.cztv.com/newsDetail/759064) | 实际查看航拍图，校准湖面开阔程度、北岸山林、堤岛与湖东城区的相对层次。只作视觉研究，没有下载、再分发或烘焙进网页；未假定图片有可复用授权。 |

## 哪些是艺术演绎

- 林地和地形决定植被区域；树木数量、树种组合、冠幅、路边树距是程序化示意，不是逐树测绘。
- 茶垄依映射的茶地/农地生成。行间距、弯曲和立体感是视觉设计，不是原地茶田的逐垄重建。
- 建筑有实际平面轮廓，未知高度按两层估计；高度有展示缩放与上限。灰瓦、浅墙和屋顶形态是古意重绘，现代街区不能因此被称作古杭州复原。
- 保俶塔、雷峰塔、六和塔及寺院是辨识性低模。重檐、塔身、院落的形态有意区分，但细部、尺度和朝向不是实测模型。
- 清晨/暮色是艺术光照，不是根据太阳位置计算的日照模拟。
- 地理参考不替代现实导航。浏览与漫游均为模拟，不记录为真实到访。

## 可重复制作

从 `demos/poemway-living-atlas` 目录执行：

```sh
# 已保存原始数据，通常不需要重新请求公共接口。
node v3/scripts/build-geography.mjs
node --test v3/tests/geography.test.mjs

# 确实需要刷新数据时才使用；不把它放入浏览器启动流程。
node v3/scripts/fetch-geography.mjs
node v3/scripts/build-geography.mjs
```

只加载编译后的本地 JSON，不在用户打开页面时调用 Overpass，也不要求第三方地图 token。