地址信息解析接口（address.parse）：非结构化地址转省市区

这个接口能解决什么问题

用户填写的收货地址往往是「张三 138xxxx 重庆市巴南区龙洲湾街道某小区 3 栋」这样的自由文本，无法直接入库做区域统计或三级联动回显。address.parse 前半程用大模型做语义抽取，后半程用平台自有的行政区划库（region_data，每周日同步）把地名规范化并补齐 adcode，避免模型返回的名称与库里不一致导致匹配失败。

一句话说明

输入一段文本，输出姓名 + 电话 + 地址文字 + 省 / 市 / 区县名称与 adcode，解析不出地址或省级行政区时不计费。

适用场景

电商 / 物流收货地址结构化：把用户手填地址拆成标准字段
订单地址清洗：规范地名、补齐行政区划代码
省市区自动归类：按 adcode 做区域统计
地址三级联动回显、邮编填充、报表区域统计

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/address/parse`
请求方式	GET（text 放 Query）或 POST（text 放 JSON body）
鉴权方式	请求头 `X-API-Key`
接口编码	`address.parse`
收费类型	按次计费（PER_CALL，0.0200 元/次）
计费规则	解析失败不收费：文本为空 / 超长、大模型不可用、识别不出地址或省级行政区时返回失败且不扣费
文本长度	单次不超过 200 个字符
典型用途	收货地址结构化、订单清洗、省市区归类、邮编填充

如何调用

文本含换行、引号等特殊字符时建议用 POST，把请求体存成 body.json 后用 -d @body.json 提交：

cURL（POST）

curl -s -X POST "https://api.xujian.tech/openapi/address/parse" -H "Content-Type: application/json" -H "X-API-Key: 你的APIKey" -d @body.json

body.json 内容

JSON

{
  "text": "张三 13800138000 重庆市巴南区龙洲湾街道龙洲大道255号17-1"
}

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "name": "张三",
    "phone": "13800138000",
    "address": "重庆市巴南区龙洲湾街道龙洲大道255号17-1",
    "province": "重庆市",
    "city": "重庆市",
    "district": "巴南区",
    "adcode": "500113",
    "apiCode": "address.parse",
    "apiName": "地址信息解析",
    "chargeType": "PER_CALL",
    "balance": 99.9800,
    "costMs": 480
  }
}

计费说明

按次计费，0.0200 元/次。采用「先预鉴权、解析成功后再扣费」的两段式：文本为空 / 超长、大模型不可用、识别不出地址或省级行政区时返回失败，不扣费、不写扣费流水。只有真正解析出有效地址才计一次费用。

常见问题

直辖市怎么解析？ 平台兼容直辖市与简称异名，重庆市的区会正确落到 district。
文本太长会怎样？ 超过 200 字符直接返回失败，不计费。
能和 region.query 一起用吗？ 可以，address.parse 内部就用到了 region 库做规范化。