解锁行政区划数据：高效获取与应用的4个实用技巧

2026-05-03 10:19:02作者：冯爽妲Honey

副标题：基于2023年国家统计局数据的五级区划解决方案

当你的电商系统需要实时更新31个省400+城市的区划数据时，当物流配送系统需要精确到乡镇街道的地址匹配时，当政务平台需要展示最新的村级行政区划信息时，你是否正在为高质量的区划数据获取而困扰？本文将带你通过实用技巧，掌握行政区划数据的获取、处理与应用全流程，让地址相关功能开发不再成为项目瓶颈。

一、快速定位：按需选择行政区划数据文件

在实际开发中，不同业务场景需要不同层级的行政区划数据。以下是针对常见需求场景的文件选择指南：

场景1：省级行政区划选择

对应数据文件：provinces.json / provinces.csv 应用案例：全国性平台的省份筛选功能，如天气查询应用的省份选择器。通过直接加载省级数据文件，可快速构建简洁的省份选择列表，减少不必要的数据传输。

场景2：城市级数据联动

对应数据文件：cities.json / cities.csv、pc.json / pc-code.json 应用案例：电商平台的收货地址二级联动。使用pc.json可直接实现"省份-城市"的联动效果，无需额外处理关联关系，提升前端加载速度。

场景3：区县及以下详细地址

对应数据文件：areas.json / areas.csv、streets.json / streets.csv、villages.json / villages.csv、pca.json / pca-code.json、pcas.json / pcas-code.json 应用案例：物流配送系统的详细地址定位。结合pca.json和pcas.json，可实现"省份-城市-区县-乡镇"的四级联动，满足精确到乡镇街道的配送需求。

二、本地部署与云端集成：两种行政区划数据应用方案对比

本地部署方案

实现方式：通过项目提供的脚本导出数据文件，结合SQLite数据库进行本地存储和查询。优势：数据响应速度快，无网络依赖，适合对数据实时性要求不高的场景。 操作步骤：

克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ad/Administrative-divisions-of-China
安装依赖：npm install
导出所需格式数据：./export_json.sh 或 ./export_csv.sh
使用SQLite数据库：通过lib/sqlite.js模块操作dist/data.sqlite文件

JavaScript查询示例：

const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database('dist/data.sqlite');

// 查询特定省份的所有城市
db.all("SELECT code, name FROM cities WHERE provinceCode = ?", ['11'], (err, rows) => {
  if (err) {
    console.error(err.message);
  }
  console.log("北京市下属城市：");
  rows.forEach(row => {
    console.log(`${row.code}: ${row.name}`);
  });
});

db.close();

云端集成方案

实现方式：将导出的数据文件部署到云服务器，通过API接口提供数据服务。优势：便于多端共享数据，支持实时更新，适合多应用协同的企业级场景。 关键技术点：

使用Node.js搭建简单的API服务
将JSON数据文件作为静态资源提供
实现数据缓存策略，提高响应速度

Python调用示例：

import requests
import json

def get_provinces():
    url = "https://your-api-server.com/data/provinces.json"
    response = requests.get(url)
    if response.status_code == 200:
        return json.loads(response.text)
    else:
        return None

provinces = get_provinces()
if provinces:
    print("省级行政区划列表：")
    for province in provinces:
        print(f"{province['code']}: {province['name']}")

三、5步搭建本地行政区划数据API服务

💡 技巧提示：通过搭建本地API服务，可以模拟真实的后端接口，方便前端开发和测试，无需等待后端接口就绪。

准备数据文件 执行导出脚本生成所需的JSON数据文件：
```
./export_json.sh
```
该命令会在项目根目录下生成dist文件夹，包含各级行政区划的JSON文件。

创建简单的Node.js服务器 在项目根目录下创建server.js文件：

const http = require('http');
const fs = require('fs');
const path = require('path');

const server = http.createServer((req, res) => {
  // 设置CORS头，允许跨域请求
  res.setHeader('Access-Control-Allow-Origin', '*');
  
  // 解析请求路径
  const dataPath = path.join(__dirname, 'dist', req.url === '/' ? 'provinces.json' : req.url);
  
  // 读取并返回数据文件
  fs.readFile(dataPath, 'utf8', (err, data) => {
    if (err) {
      res.writeHead(404);
      res.end(JSON.stringify({ error: 'File not found' }));
      return;
    }
    res.writeHead(200, { 'Content-Type': 'application/json' });
    res.end(data);
  });
});

const PORT = 3000;
server.listen(PORT, () => {
  console.log(`Local API server running on http://localhost:${PORT}`);
});

安装并使用Postman测试API
- 启动本地服务器：node server.js
- 打开Postman，创建新的GET请求
- 输入请求URL：http://localhost:3000/provinces.json
- 发送请求，查看返回的省级行政区划数据

实现多级联动API 修改server.js，添加针对不同层级数据的路由处理：

// 在createServer回调函数中添加
if (req.url.startsWith('/cities/')) {
  const provinceCode = req.url.split('/')[2].replace('.json', '');
  const citiesPath = path.join(__dirname, 'dist', 'cities.json');
  fs.readFile(citiesPath, 'utf8', (err, data) => {
    if (err) {
      res.writeHead(404);
      res.end(JSON.stringify({ error: 'File not found' }));
      return;
    }
    const cities = JSON.parse(data).filter(city => city.provinceCode === provinceCode);
    res.writeHead(200, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify(cities));
  });
  return;
}