SuperAPI AI 工具集

osm-pbfs

数据与分析

查看项目

更新于 10-22 06:52

技能介绍

用途:osm-pbfs 是一个面向 OpenStreetMap PBF 数据文件的本地缓存管理技能,适用于需要 .osm.pbf 文件的任务。由于此类文件体积很大(示例中德国约 4.5 GB),该技能主张在机器上只保留一份共享缓存,并通过符号链接把所需提取文件引入各项目,避免重复下载与拷贝。

主要能力与使用方式:

  1. 定位缓存:通过 PBF_DIR="${OSM_PBFS_DIR:-$HOME/Development/_osm-pbfs}"; ls -lh "$PBF_DIR" 查找机器本地共享缓存;若目录不存在,需先阅读 references/setup.md。
  2. 链接而非复制:从缓存向仓库创建符号链接,使用绝对目标路径以便在 worktree 中也可用,例如 ln -s "$PBF_DIR/berlin-latest.osm.pbf" ./berlin-latest.osm.pbf。
  3. 不重复下载:缓存中已有的提取文件不再下载;缺失的提取文件先下载到缓存,再建立符号链接。资料给出下载示例:curl -L -o "$PBF_DIR/brandenburg-latest.osm.pbf" "https://download.geofabrik.de/europe/germany/brandenburg-latest.osm.pbf"。
  4. 版本控制约束:不要提交 .osm.pbf 文件,确保 *.osm.pbf 被 gitignore。

交互规则:若项目内存在真实(非符号链接)副本,应先询问用户,提议替换为符号链接;仅在用户确认后删除重复文件,且使用 trash 而非 rm;若用户希望保留私有副本,则遵从用户意愿。

适用场景:需要引用大型 OSM PBF 提取文件的开发或数据处理项目,尤其是多项目共享同一份地理数据、希望减少磁盘占用与下载次数的环境。

限制:资料未提供该技能对操作系统、文件系统或 OSM 工具链的具体支持范围,暂未提供安装步骤与更多平台信息;具体缓存初始化细节需参考其 setup 文档。