核心功能与用法
Map Grabber 是一款面向建筑、城市规划及GIS专业用户的OpenStreetMap数据提取工具。用户只需提供地址或地名（如"Times Square, New York"），即可自动获取指定半径范围内的街道网络矢量数据，并可选择下载建筑物轮廓。输出格式涵盖：
- PNG — 即时预览图，适合Telegram聊天场景快速展示
- SVG — 矢量格式，便于后期图形编辑
- GeoPackage — 标准GIS格式，保留完整空间属性
- DXF — CAD/Rhino原生格式，无缝对接建筑设计工作流
典型命令示例：
python3 scripts/grab_map.py "Shanghai Tower, Shanghai" --dist 500 --buildings --png site.png --gpkg site.gpkg --dxf site.dxf
参数--dist控制采集半径（默认500米），--buildings启用建筑轮廓下载。工具依赖osmnx（底层调用geopandas与networkx），DXF导出需额外安装ezdxf。
显著优势
1. 零门槛地址解析：无需手动获取坐标，自然语言地址直接解析
2. 多格式并行输出：单次运行可同时生成预览图、GIS数据与CAD文件
3. 专业工作流适配：DXF原生支持Rhino/AutoCAD，GeoPackage兼容QGIS/ArcGIS
4. 开源数据基础：基于OpenStreetMap，全球覆盖且持续更新
局限性与风险
依赖管理：工具不自动安装Python依赖，用户需手动执行pip install -r requirements.txt，版本冲突可能导致osmnx或geopandas安装失败。
数据完整性：OpenStreetMap为众包数据，偏远地区或新建区域可能存在道路缺失、建筑轮廓不完整等情况，需人工校验。
精度边界：默认提取的是街道中心线网络，非精确道路边线；建筑轮廓为简化多边形，不含层高、材质等属性。
DXF兼容性：ezdxf生成的DXF文件在部分CAD版本中可能出现图层或线型解析差异。
适用人群
- 建筑师/规划师 — 快速获取场地周边道路与肌理
- 景观设计师 — 分析场地通达性与周边建筑密度
- 城市研究者 — 批量提取研究区域基础地理数据
- 学生与教学场景 — 零成本获取全球任意地点底图
常规风险提示
- 网络依赖：OpenStreetMap API访问需稳定网络，大规模批量请求可能触发速率限制
- 坐标系注意：输出数据通常为WGS84，CAD用户导入时需注意投影转换
- 合规使用：OSM数据遵循ODbL许可，商业项目需遵守署名与共享协议条款