git404hub

what is provincejson fr?

getactivity/provincejson — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2026-04-30

250Audience · developerComplexity · 1/5MaintainedSetup · easy

tl;dr

A ready-to-use JSON file listing every province, city, and district in China, updated with recent administrative changes so your app's location data stays accurate.

vibe map

mindmap
  root((repo))
    What it does
      Complete China area list
      Tracks boundary changes
      Includes HK Macau Taiwan
    Data format
      JSON format
      Three-tier hierarchy
      Custom sorting by GDP
    Use cases
      E-commerce checkout
      Food delivery apps
      User registration forms
    Maintained by
      Community contributions
      Based on earlier dataset
      Report errors encouraged

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Build a location picker dropdown for a Chinese e-commerce checkout page.

VIBE 2

Create a registration form that asks users for their province, city, and district.

VIBE 3

Populate a food delivery app with accurate Chinese delivery zones.

VIBE 4

Verify and update your existing China location data against recent administrative changes.

what's the stack?

JSON

how it stacks up fr

getactivity/provincejsondirenv/direnv-vscodeyangtiming/fast-sam-3d-body
Stars250250250
LanguageTypeScriptPython
Last pushed2026-04-302024-12-04
MaintenanceMaintainedStale
Setup difficultyeasymoderatehard
Complexity1/52/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Just download or copy the JSON file into your project and load it, no dependencies or configuration required.

The license is not specified in the repository description, so check the repository files for specific terms before using it in your project.

in plain english

ProvinceJson is a data file that gives you a complete, up-to-date list of every province, city, and district in China. If you are building an app or website where users need to select their location, this ready-made dataset saves you from having to research and compile all of that administrative geography yourself. The project provides this information in JSON format, which is a structured way of organizing data that apps and websites can easily read. It covers China's three-tier administrative system: provinces at the top, cities in the middle, and districts or counties at the bottom. The maintainer has also applied a specific ordering, direct-administered municipalities like Beijing and Shanghai are listed first, provinces are ranked by GDP, and autonomous regions are placed toward the end. What makes this dataset valuable is the sheer amount of corrections and updates the maintainer has applied. China's administrative divisions change frequently through government decrees, counties become districts, cities are merged, and new areas are created. The project tracks dozens of these changes, including recent ones from 2020 and 2021 where counties were upgraded to cities or merged into districts across provinces like Jiangsu, Shandong, Guangdong, and Xinjiang. It also fills in gaps that similar datasets often miss, such as the sub-regions of Hong Kong, Macau, and Taiwan, plus special cases like island territories in Sansha. This is useful for any developer building a location picker for a Chinese audience, think of an e-commerce checkout page, a food delivery app, or a registration form that asks for a shipping address. It is essentially a curated reference file that keeps pace with how China's official boundaries evolve, so your app's location data does not go stale. The project is built on an earlier open-source dataset and refined through community contributions, with the maintainer actively encouraging users to verify their own hometown entries and report any errors.

prompts (copy fr)

prompt 1
Write a React component that creates a cascading dropdown for province, city, and district selection using the ProvinceJson data structure from getactivity/provincejson.
prompt 2
Create a Node.js script that loads the ProvinceJson file and lets a user search for any Chinese city or district by name to find its parent province.
prompt 3
Build an HTML form with three linked select inputs for Chinese locations, populating the city options based on the chosen province and district options based on the chosen city.
prompt 4
Using the ProvinceJson dataset, write a Python script to find all districts that were added or renamed in 2020 and 2021.

Frequently asked questions

what is provincejson fr?

A ready-to-use JSON file listing every province, city, and district in China, updated with recent administrative changes so your app's location data stays accurate.

Is provincejson actively maintained?

Maintained — commit in last 6 months (last push 2026-04-30).

What license does provincejson use?

The license is not specified in the repository description, so check the repository files for specific terms before using it in your project.

How hard is provincejson to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is provincejson for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.