dz-admin

dz-admin 是一个现代、全面且强类型的阿尔及利亚行政区划数据集和API，更新至2026/2027年以反映Loi 26-06法律。该数据集包含所有69个Wilayas（省）及其下属的Daïras（区）和Communes（市镇）的权威数据，支持多语言（阿拉伯语、法语、英语），提供JSON、CSV、SQL、XML和YAML等多种格式导出，并包含地理坐标、邮政编码、人口数据等丰富元数据。dz-admin is a modern, comprehensive and strongly-typed Algerian administrative divisions dataset and API, updated to the 2026/2027 edition to comply with Law No. 26-06. This dataset provides authoritative data covering all 69 Wilayas (provinces), their subordinate Daïras (districts) and Communes (municipalities). It supports multilingual access in Arabic, French and English, offers exports in multiple formats including JSON, CSV, SQL, XML and YAML, and includes rich metadata such as geographic coordinates, postal codes and population statistics.

原始信息汇总

数据集概述：dz-admin 🇩🇿

dz-admin 是一个现代、全面且强类型的阿尔及利亚行政区划数据集与API，依据 Loi 26-06 更新，包含全部 69 个省（Wilayas）、县（Daïras）和市镇（Communes）的权威数据。

🌟 主要特征

• 数据时效（2026/2027）：完整支持全部 69 个省，包括新成立的省份（第 59–69 号）。
• 多语言支持：每个行政区划均提供 阿拉伯语（ar）、法语（fr） 和 英语（en） 的本地化名称。
• 多格式导出：数据集已预先生成为 JSON、CSV、SQL、XML、YAML 五种格式。
• 强类型验证：使用 Pydantic 构建 Python 模式，确保数据验证的稳健性。
• 丰富元数据：包含 ISO 3166-2 代码、邮政编码、地理坐标（经纬度）、面积（km²）、人口数据和区域分类。
• TypeScript SDK：在 packages/typescript 目录下提供专用 SDK，便于前端/Node.js 集成。

📁 仓库结构

• datasets/raw/：原始权威数据（wilayas.json, dairas.json, communes.json）
• datasets/processed/：生成的生产就绪数据，按格式分目录存储
  • json/、csv/、sql/、xml/、yaml/
• schemas/：Pydantic 模式模型（wilaya_schema.py, daira_schema.py, commune_schema.py）
• scripts/：Python 自动化与导出脚本
  • export_wilayas.py、validate_wilayas.py、generate_raw_data.py
• packages/：多种语言的 SDK（如 TypeScript）
• apps/：相关 API 与演示应用
• tests/：测试套件

🚀 数据集使用方式

直接使用 datasets/processed/ 中的文件：

• Web 开发者：使用 datasets/processed/json/wilayas.json
• 数据库管理员：运行 datasets/processed/sql/wilayas.sql 快速导入数据库
• 数据科学家：导入 datasets/processed/csv/wilayas.csv

🛠️ 代码库使用

1. 依赖：需 Python 3.10+，安装 pydantic 和 pyyaml。
2. 数据管道：
   • 修改原始数据后，使用 python scripts/validate_wilayas.py 验证（可加 --report 标志输出详细 JSON 报告）。
   • 验证通过后，使用 python scripts/export_wilayas.py 重新生成 datasets/processed/ 中的多格式文件。

🏗️ Pydantic 模式示例（Wilaya）

python algiers = Wilaya( id=16, code="16", iso_code="DZ-16", name={"ar": "الجزائر", "fr": "Alger", "en": "Algiers"}, slug="algiers", region="North-Center", capital=True, capital_city="Algiers", postal_code="16000", coordinates={"lat": 36.7538, "lng": 3.0588}, data_status="complete" )

• id 取值范围 1–69，iso_code 严格匹配 DZ-XX 标准，且仅有一个省级单位被标记为国家首都。

📜 许可证

本项目采用 开放数据共享署名许可（ODC-By）。

搜集汇总

数据集介绍

构建方式

dz-admin数据集以阿尔及利亚《26-06号法律》为权威依据，重新界定了全国69个省份、下辖的Daïras与Communes三级行政体系。原始数据收集于datasets/raw/目录，统一采用JSON格式存储，涵盖地理坐标、邮政编码、人口统计、区域归属等丰富元信息。借助Pydantic模型对每一项字段进行严格的类型约束（如省份编号限定1-69、ISO代码匹配DZ-XX标准），随后通过自动化Python脚本进行验证与多格式导出，最终在datasets/processed/下生成JSON、CSV、SQL、XML、YAML等直用文件，确保数据链条可靠且重复可用。

使用方法

若仅需直接使用数据，可从datasets/processed/目录选择对应格式：Web开发者可引用json/wilayas.json即刻渲染前端界面；数据库管理员可执行sql/wilayas.sql快速填充数据表；数据科学家则可将csv/wilayas.csv导入分析工具。若需定制或扩展，首先配置Python 3.10+环境并安装pydantic与pyyaml，再修改datasets/raw/中的源文件后运行validate_wilayas.py进行合法性检验（支持--report参数输出详细报告），确认无误后执行export_wilayas.py重新生成所有加工格式，实现从原始数据到生产数据的一键编译。

背景与挑战

背景概述

dz-admin数据集诞生于阿尔及利亚行政区划体系经历重大变革的背景下，其创建时间与阿尔及利亚2026年通过的《第26-06号法律》紧密相关，旨在反映该国最新行政划分。该数据集由一支专注于数据标准化与开放数据的团队开发，核心研究问题是解决阿尔及利亚69个省（Wilayas）及其下属的区和市镇数据的数字化、标准化与多语言支持问题。作为阿尔及利亚行政区划数据的权威来源，dz-admin提供了阿拉伯语、法语和英语三种语言的名称，并包含ISO 3166-2代码、邮政编码、地理坐标、面积、人口等丰富元数据，对区域研究、公共管理、地理信息系统（GIS）开发以及面向阿尔及利亚用户的应用程序构建产生了深远影响，成为该领域不可或缺的基础数据资产。

当前挑战

该数据集面临的核心挑战在于解决行政区划数据长期存在的碎片化、不一致和更新滞后问题。在领域层面，阿尔及利亚行政区划数据过去分散于不同政府机构，缺乏统一格式和标准化编码，导致跨系统数据整合困难，例如不同部门或应用使用不同的命名规则和代码体系。在构建过程中，团队需要应对从多源异构数据中提炼权威信息的难题，确保69个省份、超过1000个市镇的数据在层级关系、地理边界和属性信息（如人口、面积）上完全准确。此外，数据多语言化（阿拉伯语、法语、英语）要求严格避免翻译歧义和命名冲突，而数据格式的多样化导出（JSON、CSV、SQL、XML、YAML）则需要建立高度自动化的数据管道和严格的校验机制（如Pydantic模式验证），以保障数据质量与一致性。

常用场景

经典使用场景

在阿尔及利亚行政区划研究与地理信息系统中，dz-admin数据集被广泛用作基准行政单元数据源。研究人员可便捷地获取包含全部69个维拉亚（Wilaya）、代拉（Daïra）和市镇（Commune）的层级化地理实体信息。该数据集提供了阿拉伯语、法语和英语的多语言名称映射，以及ISO 3166-2编码、邮政编码、地理坐标、面积和人口等元数据，为构建区域性政务服务平台、人口地理分析模型或交通规划系统提供了标准化的数据基底。其Pydantic强类型模型确保了数据结构的严谨性，可直接嵌入Python后端进行高效数据校验与业务逻辑开发。

解决学术问题

该数据集解决了阿尔及利亚行政区划研究中长期存在的数据碎片化与更新滞后问题。根据2026年Loi 26-06法案，新增了59至69号维拉亚，但公开可用的结构化数据极其匮乏。dz-admin整合了权威官方数据，覆盖全部行政层级，并以多种可机读格式（JSON、CSV、SQL、XML、YAML）发布，显著降低了学者获取高质量数据的门槛。它为行政区划变迁分析、人口空间分布建模、区域经济差异研究提供了统一、可复现的数据基础，推动了北非地区治理研究的定量化与标准化进程。

实际应用

在实际应用中，dz-admin可直接服务于阿尔及利亚的电子政务系统建设、物流配送网络优化及应急管理平台开发。例如，前端开发者可快速加载JSON文件实现省市区三级联动的地址选择器；数据库管理员可利用SQL脚本一键初始化包含完整行政信息的生产数据库；数据科学家则能基于CSV文件结合人口与坐标数据开展公共设施可达性分析。此外，该数据集内置的TypeScript SDK使得Node.js和前端项目能够无缝集成行政区划数据，大幅提升了开发效率。

数据集最近研究

最新研究方向

随着阿尔及利亚行政区划改革（Loi 26-06）的正式实施，省级单位由58个增至69个，dz-admin数据集精准捕捉了这一重大治理结构调整的权威数据。该数据集通过多格式导出与强类型Schema设计，为地理信息系统、行政数据分析及公共服务应用提供了从历史版本向新政区划平稳过渡的技术支撑。在智慧政务与区域规划领域，研究人员利用其提供的经纬度坐标、邮政编码与人口统计元数据，结合Pydantic与TypeScript SDK，正加速构建新一代阿尔及利亚行政区划数据可视化平台与标准化API服务。dz-admin不仅解决了新政区划数据分散、格式不统一的痛点，更以开放数据许可推动北非地区治理研究的基础设施化，成为连接政策落地与数字应用的桥梁。