algeria-geo

阿尔及利亚地理与行政数据集，涵盖69个省、538个区和1541个市镇，支持阿拉伯语/法语跨文字搜索，并提供48、58、69历史行政边界视图；同时提供Python和TypeScript库以及JSON、CSV、SQL等数据导出格式。

原始信息汇总

algeria-geo 数据集概述

基本信息

• 详情页地址：https://github.com/test-bit-sys/algeria-geo
• 数据集定位：面向阿尔及利亚的地理空间与行政数据集，零运行时依赖。
• 生态支持：TypeScript / JavaScript（ESM + CommonJS）与 Python（Typed）。
• 核心覆盖：69 个省（Wilayas）、538 个区（Dairas）、1,541 个市镇（Communes）。
• 历史边界：支持 48、58、69 三种省制边界视图。
• 代码许可：MIT License，Copyright (c) 2026 test-bit-sys。

行政覆盖

层级	数量	标识符	可用名称
Wilayas（ولاية）	69	01 – 69（ONS 2 位）	阿拉伯语、法语、ASCII 罗马化
Dairas（دائرة）	538	0101 – 6912（4 位）	阿拉伯语、法语、ASCII 罗马化
Communes（بلدية）	1,541	0101 – 6912（ONS 4 位）	阿拉伯语、法语、ASCII 罗马化

• 名称字段：name_ar、name_fr、name_en。
• name_en 为基于官方罗马化的 ASCII 安全表示。
• 所有 1,541 个 commune 均包含 5 位官方邮编 post_code 与 GPS 坐标 latitude、longitude。
• 所有 69 个 wilaya 均包含电话区号 phone_code。
• Wilaya 16（Alger）的 57 个 commune 具有特殊行政地位，在官方统计记录中保留 daira_code: null。

功能特性

• 完整官方覆盖：包含 2026 年行政改革后的 Wilayas 59–69。
• 历史边界查询：支持 48（1984）、58（2019）、69（2026）省制系统。
• 跨脚本模糊搜索：支持阿拉伯语变音符号、法语重音、字母变体与音译形式，例如 Warqla = Ouargla = ورقلة。
• 零运行时依赖：纯标准库实现，内存内 O(1) 字典查询。
• 双生态一致性：TypeScript 与 Python 具备相同功能集、函数名与性能。
• 多格式导出：PostgreSQL、SQLite、MySQL / MariaDB SQL 转储，minified JSON，层级树，UTF-8 CSV。

历史边界系统

• 1984 系统（Law 84-09）：48 Wilayas。
• 2019 系统（Law 19-12）：58 Wilayas。
• 2026 系统：69 Wilayas。
• 通过 era=48、era=58、era=69 查询历史行政边界。
• 保留完整历史沿革，例如 Aflou 在 58 省制下属于 Laghouat，在 69 省制下为独立 Wilaya。

安装

Node.js / TypeScript

• npm install algeria-geo
• pnpm add algeria-geo
• yarn add algeria-geo
• bun add algeria-geo

Python

• pip install algeria-geo
• uv add algeria-geo
• poetry add algeria-geo

API 能力

TypeScript / JavaScript

• getWilaya(id, era = 69)
• getWilayas(era = 69)
• getDaira(code)
• getDairas(wilayaCode, era = 69)
• getAllDairas(era = 69)
• getCommune(code)
• getCommunes(wilayaCode, era = 69)
• getAllCommunes(era = 69)
• getCommunesByDaira(dairaCode)
• getWilayaByCommune(code, era = 69)
• getWilayaByPhoneCode(phone)
• search(query, langOrOptions, limit)
• getPostalCode(name, wilaya)
• toDropdownOptions(lang, era)

Python

• get_wilaya(id, era=69)
• get_wilayas(era=69)
• get_daira(code)
• get_dairas(wilaya_code, era=69)
• get_all_dairas(era=69)
• get_commune(code)
• get_communes(wilaya_code, era=69)
• get_all_communes(era=69)
• get_communes_by_daira(daira_code)
• get_wilaya_by_commune(code, era=69)
• get_wilaya_by_phone_code(phone)
• search(query, lang, limit)
• get_postal_code(name, wilaya)
• to_dropdown_options(lang, era)

数据分发

文件	格式	描述
wilayas.min.json	JSON	所有 69 个 wilaya 的 minified 数组，含 daira / commune 数量
dairas.min.json	JSON	所有 538 个 daira 的 minified 数组，含历史 wilaya 代码
communes.min.json	JSON	所有 1,541 个 commune 的 minified 数组，含历史沿革
tree.min.json	JSON	Wilayas ➔ Dairas ➔ Communes 嵌套树
CSV 导出	CSV	UTF-8 with BOM，用于 Excel 和数据管道
algeria_geo.sql	SQL	PostgreSQL 与 SQLite 的 DDL 和 INSERT 语句
algeria_geo.mysql.sql	SQL	面向 MySQL 8 与 MariaDB 的优化 SQL，utf8mb4

数据来源与归属

• 行政边界与命名：转录自阿尔及利亚官方公报中的行政法令和立法文本；参考 https://github.com/djazairdev/wilayas/tree/0b3b6ab2ac1b1569469285d8fe5e7df18666fcdf。
• 邮编与坐标：来自 GeoAlgeria 项目，https://github.com/yasserstudio/geoalgeria，MIT License，Copyright (c) 2026 Yasser Studio。
• OpenStreetMap 数据：1,541 个 commune 中有 323 个坐标来自 OpenStreetMap 行政关系，采用 ODbL 1.0，© OpenStreetMap contributors。
• 特殊记录：Wilaya 16（Alger）的 57 个 commune 在官方统计记录中保留 daira_code: null。
• 完整第三方许可与署名见 NOTICE 文件。

构建与贡献

• 验证规范数据完整性：python scripts/build.py --check
• 构建分发包：python scripts/build.py
• 重新导入上游数据：python scripts/import_source.py；python scripts/build.py
• 贡献指南包含数据引用指南、本地测试说明与 PR 要求。

许可证与法律声明

• 代码与库：MIT License，Copyright (c) 2026 test-bit-sys。
• 数据编译与邮编：来自 GeoAlgeria，MIT License，Copyright (c) 2025-2026 Yassers studio，https://yasser.studio。
• OpenStreetMap 坐标：323 个 commune 中心坐标来自 OpenStreetMap 关系，采用 Open Database License (ODbL) 1.0，https://opendatacommons.org/licenses/odbl/1-0/，© OpenStreetMap contributors，不按 CC0 发布。
• 行政命名：官方行政划分与名称转录自阿尔及利亚共和国官方公报。
• 完整第三方许可与归属条款见 NOTICE 文件；MIT License 见 https://opensource.org/licenses/MIT。

搜集汇总

数据集介绍

构建方式

在行政地理数据集的编制中，权威性与沿革性构成基础要求。algeria-geo 的构建以阿尔及利亚官方公报所载行政法令和立法文本为规范来源，转录省、区、市镇名称与层级关系，并参考 djazairdev/wilayas 等开源项目进行核验。邮编与市镇中心坐标取自 GeoAlgeria，其中 323 个市镇坐标源自 OpenStreetMap 行政关系。数据经 scripts/build.py --check 验证规范完整性，再由 scripts/build.py 生成 JSON、CSV 与 SQL 分发包，import_source.py 支持上游数据再导入。该流程保留 1984 年 48 省、2019 年 58 省、2026 年 69 省三类历史边界谱系，并记录阿尔及尔等特殊行政统计状态。

使用方法

在工程集成层面，algeria-geo 提供跨语言的一致调用方式。Node.js/TypeScript 环境可通过 npm、pnpm、yarn 或 bun 安装，Python 环境可通过 pip、uv 或 poetry 引入。核心函数支持按代码或多语言名称获取省、区与市镇，亦可按电话区号定位省份，或由市镇代码反向查询所属省份，并通过 era 参数指定历史行政时代。search 函数提供跨文字模糊检索，toDropdownOptions 可生成表单下拉选项。预构建 dist 目录内含可直接导入 PostgreSQL、SQLite、MySQL/MariaDB 的 SQL 脚本，以及 JSON、CSV 与树形数据，便于数据分析与 Web 后端序列化。

背景与挑战

背景概述

地理信息科学与电子政务数据基础设施日益强调开放互操作，algeria-geo于2026年由test-bit-sys维护发布，并吸收Yasser Studio的GeoAlgeria项目及OpenStreetMap贡献者成果。该数据集聚焦阿尔及利亚行政区划与地理空间信息的权威汇编，覆盖69个省、538个区与1541个市镇，保留1984年48省、2019年58省与2026年69省三套历史边界视图。其核心研究问题在于，如何以零运行时依赖、跨阿拉伯语/法语/罗马化文字检索和TypeScript/Python双生态一致的方式，提供可追溯、可查询、可导出的行政区划数据。该工作为GIS、物流、政务、统计与Web应用开发提供统一底座，降低重复采集与语义歧义，对开放地理数据治理具有基础性影响。

当前挑战

行政区划数据的长时序维护与跨语种检索素来是地理信息科学中的难题，algeria-geo所解决的领域问题可界定为行政区划与地理空间数据的标准化、历史版本查询及多文字匹配。其构建挑战涵盖：整合官方公报、djazairdev/wilayas、GeoAlgeria与OpenStreetMap等多源异构资料，协调MIT与ODbL等许可要求；映射48、58、69三个纪元的省界、区划与市镇隶属变迁，处理阿尔及尔57个公社无daira_code等特殊统计记录；校验1541个市镇的邮编、坐标与电话区码；在零运行时依赖约束下维持TypeScript与Python API、模糊搜索、树形层级和JSON/CSV/SQL导出的一致性。这些任务共同构成数据准确性、可维护性与跨平台可用性的综合挑战。

常用场景

经典使用场景

在行政区划编码、跨语言地名检索与地理信息集成交织的应用语境中，algeria-geo 最经典的使用场景在于提供阿尔及利亚省、区、市镇三级行政单元的权威查询与反查能力。开发者可依据 ONS 代码、阿拉伯语名、法语名或拉丁化转写，快速获取省、区、市镇实体，并借助历史边界接口在 1984 年 48 省、2019 年 58 省与 2026 年 69 省体系间切换。其跨脚本模糊搜索能够统一 Warqla、Ouargla 与 ورقلة 等变体，电话区号反查、市镇归属省反查以及下拉选项生成亦构成高频操作，为地址表单、数据清洗和空间数据匹配提供即时支撑。

解决学术问题

在历史地理、行政区划变迁与空间计量研究中，行政单元边界和代码随立法调整而变动，常造成跨时期数据难以对齐、地名多语言转写不一致以及市镇归属关系断裂等问题。algeria-geo 通过保存 48、58、69 三个历史纪元的层级关系、官方代码与多语言名称，并以零依赖内存查询和模糊搜索消解阿拉伯语变音、法语重音及音译差异，为长时段行政区划比较、地理编码、空间统计与地名标准化研究提供可复现的数据基础。其意义在于降低数据整备门槛，增强跨语言检索与历史空间分析的可比性，推动北非地理信息研究基础设施开放化。

实际应用

在电子政务、物流配送、电信服务、客户关系管理与市场分析等实际业务中，行政区划数据的准确性和多语言兼容性直接影响地址校验、区域统计和资源调度。algeria-geo 以 TypeScript 与 Python 双生态、零运行时依赖及 JSON、CSV、SQL 多格式导出，便于嵌入 Web 表单、后端服务、移动应用和数据库系统。典型操作包括按电话区号定位省份、依据市镇反查所属省、生成阿拉伯语或法语下拉选项、输出 PostgreSQL/SQLite/MySQL 建表脚本，并可在历史纪元间迁移统计口径，为阿尔及利亚本地化系统提供稳定的行政地理底座。

数据集最近研究

最新研究方向

伴随阿尔及利亚行政区划从四十八省、五十八省至六十九省体系的持续演进，地理空间与行政人口数据的可追溯性成为计算社会科学、公共治理与地理信息科学交叉领域的前沿议题。algeria-geo 以全量六十九省、五百三十八区、一千五百四十一市镇及历史边界版本，支撑多时相统计口径对齐、选举地理与公共服务配置评估；其跨阿拉伯语、法语及拉丁转写模糊检索，推动多语言地名消歧与数字包容。围绕二〇一九年与二〇二六年省制改革，该数据集成官方公报、GeoAlgeria 与 OpenStreetMap 融合的可复现数据集，正被用于行政重组影响评估、开放政府数据嵌入及人道主义地理分析，为北非区域治理研究提供轻量、透明且多格式可移植的基础设施。