DQinYuan/chinese_province_city_area_mapper

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1796 stars · 402 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Python library (pip package 'cpca') that extracts province, city, and district names from simplified Chinese address strings and maps them to their full administrative hierarchy. It outputs results as a pandas DataFrame with adcodes and supports simple mapping/plotting.

Use cases

• extract province city and district from chinese addresses
• parse chinese address strings into structured fields
• normalize chinese addresses to administrative divisions
• map a chinese district to its city and province
• clean messy shipping addresses in python
• get adcode for chinese location names

When to choose

• you need to parse simplified Chinese addresses into province/city/district columns
• you want a lightweight pandas-based address extraction tool
• you need administrative division codes (adcode) for Chinese locations

When to avoid

• you need full geocoding to latitude/longitude coordinates
• you need to parse traditional Chinese or non-Chinese addresses
• you need high-throughput production NLP with deep learning models

Facets

library · maturity maintenance

nlp parser data-science data-science python cross-platform chinese-address-parsing administrative-divisions pandas geocoding cpca natural-language-processing china

Member repositories

For agents

markdown · JSON · MCP: product_card(name="DQinYuan/chinese_province_city_area_mapper")