Dataset Wilayah Administratif Indonesia

印度尼西亚行政区域数据集，包含省、县/市、区和村/社区四级行政单位的数据，数据来源于印度尼西亚内政部。数据集包含四个CSV文件：provinces.csv（34条记录）、regencies.csv（514条记录）、districts.csv（7,215条记录）和villages.csv（80,534条记录），总计88,297条记录。数据字段包括ID、上级区域ID和名称，采用逗号分隔且无表头格式。Indonesian Administrative Region Dataset covers data of four levels of administrative units: provinces, regencies/cities, districts, and villages/communities. The data is sourced from the Indonesian Ministry of Home Affairs. The dataset consists of four CSV files: provinces.csv (34 records), regencies.csv (514 records), districts.csv (7,215 records) and villages.csv (80,534 records), with a total of 88,297 records. The data fields include ID, parent region ID and name, adopting a comma-separated format without headers.

原始信息汇总

数据集概览

• 名称: Dataset Wilayah Administratif Indonesia（印度尼西亚行政区划数据集）
• 来源: 数据来自印度尼西亚内政部（Kemendagri），并基于 emsifa/api-wilayah-indonesia 项目衍生。
• 许可协议: MIT 许可。

数据集内容

该数据集包含印度尼西亚四级行政区划数据，以 CSV 格式提供，分隔符为逗号（,），不含表头。

文件	记录数	大小	字段
provinces.csv	34	551 B	id, name
regencies.csv	514	14 KB	id, province_id, name
districts.csv	7,215	166 KB	id, regency_id, name
villages.csv	80,534	2.3 MB	id, district_id, name

总计记录数: 88,297 条。

数据层级关系

数据通过 ID 字段关联，形成以下层级结构：

province.id ──< regencies.province_id regency.id ──< districts.regency_id district.id ──< villages.district_id

• 省 (Province): 包含 ID 和名称。
• 市/县 (Regency): 包含 ID、所属省 ID 和名称。
• 区 (District): 包含 ID、所属市/县 ID 和名称。
• 村/社区 (Village): 包含 ID、所属区 ID 和名称。

数据示例

provinces.csv 示例：

11,ACEH 12,SUMATERA UTARA

regencies.csv 示例：

1101,11,KABUPATEN SIMEULUE 1102,11,KABUPATEN ACEH SINGKIL

districts.csv 示例：

1101010,1101,SIMEULUE TIMUR 1101020,1101,TEUPAH SELATAN

villages.csv 示例：

1101012001,1101010,AIR DINGIN 1101012002,1101010,AMAITENG MULYA

API 访问

可通过 api-datasets-indonesia 提供的 REST API 访问数据。

• Base URL: https://api.ibnuhabib.web.id
• API 端点示例:
  • 获取所有省: GET /api/wilayah/provinces
  • 获取某省下的市/县: GET /api/wilayah/regencies/{province_id}
  • 获取某市/县下的区: GET /api/wilayah/districts/{regency_id}
  • 获取某区下的村/社区: GET /api/wilayah/villages/{district_id}
• CSV 文件下载:
  • https://api.ibnuhabib.web.id/download/wilayah/provinces.csv
  • https://api.ibnuhabib.web.id/download/wilayah/regencies.csv
  • https://api.ibnuhabib.web.id/download/wilayah/districts.csv
  • https://api.ibnuhabib.web.id/download/wilayah/villages.csv

相关数据集

该数据集是系列数据集的一部分，还包括：

• dataset-sekolah-indonesia（印度尼西亚学校数据集）
• dataset-perguruan-tinggi-indonesia（印度尼西亚高校数据集）
• dataset-program-studi-indonesia（印度尼西亚专业/研究方向数据集）
• dataset-kbbi-indonesia（印度尼西亚大词典数据集）

搜集汇总

数据集介绍

构建方式

印度尼西亚行政区划数据集的构建基于印度尼西亚内政部（Kemendagri）发布的官方数据，通过系统化整理与层级化关联，形成涵盖省、市/县、区、村/街道四个行政级别的结构化数据集。数据以CSV格式存储，各文件通过层级ID字段建立关联：省ID连接市/县，市/县ID连接区，区ID连接村/街道，从而完整复现印度尼西亚的行政区划体系。

特点

该数据集具备严谨的层级结构与完整性，收录了34个省、514个市/县、7,215个区以及80,534个村/街道，总计88,297条记录。数据集遵循MIT开源协议，提供无表头CSV文件，兼容性强，便于直接加载与分析。此外，配套的REST API接口支持动态查询与批量下载，显著提升了数据获取的灵活性与效率。

使用方法

用户可通过两种方式使用该数据集：其一，直接下载CSV文件，利用层级ID字段在本地进行多表关联分析，适用于静态数据场景；其二，通过REST API接口进行实时查询，如使用cURL命令获取指定省份下的市/县、区或村/街道信息，适合需要动态数据更新的应用。API的Base URL为https://api.ibnuhabib.web.id，支持CSV格式的直接下载。

背景与挑战

背景概述

Dataset Wilayah Administratif Indonesia 是一个专注于印度尼西亚行政区域划分的数据集，由开发者 ibnuhabib 及其团队创建，旨在提供从省级到村级（provinsi, kabupaten/kota, kecamatan, desa/kelurahan）的完整地理层级信息。该数据集基于印度尼西亚内政部（Kemendagri）的官方数据，经过整理后以 CSV 格式开源发布，并配套提供 REST API 接口，便于开发者高效获取数据。数据集创建于近年来，其核心研究问题在于解决印尼行政划分数据分散、格式不统一、难以实时查询的痛点。通过清晰定义 province、regency、district 和 village 之间的层级关系，该数据集为地理信息系统、人口统计、公共服务规划等领域提供了坚实的数据基础。目前，该数据集在印尼本地开发者社区中具有广泛影响力，被广泛应用于政府服务应用、地图可视化及学术研究中，成为行政数据标准化的典范。

当前挑战

当前数据集面临的主要挑战源自所解决的领域问题：印尼行政区域频繁调整（如省份拆分、县市合并、村庄重命名）导致数据易过时，而数据集依赖内政部静态快照，难以实现与官方同步的实时更新，影响其在动态应用中的准确性。此外，构建过程中遭遇的挑战包括：原始数据格式不一致（如有无表头、分隔符差异）、层级关系验证复杂（需处理历史遗留的 ID 编码冲突），以及从多个来源聚合时出现的数据冗余与遗漏。数据缺失（如部分村庄的编码信息不完整）和 API 在高并发下的响应延迟，也是制约其大规模部署的关键瓶颈。克服这些挑战需建立自动化数据清洗流水线、引入版本控制机制，并与官方部门建立长效协同更新协议。

常用场景

经典使用场景

Dataset Wilayah Administratif Indonesia 是一个承载着印度尼西亚行政区划层级信息的结构化数据集，涵盖从省级（provinsi）到村级（desa/kelurahan）的完整四层行政单元。其经典使用场景在于构建标准化的地理编码查找表，为研究人员提供一个可靠的基础行政区域参照系。无论是开发地图可视化应用、进行空间统计分析，还是整合多源地理数据，这套数据集都以精准的层级关系——province.id 对应 regencies.province_id，直至 village.district_id——确保了数据间的有机衔接，从而支撑起对印尼国土治理结构的系统化认知。

解决学术问题

在学术研究层面，该数据集有效解决了印度尼西亚行政边界数据碎片化与不一致性的长期难题。以往学者在处理涉及印尼的宏观人口变迁、流行病学追踪、或区域经济发展分析时，常受困于来源不一、格式各异且维护滞后的行政区划数据。此数据集通过系统收录超过八万八千条记录，并提供清晰的层级映射关系，为跨学科研究奠定了一致的空间数据基础。它显著提升了生态学、公共卫生及社会科学领域中，针对印尼地理单元特征展开量化分析的可靠性与可重复性，减少了因底层数据缺位而导致的结论偏差。

衍生相关工作

围绕 Dataset Wilayah Administratif Indonesia 已衍生出一系列重要的相关研究工作与工具，其中最典型的是配套构建的 REST API 服务——api-datasets-indonesia，它使得开发者能够通过简洁的 HTTP 请求实时获取行政层级数据，极大便利了系统集成。此外，该数据集还与印度尼西亚学校、高等教育机构及研究项目等专题数据集形成生态联动，例如 dataset-sekolah-indonesia 和 dataset-perguruan-tinggi-indonesia，共同支撑起连接基础教育与高等教育的空间数据分析网络，推动了印尼本土数字化资源建设与数据科学方法在地理信息领域的深度融合。