{"_id":"@aurouscia/china-areas","_rev":"8-589489601616f3180dc33360c38faf25","name":"@aurouscia/china-areas","dist-tags":{"latest":"0.7.0"},"versions":{"0.0.0":{"name":"@aurouscia/china-areas","version":"0.0.0","author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.0.0","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"6a301ead9641912fe73c1e8f22c3d00096eb6e7b","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.0.0.tgz","fileCount":4,"integrity":"sha512-Pp2VKV3eEklTBmtVX+4f8iMSs8qd4VHenJAE4UCOf6zc4Z2Szyuc7XEzLX5wSYtiwek5L9/H8Av9oYOnGilOgw==","signatures":[{"sig":"MEYCIQCwMNHsTYmRh4l2VEuzc7VIj5FeLS2OlbZEdYt6OaTFmAIhAJJZWa1ywUAZqTdtum2rfgzq4SSGUxjuEaNi8vOTcSN+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":142449},"type":"module","types":"./dist/index.d.ts","exports":{".":"./dist/index.js"},"gitHead":"08431de6a238b3ec1da147b1bc383c8badad2ab1","scripts":{"gen":"node generator/generator.js","build":"tsc","prepack":"npm run build"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据 精确到区县","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.0.0_1746896093248_0.8607394597965758","host":"s3://npm-registry-packages-npm-production"}},"0.0.1":{"name":"@aurouscia/china-areas","version":"0.0.1","author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.0.1","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"f07d5ed4cf2cd99a9a9569c1d872ab4b2f63bc64","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.0.1.tgz","fileCount":4,"integrity":"sha512-P2Ku2njl/raQfouZcjHhRC7CisGkEFHKflqyMeVLrYX9A+JKytz47pNLtqs9YVBggHG2cdI06T1y7Fosx5SHEw==","signatures":[{"sig":"MEQCIGrJ4Ubomk0S8Y24WE9bDGoRNyCxWMSdiul7PgYfJAvjAiAg3O7zAfRNxn8gqMHPODJy6w5eZAX6wyIQPMnrGDU94A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":142533},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"5669e2ae403d8172c21be2d4f4a194306b31378a","scripts":{"gen":"node generator/generator.js","build":"tsc","prepack":"npm run build"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据 精确到区县","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.0.1_1746898644802_0.20185180531149327","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aurouscia/china-areas","version":"0.1.1","author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.1.1","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"291d32d1edeecadad5c9373a29f1a792dccbb541","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.1.1.tgz","fileCount":4,"integrity":"sha512-6e8P4Nnh3lntrOl2fmrglM5ah62qSG/nN59OTQRrkIshG4goYQAMRqiBZ7nIDIWPwooLyiAKnL3sWHiiKjhLaQ==","signatures":[{"sig":"MEUCIQCNjmeMeumPyjWkmMvJGCF0o1xOdT9wPFIe3kzt+D+/KgIgcAaKb/QVysxpfF8MqlrIjjXt/xLlFitSILMHqMCIPMI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138653},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"078137ddabbf257412b1b9401b8ca38e341fd016","scripts":{"gen":"node generator/generator.js","build":"npm run gen && vite build","prepack":"npm run build"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据(精确到区县)及工具函数","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"vite":"^6.3.5","typescript":"^5.8.3","vite-plugin-dts":"^4.5.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.1.1_1746951318929_0.07531839480235969","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aurouscia/china-areas","version":"0.2.0","author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.2.0","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"570b66c939d70ffbeab6ba398819d1341b8e40c8","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.2.0.tgz","fileCount":6,"integrity":"sha512-S++wiTfKBk/oVLExnlbeIoXG7T37b8qblCpC4xUYGhUkDwub/fiSkDA83o8ZIt8bWebTFKj2snlNnyQqVNC3OQ==","signatures":[{"sig":"MEUCIQDAJurZzyeLzf/z+8piw6Bv1N/Oq8QhQXfJ/TcrCdNZnQIgS8tDsOud52wZ0fr3eHtyi/yLE92Y3g/MHWnl9aGKHmQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":606968},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"0a056ccb9c209aa38a252cc8f132880415164280","scripts":{"build":"npm run genTs && npm run genJson && vite build && npm run copyGenRes","genTs":"tsx generator/genTs/gen.ts","genJson":"tsx generator/genJson/gen.ts","prepack":"npm run build","copyGenRes":"tsx utils/build/copyGenRes.ts"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据(精确到区县)及工具函数","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","vite":"^6.3.5","typescript":"^5.8.3","vite-plugin-dts":"^4.5.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.2.0_1747133652916_0.8147955862317464","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@aurouscia/china-areas","version":"0.4.0","keywords":["china","cn","areas","area","data","province","city","district","division","json","typescript"],"author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.4.0","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"3d72020f58314c4e79bd9e5ab53b6cbc9553bfde","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.4.0.tgz","fileCount":8,"integrity":"sha512-9OmBlbr1FbHSeO2wc2S7192M54dWmeJDxCPZY3JA1Vp0rt+yN37IUEmHellGbZQqAJ1YEUPuyZRwJQvLjfSNnQ==","signatures":[{"sig":"MEUCIQDi+/QEbaWR+I6ox1e9qD+U7bvm8tTeB3ikmR5EfToaoAIgdwUwsgGdwsPC435r37MIy6SM0azNEJYPVvkLSyivKec=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":816711},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"09d9f3ab1df03d014e8b214b0ef42044073edc85","scripts":{"test":"vitest","build":"tsx build.ts","genTs":"tsx generator/genTs/gen.ts","genJson":"tsx generator/genJson/gen.ts","prepack":"npm run build","copyGenRes":"tsx utils/build/copyGenRes.ts","test-watch":"vitest --watch"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据(精确到区县)及工具函数","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","vite":"^6.3.5","execa":"^9.5.3","vitest":"^3.1.3","typescript":"^5.8.3","vite-plugin-dts":"^4.5.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.4.0_1747153740440_0.7308101092515427","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@aurouscia/china-areas","version":"0.5.0","keywords":["china","cn","areas","area","data","province","city","district","division","json","typescript"],"author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.5.0","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"75fe5807a11350e01a78aef966ce47a140267475","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.5.0.tgz","fileCount":8,"integrity":"sha512-bjzDVylnLo9wj+SuM/3teeA2lOkmZ0v84L05kJGXxu7HDcPnSKSJrj02d9WOxcgSEszYkUA8I+hA2bDLg9GKKQ==","signatures":[{"sig":"MEUCIED0IPNbWU/uJ1ax31ItQnWew7OsIaG7WTVHoG1gG+OlAiEA650rgkFvnB2kcbsXmqipOd25PmAdKwzZjhE+VpgOZT8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":817531},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"2094a24bd1ad3945918d4cb4eb04976d1aca015d","scripts":{"test":"vitest","build":"tsx build.ts","genTs":"tsx generator/genTs/gen.ts","genJson":"tsx generator/genJson/gen.ts","prepack":"npm run build","copyGenRes":"tsx utils/build/copyGenRes.ts","test-watch":"vitest --watch"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据(精确到区县)及工具函数","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","vite":"^6.3.5","execa":"^9.5.3","vitest":"^3.1.3","typescript":"^5.8.3","vite-plugin-dts":"^4.5.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.5.0_1747155376164_0.801753503451486","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@aurouscia/china-areas","version":"0.6.0","keywords":["china","cn","areas","area","data","province","city","district","division","json","typescript"],"author":{"name":"Au"},"license":"MIT","_id":"@aurouscia/china-areas@0.6.0","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"dist":{"shasum":"ff8ac0b6382efb20cd924e8894b04a0f2dd19b90","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.6.0.tgz","fileCount":9,"integrity":"sha512-RKioNuyYs5Rb6MOOUSagtlIh7hQ8l56T832690YXBmQ/eQJPPy3nSciV0t1UY+EuPw2M9RsVjci6lUF9+vHKSA==","signatures":[{"sig":"MEUCIQC2TrwlgCVJX1yFdMFZY2dXE2CJDh/jeQ/cvwjZZ81wCwIgSqjnwKjiaT9T5ejC9vwzgOQxXVIYFH4lv/bDDHLfwao=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":907586},"type":"module","types":"./dist/types/index.d.ts","module":"./dist/index.js","gitHead":"d27fc7d24434fbb47b7ba71a8b496ea4d7801f0e","scripts":{"test":"vitest","build":"tsx build.ts","genCs":"tsx generator/genCs/gen.ts","genTs":"tsx generator/genTs/gen.ts","genJson":"tsx generator/genJson/gen.ts","prepack":"npm run build","copyGenRes":"tsx utils/build/copyGenRes.ts","test-watch":"vitest --watch"},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"repository":{"url":"https://gitee.com/au114514/au-npm-pkgs","type":"git","directory":"packages/china-areas"},"_npmVersion":"11.0.0","description":"2025中国行政区划数据(精确到区县)及工具函数","directories":{},"_nodeVersion":"22.10.0","_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","vite":"^6.3.5","execa":"^9.5.3","vitest":"^3.1.3","typescript":"^5.8.3","vite-plugin-dts":"^4.5.3"},"_npmOperationalInternal":{"tmp":"tmp/china-areas_0.6.0_1747285637742_0.974488583430509","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@aurouscia/china-areas","version":"0.7.0","description":"2026中国行政区划(精确到区县)及工具函数","type":"module","license":"MIT","author":{"name":"Au"},"keywords":["china","cn","areas","area","data","province","city","district","division","json","typescript"],"repository":{"type":"git","url":"https://gitee.com/au114514/au-npm-pkgs","directory":"packages/china-areas"},"types":"./dist/types/index.d.ts","module":"./dist/index.js","scripts":{"build":"tsx build.ts","updateSource":"tsx generator/updateSource.ts","genTs":"tsx generator/genTs/gen.ts","genJson":"tsx generator/genJson/gen.ts","genCs":"tsx generator/genCs/gen.ts","copyGenRes":"tsx utils/build/copyGenRes.ts","prepack":"npm run build","test":"vitest","test:run":"vitest run"},"devDependencies":{"execa":"^9.6.1","tsx":"^4.22.2","typescript":"^5.9.3","vite":"^7.3.3","vite-plugin-dts":"^4.5.4"},"gitHead":"72c51964bc89d32f22ea26ae954b70aa11a54bb2","_id":"@aurouscia/china-areas@0.7.0","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-NYA+rexzIxN86CBOYG92dFH7u95g0Ui6uHEcNheo13vMG3YncNRekSttiFFraJEr+hbQvfB17V3SRJjPbVjPwA==","shasum":"d7046bb00ad01ac2f74ebd27c059bc084a4d49d6","tarball":"https://registry.npmjs.org/@aurouscia/china-areas/-/china-areas-0.7.0.tgz","fileCount":10,"unpackedSize":885860,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCGwtoz/GmqdFlJwjW8mmQG2jErkCt6M6NLnHUFhayqbgIhAJurEsdlVe2MbsutA9lZA2S60GTR+aDdJla1ShYgnSif"}]},"_npmUser":{"name":"aurouscia","email":"18971501210@189.cn"},"directories":{},"maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/china-areas_0.7.0_1779130351507_0.7508332708420322"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-10T16:54:53.153Z","modified":"2026-05-18T18:52:31.845Z","0.0.0":"2025-05-10T16:54:53.452Z","0.0.1":"2025-05-10T17:37:24.995Z","0.1.1":"2025-05-11T08:15:19.099Z","0.2.0":"2025-05-13T10:54:13.107Z","0.4.0":"2025-05-13T16:29:00.692Z","0.5.0":"2025-05-13T16:56:16.427Z","0.6.0":"2025-05-15T05:07:17.987Z","0.7.0":"2026-05-18T18:52:31.713Z"},"author":{"name":"Au"},"license":"MIT","keywords":["china","cn","areas","area","data","province","city","district","division","json","typescript"],"repository":{"type":"git","url":"https://gitee.com/au114514/au-npm-pkgs","directory":"packages/china-areas"},"description":"2026中国行政区划(精确到区县)及工具函数","maintainers":[{"name":"aurouscia","email":"18971501210@189.cn"}],"readme":"# 中国大陆地区行政区划数据\n## 数据来源\n[中国国家地名信息库](https://dmfw.mca.gov.cn) 官方开放API，精确到区县，本包发布时间即为数据更新时间\n\n## 安装\n```sh\nnpm install @aurouscia/china-areas\npnpm add @aurouscia/china-areas\n```\n\n## 数据结构约定\n- 直辖市下的市、区、县（例如`上海市-静安区`），均为该直辖市的直接子级（没有中间的“虚拟地级”）\n- 省直辖县（例如`湖北省-仙桃市`），均为所属省的直接子级（没有中间的“虚拟地级”）\n- 缺少港澳台地区的数据（仅有省级元素，没有子级）\n\n## json使用\n`/dist/json`目录下为json文件，有扁平的和树状结构的两种版本，两种版本各有一个`.min.json`压缩版。\n- 扁平版本\n    - `code`为六位行政区划代码\n    - `name`为行政区划名称\n- 树状版本：若有子级，则有`children`属性为子级数组，否则没有`children`属性。\n- 压缩版：重命名了属性`code -> c`，`name -> n`，`children -> d`，且没有空格和换行符。\n\n## js/ts使用\n本包的默认导出对象，即为所有行政区划的数组（扁平的，无树状结构）  \n```ts\nimport areas from '@aurouscia/china-areas'\n```\n其中每个元素均有两个属性：\n- `code`为六位行政区划代码\n- `name`为行政区划名称\n如果使用ts，可引入该元素的类型定义：\n```ts\nimport { Division } from '@aurouscia/china-areas'\n```\n如果需要树状结构，可以使用下文介绍的工具函数。\n\n### 工具函数\n```ts\nimport { xxxx } from '@aurouscia/china-areas'\n```\n#### getTopDivisions\n获取所有的顶级行政区划，即省、直辖市、自治区\n#### getDivisionChildren\n获取指定行政区划代码的所有子级行政区划（错误的或没有子级的会返回空数组）\n第二个参数为是否严格匹配（默认为`false`，即允许有错误）否则会在代码不存在时抛出异常。\n#### getDivisionParent\n获取指定行政区划代码的父级行政区划（错误的或没有父级的会返回undefined）\n第二个参数为是否严格匹配（默认为`false`，即允许有错误）否则会在代码不存在时抛出异常。\n#### matchDivisionByCode, matchDivisionByNames\n根据行政区划六位代码或名称查找行政区划。  \n第一个参数为名称数组/代码字符串，第二个参数为是否严格匹配（默认为`false`，即允许有错误）。\n- 名称：字符串数组，例如`['湖北省','武汉市','江岸区']`。  \n    - 如果是一般的省-市-区三级，则数组长度最多为3\n    - 如果是直辖市、省直辖县、直筒子市，则数组长度最多为2\n    - 如果是港澳台地区，则数组长度最多为1\n    - 会从高到底匹配，如果某一级没有匹配项，则只会返回到其上一级，例如`['湖北省','武昌区']`会返回`[{name:'湖北省',code:'420000'}]`，**严格匹配时会抛出异常**。\n- 代码：六位字符串，例如`'420102'`。\n    - 如果匹配失败，则会返回空数组\n    - 如果代码长度不是六位，则会返回空数组\n    - 会从高到低匹配，如果某一级没有匹配项，则只会返回到其上一级，例如`'428802'`会返回`[{name:'湖北省',code:'420000'}]`，**严格匹配时会抛出异常**。\n- 返回值（如果没有抛出异常）：从高到低的区划对象数组\n    - 长度为3：`[{省}, {市}, {区}]`\n    - 长度为2：`[{省}, {市/省直辖县}]` 或 `[{直辖市}, {区}]`\n    - 长度为1：`[{省}]`\n    - 长度为0：匹配失败\n#### isFinalDivision\n判断指定行政区划代码是否为最终级行政区划（即没有子级）\n#### isExistingCode\n判断指定行政区划代码（任意级别均可）是否存在\n\n## 原版数据\nraw数据在`/dist/raw`下，通过 `npm run updateSource` 脚本从 API 获取并生成\n\n## 源码\n源代码中不包含数据，只包含生成器，如果需要：\n1. 运行`npm run updateSource` 从 API 获取最新数据并生成 `source.txt`（必须）\n2. 运行`npm run genTs`生成包含数据的代码（必须）\n3. 运行`npm run genJson`生成json文件\n4. 运行`npm test`运行单元测试\n5. 运行`npm run build`打包\n\n## 发现错误/过期\n如果发现错误或过期，请在gitee上提issue，我会及时更新  \nhttps://gitee.com/au114514/au-npm-pkgs\n\n## 许可证\nMIT","readmeFilename":"README.md"}