中国行政区划查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_81da94ec/china-administrative-division-query。
技能介绍
要解决什么问题
做地址表单、物流路由、合规报表或数据清洗时,你往往需要与民政部口径一致的省市区县(及乡镇)编码与名称,而不是各平台各自维护、容易过期的静态 JSON。本技能把查询方式收敛到民政部地名服务公开接口,用统一的 code + maxLevel 规则做按父级下钻,避免手写层级表或猜行政区划代码格式。
技能如何工作
接口为 GET:https://dmfw.mca.gov.cn/9095/xzqh/getList,参数直接拼在 URL 上:
code:父级区划代码;留空表示从全国根节点查询maxLevel:返回数据的层级深度:1省、2市、3区县、4乡镇
典型用法与 SKILL 一致:全国省级用 maxLevel=1;例如山东省下所有市用 code=37&maxLevel=2;青岛市下区县用 code=3702&maxLevel=3;某区县下乡镇用 code=370211&maxLevel=4。当用户提到「行政区划」「省市区联动」「获取下级区划」时,可按上述传参编写请求或封装客户端。
适用边界与注意点
- 数据以民政部地名服务为准;若业务要对接国标 GB/T 2260 或其它第三方库,需自行核对字段与更新节奏是否一致。
- 本技能描述的是查询接口与参数语义,不包含缓存策略、重试、鉴权或 SLA;生产环境应自行处理超时、限流与错误响应。
- 乡镇级数据量较大,建议只在用户选定区县后再请求
maxLevel=4,避免一次性拉全国乡镇。
使用场景
- 电商或 SaaS 注册页需要按用户所选省份动态加载下属城市列表,用父级 `code` 与 `maxLevel=2` 请求民政部接口
- 物流系统在录入始发/目的地址时,需根据已选市级代码拉取区县选项,避免维护过期的本地行政区划表
- 数据清洗脚本要把历史订单里的模糊地址对齐到标准区县编码,先按省、市逐级下钻再匹配 `maxLevel=3` 结果
- 政务或合规报表要导出某区县下全部乡镇名称与代码,在选定区县后调用 `maxLevel=4` 获取下级列表
适合人员
- 负责地址与区域选择组件的前端工程师,需要对接权威数据源实现省市区县联动
- 做订单与地址主数据治理的后端或数据工程师,要把业务库与民政部口径的区划编码对齐
- 实施 ERP、CRM 或 OMS 的集成顾问,在客户现场配置多级行政区划下拉与编码映射
- 编写填报或统计类产品的业务开发,需在用户选定上级区划后动态加载下级选项