（8208期）Geoskill: China Admin Divisions – 中国行政区划矢量数据一键获取

中国行政区划矢量数据一键获取 基于瑞朵豹公开API的免费五级行政区划数据下载工具，无需认证即可获取省/市/县/乡/村GeoJSON、Shapefile等多格式矢量数据，支持批量下载与空间分析。 使用说明 核心用法 china-admin-divisions 是一个命令行工具，通过调用瑞朵豹（map.ruiduobao.com）免费公开 API，实现中国五级行政区划（省、市、县、乡、村）矢量数据的检索与下载。用户可通过 search 子命令模糊查询行政区划，使用 cities/counties/towns/villages 进行树状层级下钻浏览，或直接用 download 下载指定区划的矢量边界。支持 GeoJSON、Shapefile、KML、GeoPackage、SVG、PNG 六种输出格式，满足不同场景需求。info 和 bbox 子命令可获取区划元信息及带缓冲区的边界框（bbox），download-children 支持批量下载某级所有下辖区划。 显著优点 零门槛使用：无需 API Key、注册账号或任何身份认证，开箱即用。 覆盖层级完整：罕见地支持到村级（12位编码）的行政区划数据查询。 格式生态丰富：从专业 GIS 的 Shapefile/GeoPackage，到前端友好的 SVG/GeoJSON，再到即插即用的 PNG，覆盖数据分析师、开发者、设计师多元需求。 空间计算内建：自动计算面积，支持自定义公里级 bbox 扩展，便于空间分析场景。 批量能力：download-children 可一键拉取整省所有市级或县级数据，提升效率。 网络优化：默认直连国内主机，绕过代理避免 VPN 不稳定问题，同时保留代理开关选项。 潜在缺点与局限性 矢量数据不完整：乡、村级区划在 API 端常无面边界数据，仅返回元信息，vector_available 标记为 false，需用户自行处理缺失情况。 服务稳定性依赖：依赖瑞朵豹免费公共服务，无 SLA 保障，高频调用可能被限流，不适合生产环境大规模自动化调度。 精度与投影限制：1km 缓冲区使用平面近似公式，高纬度地区或特殊边界场景存在几何失真风险；数据为 WGS84 经纬度，未提供高斯-克吕格等国内常用投影。 PNG 格式限制：输出为纯形状无文字标注，需后期处理才能用于标注地图。 更新时效未明：数据源年份标注为 2023，未说明更新机制，行政区划调整后可能存在滞后。 适合的目标群体 GIS 与数据分析师：快速获取标准行政区划边界用于空间分析、可视化底图。 前端/可视化开发者：获取 GeoJSON/SVG 用于 Web 地图、数据大屏开发。 学术研究人员：获取研究区域的行政区划数据，支持社科、经济、环境等空间研究。 政府与咨询顾问：制作报告插图、区域分析底图，PNG/SVG 即插即用。 Python 自动化用户：通过脚本批量获取数据，搭建数据处理流水线。 常规使用风险 网络依赖风险：API 为第三方免费服务，存在不可用或变更接口契约的可能，关键业务建议本地缓存或寻找官方数据源备份。 数据合规风险：行政区划数据涉及国家基础地理信息，公开 API 数据精度经过降密处理，但用于敏感场景（如精确测绘、军事用途）需确认合规性。 性能风险：批量下载大省数据（如广东省所有乡镇）可能触发限流或导致长时间等待，建议分批次执行并增加重试逻辑。 文件写入风险：--out 参数指定路径时需注意目录权限，批量模式可能生成大量文件，需预留磁盘空间。 代理配置风险：特殊网络环境下若未正确配置 RUIDUOBAOUSEPROXY，可能导致连接失败，需根据实际网络拓扑调整。 原始说明 Download and query five-level Chinese administrative division vector data from map.ruiduobao.com in GeoJSON, Shapefile, KML, GeoPackage, SVG, or PNG formats...