# Input Cases

这个工具目前验证过两类 OSM XML 输入。

## Case 1: Overpass/OSM XML

配置：

- [config/default.json](/Users/que01/osm2streets-qgis-workflow/config/default.json)

输入：

- `/Users/que01/Downloads/osm.xml`

特点：

- XML 属性使用双引号，例如 `lat="30.x" lon="114.x"`。
- 数据规模较小，适合调样式。
- 已生成路面、人行道、中心线、停止线、方向箭头。

最近一次验证规模：

- nodes: 1368
- ways: 100
- relations: 9
- road_surface: 133
- sidewalks: 102
- lane_arrows_webscale: 1565

## Case 2: JOSM OSM XML

配置：

- [config/hanyang-block.json](/Users/que01/osm2streets-qgis-workflow/config/hanyang-block.json)

输入：

- `/Users/que01/Desktop/汉阳区区块.osm`

特点：

- XML 属性使用单引号，例如 `lat='30.x' lon='114.x'`。
- 文件头包含 `generator='JOSM'`。
- 数据规模更大，osm2streets 会输出较多拓扑裁切提示，例如 `trimmed into oblivion`、`layers don't match`。
- 这些提示不一定阻止产物生成，但如果 QGIS 里出现明显断口，优先检查原始 OSM 路网连接、裁剪边界和 `layer` 标签。

最近一次验证规模：

- nodes: 6360
- ways: 696
- relations: 59
- road_surface: 1894
- sidewalks: 1379
- lane_arrows_webscale: 19390

## 建新配置的建议

从模板复制：

```bash
cp /Users/que01/osm2streets-qgis-workflow/config/examples/template.json \
  /Users/que01/osm2streets-qgis-workflow/config/my-area.json
```

至少修改：

- `input`
- `outDir`
- `gpkg`
- `project`
- `preview`

运行：

```bash
cd /Users/que01/osm2streets-qgis-workflow
node scripts/build-osm2streets-qgis.js --config config/my-area.json
```

## 兼容性说明

脚本的 OSM bbox 解析已兼容：

- `lat="..." lon="..."`
- `lat='...' lon='...'`

osm2streets 本身仍要求输入是标准 OSM XML。若输入来自其它 GIS 格式，先转换成 OSM XML 或改造脚本入口。