中国行政区划数据：开发者的终极使用指南 🗺️

想要在项目中快速集成中国行政区划数据吗？china-division 项目为你提供了完整的解决方案！这个开源项目包含了从省级到村级的五级行政区划数据，让你告别繁琐的数据收集工作。💪

项目概览

china-division 是一个专门收集和整理中国行政区划数据的开源项目，包含了省级、地级、县级、乡级、村级五个层级的完整数据。无论是开发地址选择器、数据统计系统还是地图应用，这个项目都能为你节省大量时间。⏰

数据格式详解

项目提供了多种数据格式，满足不同开发需求：

JSON 格式数据

• 省级数据：provinces.json - 包含全国所有省份、直辖市和自治区
• 地级数据：cities.json - 全国所有地级市数据
• 县级数据：areas.json - 完整的区县级行政区划
• 联动数据：pca.json - 省市区三级联动专用格式

CSV 格式数据

如果你需要导入到数据库或进行数据分析，CSV 格式是最佳选择。项目提供了与 JSON 对应的 CSV 文件，便于批量处理。

快速上手指南

安装与使用

npm install china-division

然后在你的项目中直接引入：

const chinaDivision = require('china-division')

// 获取所有省份
console.log(chinaDivision.provinces)

// 使用联动数据
console.log(chinaDivision.pca)

数据库支持

项目还提供了 SQLite 数据库文件 data.sqlite，包含了完整的五级行政区划数据。你可以使用 lib/sqlite.js 中的模型定义来操作数据。

实际应用场景

地址选择器开发

利用项目提供的联动数据，你可以快速构建多级地址选择组件。无论是二级联动（省-市）、三级联动（省-市-区）还是更复杂的四级联动，都能轻松实现。

数据统计分析

在进行用户地域分布分析、销售区域统计等场景时，完整准确的行政区划数据至关重要。

地图应用集成

为地图应用提供准确的地理位置信息，确保数据的一致性和权威性。

数据更新说明

📢 重要提示：根据国家统计局的最新政策，自2024年10月起不再公开具体相关代码。本项目已更新至2023年统计用区划代码和城乡划分代码（截止时间：2023-06-30），是目前可用的最新官方数据。

最佳实践建议

1. 缓存策略：对于不经常变动的行政区划数据，建议在本地进行缓存
2. 数据验证：在使用数据前，建议进行必要的数据验证
3. 错误处理：在数据加载失败时提供降级方案

结语

china-division 项目为开发者提供了完整、准确的中国行政区划数据解决方案。无论你是前端开发者、后端工程师还是数据分析师，这个项目都能为你的工作带来便利。🚀

赶快尝试一下吧，让行政区划数据集成变得简单高效！