收货地址智能识别

接口标识: addressidentify 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

收货地址智能识别接口把一段随手粘贴的收货信息拆成规范字段，单次不超过 300 字，姓名、电话与详细地址混写在同一段文字里也能解析，一次返回 13 个结构化字段：省、市、区县、街道乡镇四级名称与对应的国标行政区划代码（省、市、区县为 6 位），以及邮政编码、收件人姓名、电话、分机号和去掉省市区镇后剩余的详细地址，多个姓名或电话按顺序输出。适合电商订单地址录入、物流面单拆分与表单地址结构化。

详细介绍

![收货地址智能识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_addressidentify__1794169260_e442128801ef.png)

一段混写的地址文本，自动拆成省市区街道、邮编、姓名、电话与详细地址——电商收货、表单填写省去逐字段录入。

## 接口概述

收货地址智能识别接口面向电商订单地址录入、物流面单拆分、表单地址结构化等场景：传入一段包含收件人姓名、电话与详细地址的自然语言文本，由阿里云百炼大模型（默认使用 qwen-plus，可在后台切换）自动拆分为省、市、区、街道及其国标行政区划代码、邮编、电话、姓名、详细地址等结构化信息，十三个字段一次性返回；无法从文本中解析出的字段返回空字符串。接口为同步调用，提交后立即返回结果。需要说明：本接口解析单一收件人地址，若文本中包含多个姓名或电话，各字段取最先解析到的值；单次地址文本长度不超过 300 字。

## 核心能力

1. **区划拆分**：自动识别省、市、区/县、街道/镇，并推断对应的国标行政区划代码。
2. **要素分离**：把混写的姓名、电话、详细地址分离到对应字段，无需用户分栏填写。
3. **邮编识别**：从文本中提取邮政编码，便于物流与区域校验。
4. **自由输入**：文本无固定格式，姓名、电话、地址可混写，自动识别与分离。
5. **兜底输出**：无法解析的字段返回空字符串，十三个字段始终返回，不会出现 null。

## 产品优势

- **接入简单**：POST 请求、JSON 返回，仅一个 `content` 业务参数，集成成本低。
- **字段齐全**：省市区街道及其代码、邮编、电话、分机、姓名、详细地址共十三个字段始终返回，无需编写缺字段兜底逻辑。
- **同步返回**：提交即返回拆分结果，可直接嵌入下单、寄件等实时流程。
- **自然语言输入**：无需按固定格式分栏，用户口语化的一段地址即可解析。
- **降本增效**：替代人工拆分与逐字段录入地址，订单与物流流程自动化。

## 效果展示

一句话理解：它就像一位老练的快递分拣员读一段潦草的地址——把省、市、区、街道、姓名、电话乃至邮编都替你分得清清楚楚。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| content | 张三 13800138000 广东省深圳市南山区粤海街道科技园南路88号3栋201 518057 | 待解析的地址文本，可同时含姓名、电话与详细地址，必填，长度不超过 300 字 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 省份 | `"广东省"` | `province` |
| 省级区划代码 | `"440000"` | `province_code`，6 位国标代码 |
| 城市 | `"深圳市"` | `city` |
| 市级区划代码 | `"440300"` | `city_code`，6 位国标代码 |
| 区/县 | `"南山区"` | `county` |
| 区级区划代码 | `"440305"` | `county_code`，6 位国标代码 |
| 街道/镇 | `"粤海街道"` | `town` |
| 街道区划代码 | `""` | `town_code`，无法解析时为空字符串 |
| 邮政编码 | `"518057"` | `zip_code` |
| 联系电话 | `"13800138000"` | `phone_num` |
| 分机号 | `""` | `ext_mobile`，无分机时为空字符串 |
| 收件人姓名 | `"张三"` | `person` |
| 详细地址 | `"科技园南路88号3栋201"` | `detail` |

API请求示例：

```
POST /api/v1/addressidentify
content=张三 13800138000 广东省深圳市南山区粤海街道科技园南路88号3栋201 518057
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "province": "广东省",
    "province_code": "440000",
    "city": "深圳市",
    "city_code": "440300",
    "county": "南山区",
    "county_code": "440305",
    "town": "粤海街道",
    "town_code": "",
    "zip_code": "518057",
    "phone_num": "13800138000",
    "ext_mobile": "",
    "person": "张三",
    "detail": "科技园南路88号3栋201"
  }
}
```

行政区划代码（province_code/city_code/county_code）为依据省市区推断的 6 位国标代码；街道/镇级代码无法解析时 `town_code` 为空字符串；文本含多个电话或姓名时各字段取最先解析到的值，建议业务侧对关键字段做非空校验后再使用。

## 应用场景

- **电商订单地址录入**：用户粘贴一段收货地址，自动拆分为省市区与详细地址，减少逐字段选择
- **物流面单拆分**：把面单上的收件人信息结构化，便于分拣与派送
- **表单地址结构化**：将表单中的自由文本地址转为标准行政区划字段
- **客户资料清洗**：批量把历史客户地址解析为结构化字段，便于统计与匹配
- **O2O 配送地址解析**：外卖、即时配送自动拆分收货地址，便于骑手导航

## 应用案例

- **电商平台**：用户下单时粘贴一整段收货地址，系统自动拆分为省市区、详细地址与姓名电话并回填，用户不再逐个下拉选择，地址录入错误明显减少。
- **物流企业**：收件面单文本批量结构化，行政区划代码自动匹配分拣规则，人工分拣与面单录入错误减少。
- **本地生活服务**：用户配送地址解析后按街道与详细地址派单，骑手匹配地址效率提升，配送体验改善。

常见问题

Q：这个接口能解析出哪些信息？

A：从地址文本中提取省 province、省代码 province_code、市 city、市代码 city_code、区/县 county、区代码 county_code、街道/镇 town、街道代码 town_code、邮编 zip_code、电话 phone_num、分机 ext_mobile、姓名 person、详细地址 detail，共十三个字段。

Q：地址文本有格式要求吗？

A：没有固定格式要求，支持自然语言输入；姓名、电话、详细地址可以混写在一段文本里，接口会自动识别与分离。单次文本长度不超过 300 字。

Q：行政区划代码是怎么来的？字段解析不到会怎样？

A：province_code/city_code/county_code 为依据地址中省市区推断的 6 位国标代码，常见地址通常可解析，偏远或新调整区划可能为空或需校验；无法从文本推理出的字段一律返回空字符串，不会出现 null，建议对关键代码做二次校验与非空判断。

Q：支持多个收件人的地址吗？

A：本接口解析单一收件人地址。若文本中包含多个姓名或电话，各字段取最先解析到的值，不会返回多组结果；多收件人场景建议拆分后分别调用。

地址智能识别收货地址解析地址拆分行政区划代码地址结构化

接口地址： https://www.phpwc.cn/api/addressidentify

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`content`	string	必填	-	待解析的地址文本，可同时包含收件人姓名、电话与详细地址，长度不超过300个字符

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`province`	string	省/直辖市
`province_code`	string	省国标code（6位行政区划代码）
`city`	string	市/地级市
`city_code`	string	市国标code（6位行政区划代码）
`county`	string	区/县
`county_code`	string	区县国标code（6位行政区划代码）
`town`	string	街道/乡/镇
`town_code`	string	街道/乡镇国标code
`zip_code`	string	邮政编码
`phone_num`	string	电话号码，多个则按顺序输出
`ext_mobile`	string	分机号
`person`	string	收件人姓名，多个则按顺序输出
`detail`	string	详细地址（去除省市区镇后的剩余部分）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试