finds.dev

modood/Administrative-divisions-of-China

中华人民共和国行政区划:省级(省份)、 地级(城市)、 县级(区县)、 乡级(乡镇街道)、 村级(村委会居委会) ,中国省市区镇村二级三级四级五级联动地址数据。

View on GitHub

★ 20,986JavaScriptWTFPLupdated Dec 2025

// the take

A static dataset of China's five-level administrative divisions (province/city/county/township/village) distributed as JSON, CSV, and a SQLite file, plus pre-built cascading JSON (province→city, →county, →township) for address pickers. It's for anyone building a China address selector or needing offline admin-code lookups, not a library or API.

Covers all five levels down to village/community committee, which most similar datasets stop short of. Ships ready-made cascading combinations (pc, pca, pcas) so you don't have to join the levels yourself. Multiple formats (JSON/CSV/SQLite) cover both frontend dropdowns and backend import. WTFPL license means zero friction on reuse.

Data is frozen at 2023 codes and explicitly will not be updated — China's National Bureau of Statistics stopped publishing these codes publicly after October 2024, so this is the last version that will ever exist from official sources. No five-level (village) cascading file is provided, only up to four levels, so you still have to build that join yourself. It's a data dump with no update/diff tooling, no versioning of historical code changes, and no handling for when a region is merged, renamed, or recoded — all of which happens periodically in China. Recent pushes are cosmetic, not data refreshes, so don't mistake activity for currency.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
20,986
Forks
7,191
Language
JavaScript
License
WTFPL
Last commit
27 Dec 2025

// nearby

If Administrative-divisions-of-China isn't quite it.

All repos →