MCPcopy
hub / github.com/uiwjs/province-city-china

github.com/uiwjs/province-city-china @v8.5.8 sqlite

repository ↗ · DeepWiki ↗ · release v8.5.8 ↗
3 symbols 6 edges 30 files 1 documented · 33%
README

中华人民共和国行政区划代码

Github Issues Github Forks Github Stars Github Release no dependencies npm package

中华人民共和国行政区划(五级):省级、地级、县级、乡级和村级。来自中华人民共和国民政部,用于查询中国省,市和区数据的网站。

数据更新时间:2021/03/22 15:39:04 GMT+0800 (中国标准时间)

数据更新 Diff

安装

npm install province-city-china --save-dev
包名 说明 版本 大小
province-city-china 包含所有包内容 npm package -
@province-city-china/country 国家和地区代码列表 npm package
@province-city-china/data 总数据(省/地/县/乡) npm package
@province-city-china/province 省级(省/直辖市/特别行政区) npm package
@province-city-china/city 地级(城市) npm package
@province-city-china/area 县级(区县) npm package
@province-city-china/town 乡级(乡镇/街) npm package
@province-city-china/level 总数据(省/地/县/乡)层级数据 npm package
@province-city-china/utils 提供使用数据方法 npm package
@province-city-china/types 类型文件 npm package -
@province-city-china/district-code 国内长途电话区号 npm package -

使用

const { data, province, city, area, town } = require('province-city-china/data');
  • data - 总数据(省/地/县/乡)
  • province - 省级(省/直辖市/特别行政区)
  • city - 地级(城市)
  • area - 县级(区县)
  • town - 乡级(乡镇/街)

所有数据

const provinces = require('province-city-china/dist/data.json');
// provinces 输出 ===>
[
  {"code":"110000","name":"北京市","province":"11","city":0,"area":0,"town":0},
  {"code":"110101","name":"东城区","province":"11","city":"01","area":"01","town":0},
  {"code":"110102","name":"西城区","province":"11","city":"01","area":"02","town":0},
  {"code":"110105","name":"朝阳区","province":"11","city":"01","area":"05","town":0},
  ....
]

规则:

  • province - 省级(省/直辖市/特别行政区) - city=0, area=0, town=0
  • city - 地级(城市) - area=0, town=0
  • area - 县级(区县) - town=0 其它不为 0
  • town - 乡级(乡镇/街) - 所有值不为 0

province 第一位表示:华北区1,东北区2,华东区3,中南区4,西南区5,西北区6。 如 湖北省 -> 424 开头,表示为 中南区

获取城市数据

const city = require('province-city-china/dist/city.json');
// city 输出 ===>
[
  {"code":"01","name":"石家庄市","province":"13"},
  {"code":"02","name":"唐山市","province":"13"},
  {"code":"03","name":"秦皇岛市","province":"13"},
  {"code":"04","name":"邯郸市","province":"13"},
  {"code":"05","name":"邢台市","province":"13"},
  ....
]

说明:

  • code - 城市代码
  • name - 城市名称
  • province - 省/直辖市/特别行政区代码

更多数据

可以通过 UNPKG 下载使用 CDN 资源: https://unpkg.com/province-city-china/dist/

文件列表 JSON CSV SQL CDN
国家和地区代码列表(#13) country.json (min) country.csv - csv / json
总数据(省/地/县/乡) data.json (min) data.csv data.sql data.sql / csv / json
总数据(省/地/县/乡)层级数据 level.json (min) - - level.json
省级(省/直辖市/特别行政区) province.json (min) province.csv - province.json / csv
地级(城市) city.json (min) city.csv - city.json / csv
县级(区县) area.json (min) area.csv - area.json / csv
乡级(乡镇/街) town.json (min) town.csv - town.json / csv
县市区没有乡级数据 not-found-town.json (min) - - not-found-town.json
香港澳门<区>数据 hongkong.json

macau.json | hongkong.csv / macau.csv | - | hongkong.json (csv)

macau.json (csv) | | 国内长途电话区号 | district-code.json | district-code.csv | - | district-code.json / csv |

更多 CDN 数据访问

  • https://unpkg.com/province-city-china/dist/city.json
  • https://raw.githack.com/uiwjs/province-city-china/gh-pages/city.json
  • https://cdn.statically.io/gh/uiwjs/province-city-china/gh-pages/city.json
✅ > <省>数据:34
  ✔ 数据保存: data/province.json
  ✔ 数据保存: data/province.csv
  ✔ 数据保存: data/province.min.json
✅ > <市>数据:337
  ✔ 数据保存: data/city.json
  ✔ 数据保存: data/city.csv
  ✔ 数据保存: data/city.min.json
✅ > <区>数据:2846
  ✔ 数据保存: data/area.json
  ✔ 数据保存: data/area.csv
  ✔ 数据保存: data/area.min.json
✅ > <省><市><区>总数据:3217
  ✔ 数据保存: data/data.json
  ✔ 数据保存: data/data.min.json
  ✔ 数据保存: data/data.csv
✅ > <省市区>层级数据:
  ✔ 数据保存: data/level.json
  ✔ 数据保存: data/level.min.json

国家和地区代码列表

country.json | country.min.json | country.csv

id=序号cnname=中文简称name=英文简称fullname=英文全称alpha2=两字母代码alpha3=三字母代码numeric=数字代码

[
  {
    "id": 1,
    "cnname": "阿富汗",
    "name": "Afghanistan",
    "fullname": "the Islamic Republic of Afghanistan",
    "alpha2": "AF",
    "alpha3": "AFG",
    "town": 4
  },
  {
    "id": 45,
    "cnname": "中国",
    "name": "China",
    "fullname": "the People's Republic of China",
    "alpha2": "CN",
    "alpha3": "CHN",
    "town": 156
  }
  // ...
]

压缩数据说明 country.min.json

id: 'i'
cnname: 'c'
name: 'n'
fullname: 'f'
alpha2: 'a2'
alpha3: 'a3'
numeric: 'r'

总数据(省/地/县/乡)

data.json | data.min.json | data.csv | data.sql

包含香港澳门<区>数据

[
  {
    "code": "110000",
    "name": "北京市",
    "province": "11",
    "city": 0,
    "area": 0,
    "town": 0
  },
  // ...
]

压缩数据说明 [data.min.json](https://github.com/uiwjs/provin

Core symbols most depended-on inside this repo

copyToDir
called by 23
packages/core/script/copy.js
outPutSQL
called by 1
packages/core/script/sql.js
loop
called by 1
packages/core/script/check.js

Shape

Function 3

Languages

TypeScript100%

Modules by API surface

packages/core/script/sql.js1 symbols
packages/core/script/copy.js1 symbols
packages/core/script/check.js1 symbols

Dependencies from manifests, versioned

@province-city-china/types8.5.8 · 1×
cheerio1.0.0-rc.10 · 1×
csvtojson2.0.10 · 1×
fs-extra10.0.1 · 1×
lerna5.6.2 · 1×
superagent7.1.1 · 1×
superagent-charset1.2.0 · 1×

For agents

$ claude mcp add province-city-china \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact