# 数据许可（data/ 目录）

本目录下的数据文件（全部 `metro*.json` 与 `map-*.json`，含各城市线网/底图与全国选城地图 `map-china.json`）**不适用**仓库根目录的 MIT 许可，单独按以下条款提供。

## 来源与许可

- **主体数据**（线路、站序、站名、坐标、轨道与底图几何）派生自 [OpenStreetMap](https://www.openstreetmap.org)，按 [Open Database License (ODbL) 1.0](https://opendatacommons.org/licenses/odbl/1-0/) 提供。
- **署名**：© OpenStreetMap contributors（数据文件顶层 `meta.attribution` 字段随数据同行）。
- **辅助来源**：
  - 未开通车站的排除：OSM 路线 relation 收录口径 + 构建脚本人工修正表 + 官网站数断言（构建管线不请求 Wikidata，其仅在选型调研阶段用作交叉验证）。
  - 运营方公布的站表（**仅**上海、北京、深圳三城，且**仅在构建期用于 QA 比对**，其内容不进入发布物）：
    - 上海地铁官网英文站表（service.shmetro.com/en）：站数与英文站名 QA。
    - 北京地铁官方线路图数据（map.bjsubway.com/subwaymap/beijing.xml 与 /stations 端点）：站序断言与中英文站名 QA。
    - 深圳地铁官方站点查询数据集（www.szmc.net 的 zdWeb xlurlList.js）：站序与中文站名 QA；英文名取自同一数据集，另与官方英文时刻表页及 Wikipedia 交叉核对。
  - 杭州地铁官方运营接口（www.hzmetro.com/api/operation/all，**只有中文**）：仅用于构建期站序与中文站名 QA 比对。
  - Wikipedia（en.wikipedia.org，2026-07-17 检索，[CC BY-SA](https://en.wikipedia.org/wiki/Wikipedia:Copyrights)）：广州、成都、武汉、南京、杭州五城的**英文站名**逐线核自 Wikipedia 列表页或单线条目（南京取单线条目，列表页有已知错行）。这五城运营方不公布英文站表（广州 gzmtr.cn、成都 chengdurail.com、武汉 whrt.gov.cn）、只出中文（杭州）或站点不可达（南京 njmetro.com.cn），故**这五城的英文名属众包转写，不是官方转写，不得标作「官方英文名」**（口径见 `docs/adr/0003-strict-official-pinyin.md`）。
  - 线路官方色：Wikipedia 各城线路色模板 / rmg-palette / 官方线路图，见 `scripts/cities/<city>.ts` 与 `scripts/line-colors.ts` 注释。
  - `map-china.json` 的国界/省界几何与台湾岛岸线派生自 OSM（同上 ODbL）；其中 46 个地铁城市**点位坐标为内置常量表**（城市中心点，人工整理自公开地理资料，非 OSM 派生），城市清单与层级来自 `docs/multicity-survey.md` 普查。未使用 Natural Earth。

## 使用本目录数据时你的义务（ODbL 摘要）

以下为方便阅读的摘要，以 [ODbL 1.0 全文](https://opendatacommons.org/licenses/odbl/1-0/) 为准：

1. **署名（Attribution)**：公开使用本数据或其派生数据库时，必须注明数据来自 OpenStreetMap，署名 © OpenStreetMap contributors，并指明数据按 ODbL 提供。
2. **相同方式共享（Share-Alike）**：公开分发本数据的派生数据库时，派生数据库本身必须同样按 ODbL（或兼容许可）开放。
3. **保持开放（Keep Open）**：可以对数据施加技术限制措施分发，但必须同时提供无限制的版本。

## 获取本数据库的机读副本（ODbL 4.6）

ODbL 1.0 第 4.6 条要求：公开使用派生数据库或其 Produced Work 的人，必须向接收者提供该派生数据库的机读副本。打字进站的站点访问者就是这里的「接收者」，本节即是那份 offer。

本目录下的全部文件已随站点构建原样发布在 `/data/` 路径下，无需注册、无速率限制、无技术限制措施，直接取用即可（合计约 2.0 MB）。
下表左列是站点上的完整路径（可直接敲进地址栏），链接目标写成相对路径，因此在仓库里和在站点上点都能跳：

| 文件 | 内容 |
| --- | --- |
| [`/data/metro.json`](metro.json) | 上海线网（线路、站序、站名、坐标） |
| [`/data/metro.beijing.json`](metro.beijing.json) | 北京线网 |
| [`/data/metro.guangzhou.json`](metro.guangzhou.json) | 广州线网 |
| [`/data/metro.shenzhen.json`](metro.shenzhen.json) | 深圳线网 |
| [`/data/metro.chengdu.json`](metro.chengdu.json) | 成都线网 |
| [`/data/metro.hangzhou.json`](metro.hangzhou.json) | 杭州线网 |
| [`/data/metro.wuhan.json`](metro.wuhan.json) | 武汉线网 |
| [`/data/metro.nanjing.json`](metro.nanjing.json) | 南京线网 |
| [`/data/map-shanghai.json`](map-shanghai.json) | 上海底图与轨道几何 |
| [`/data/map-beijing.json`](map-beijing.json) | 北京底图与轨道几何 |
| [`/data/map-guangzhou.json`](map-guangzhou.json) | 广州底图与轨道几何 |
| [`/data/map-shenzhen.json`](map-shenzhen.json) | 深圳底图与轨道几何 |
| [`/data/map-chengdu.json`](map-chengdu.json) | 成都底图与轨道几何 |
| [`/data/map-hangzhou.json`](map-hangzhou.json) | 杭州底图与轨道几何 |
| [`/data/map-wuhan.json`](map-wuhan.json) | 武汉底图与轨道几何 |
| [`/data/map-nanjing.json`](map-nanjing.json) | 南京底图与轨道几何 |
| [`/data/map-china.json`](map-china.json) | 全国选城地图（国界/省界几何） |
| [`/data/LICENSE-DATA.md`](LICENSE-DATA.md) | 本文件 |

这 17 个 json 就是站点实际加载的那份派生数据库的全部内容，不是抽样、摘要或降采样版本，因此本节按 4.6 的 (a) 路「the entire Derivative Database」履行，无需再单独提供 (b) 路的 alterations 文件。每个文件顶层的 `meta` 字段自带署名与生成信息。

说明：ODbL 4.4 的 Share-Alike 只约束数据库及其内容，不延伸到消费数据库的应用源代码，因此本站的应用代码不因本条款而必须开放（应用代码另按根目录 MIT 授权，但仓库是否公开由作者自行决定）。

## 修改与再分发

本目录的数据由构建脚本从 OSM 生成，人工修正表（未开通车站排除、站名读音裁定等）内嵌在 `scripts/cities/<city>.ts`。若你在此基础上继续派生并公开使用，你自己也要履行上述 4.2 署名与 4.6 提供副本的义务。

生成方式：`bun run data:build [--city=beijing]`（线网数据）、`bun run map:build [--city=beijing]`（底图与轨道几何，缺省 shanghai）与 `bun run china:build`（全国选城地图），管线说明见 `docs/adr/0004-osm-wikidata-data-pipeline.md`、`docs/adr/0005-offline-vector-basemap-multicity.md` 与 `docs/adr/0008-multicity-rollout.md`。

---

The data files in this directory (all `metro*.json` and `map-*.json`, including the national city-picker map `map-china.json`) are derived from OpenStreetMap and are made available under the Open Database License (ODbL) 1.0. © OpenStreetMap contributors. They are NOT covered by the repository's MIT license. If you publicly use or redistribute these files or databases derived from them, you must attribute OpenStreetMap and keep derivative databases under ODbL.

**ODbL section 4.6 (Access to Derivative Databases).** The entire Derivative Database used by this site is offered to every recipient in machine readable form: all 17 json files listed above are published, unmodified and unrestricted, under `/data/` on the built site (about 2.0 MB in total). No registration, no rate limit, no technical restriction measures. This satisfies option (a) of section 4.6, so no separate alterations file under option (b) is provided.