osmWorkflow/README.md

osm2streets QGIS workflow

把 Overpass/OSM XML 转成接近 osm2streets web 风格的 QGIS 工程。

当前默认输入输出在 config/default.json 里配置：

• 输入 OSM XML：/Users/que01/Downloads/osm.xml
• 中间 GeoJSON：/Users/que01/Downloads/osm2streets_web_out/
• GeoPackage：/Users/que01/Downloads/osm2streets_webstyle.gpkg
• QGIS 工程：/Users/que01/Downloads/osm2streets_webstyle.qgz
• 预览图：/Users/que01/Downloads/osm2streets_webstyle_preview.png

已验证的输入案例记录在 docs/input-cases.md，变更记录在 docs/changelog.md。目前包括：

• /Users/que01/Downloads/osm.xml
• /Users/que01/Desktop/汉阳区区块.osm

环境

需要：

• macOS QGIS：默认 /Applications/QGIS.app
• Node.js / npm

首次使用：

cd /Users/que01/osm2streets-qgis-workflow
npm install

运行

使用默认配置：

cd /Users/que01/osm2streets-qgis-workflow
npm run build

使用另一套配置：

node scripts/build-osm2streets-qgis.js --config /path/to/config.json

汉阳区区块案例：

node scripts/build-osm2streets-qgis.js --config config/hanyang-block.json

创建新区域配置可以从模板复制：

cp config/examples/template.json config/my-area.json

命令行参数可以覆盖配置文件：

node scripts/build-osm2streets-qgis.js \
  --input /path/to/osm.xml \
  --out-dir /path/to/out \
  --gpkg /path/to/osm2streets_webstyle.gpkg \
  --project /path/to/osm2streets_webstyle.qgz \
  --preview /path/to/osm2streets_webstyle_preview.png

调整箭头大小：

node scripts/build-osm2streets-qgis.js --arrow-scale 0.8

当前调好的箭头比例是 0.8。如果 QGIS 里仍偏大，试 0.6；偏小则试 1.0。

配置项

默认配置文件：

{
  "qgisApp": "/Applications/QGIS.app",
  "input": "/Users/que01/Downloads/osm.xml",
  "outDir": "/Users/que01/Downloads/osm2streets_web_out",
  "gpkg": "/Users/que01/Downloads/osm2streets_webstyle.gpkg",
  "project": "/Users/que01/Downloads/osm2streets_webstyle.qgz",
  "preview": "/Users/que01/Downloads/osm2streets_webstyle_preview.png",
  "arrowScale": 0.8,
  "clipPad": 0.002,
  "canvasPad": 0.001,
  "previewPad": 0.0007,
  "canvasExtent": null,
  "previewExtent": null
}

常用项：

• input：OSM XML 输入。
• outDir：osm2streets GeoJSON 中间产物目录。
• gpkg：最终 GeoPackage。
• project：最终 QGIS 工程。
• preview：预览 PNG。
• qgisApp：QGIS.app 路径。
• arrowScale：方向箭头几何缩放，当前推荐 0.8。
• canvasExtent：QGIS 打开后的初始范围，格式 "xmin,ymin,xmax,ymax"；为 null 时自动按 OSM bbox 扩展。
• previewExtent：预览 PNG 范围，格式同上；为 null 时自动选第一个箭头附近。

输出图层

GeoPackage 内会生成：

• road_surface
• intersection_surface
• sidewalks
• sidewalk_corners
• lane_separators
• center_lines
• vehicle_stop_lines
• lane_arrows_webscale
• crosswalks

QGIS 工程的绘制顺序已经固定为：路段和路口路面在底，车道线、斑马线、停止线和箭头在上。

注意

这套流程复用 osm2streets 的几何输出，再用 QGIS 符号化模拟 web 效果。它不会完全等同 osm2streets web renderer，但能稳定得到路面、人行道、停止线、中心线和方向箭头。

脚本已经兼容 OSM XML 节点坐标的双引号和单引号属性。Overpass 导出的 XML 和 JOSM 导出的 .osm 都已验证过。