物流/地图行业方案：用地址分词统一清洗全国收货地址
汉字多功能转换器汉字转拼音简繁转换全角半角地址分词 # 物流/地图行业方案：用地址分词统一清洗全国收货地址
> 接口/接入点：汉字多功能转换器 · 地址分词（99-117）· 适用：物流、电商、地图服务 · 阅读时间：约 8 分钟
## 核心要点
- 地址分词(99-117)把中文地址切成"省 市 区 路 号"的结构化片段，便于归一与区县级识别。
- ⚠️ 它用 `addr`（query 参数、必须、长度>4），返回 `ret_code`/`msg`/`result`，与其它接入点结构不同。
- 清洗链路：长度校验 → 调用分词 → 解析 `result` → 与地址库/行政区码比对。
## Why：为什么物流需要地址分词
全国收货地址千奇百怪："云南省昆明市五华区学府路745号""昆明五华区学府路745号"指向同一地点却写法不一。下单、分单、路由都依赖结构化地址。地址分词把自由文本切成标准片段，是地址标准化流水线的第一环。
## What：接入点速览
| 项 | 说明 |
|----|------|
| 地址 | `https://route.showapi.com/99-117?appKey=YOUR_APPKEY` |
| 必填 | `addr`（query，长度 > 4） |
| 返回 | `ret_code`(0=成功)、`result`(分词)、`msg`(出错时) |
## How：地址归一流水线
**Python（校验 + 分词 + 解析）**
```python
import requests
def segment(addr, appkey="YOUR_APPKEY"):
if len(addr) <= 4: # 长度校验，避免无效调用
return None, "地址过短(addr 需>4)"
r = requests.get("https://route.showapi.com/99-117",
params={"appKey": appkey, "addr": addr},
timeout=10).json()
if r.get("showapi_res_code") != 0:
return None, r.get("showapi_res_error")
body = r["showapi_res_body"]
if body.get("ret_code") != 0:
return None, body.get("msg")
return body["result"], None
seg, err = segment("云南省昆明市五华区学府路745号")
print(seg) # 云南省 昆明市 五华区 学府路 745号
```
## 返回示例与解析
```json
{ "showapi_res_code": 0, "showapi_res_body": { "ret_code": 0, "result": "云南省 昆明市 五华区 学府路 745号", "msg": "" } }
```
| 字段 | 说明 |
|------|------|
| `result` | 空格分隔的地址片段，可再按"省/市/区/路/号"切分 |
| `ret_code` | 业务级状态码，0 成功 |
| `msg` | 仅出错时存在 |
## 进阶/边界
- `addr` 长度必须 > 4；过短地址先做长度校验，别直接发请求。
- 分词结果是"片段列表"，区县级精确识别建议结合行政区码表二次匹配，接口本身只做分词。
- 与转拼音/全半角不同，地址分词返回 `result` 而非 `data`，解析时务必用对字段。
## FAQ
**Q1：分词能直接给出区县级编码吗？**
接口返回分词片段，不直接给行政区编码；需自行对接行政区码表。
**Q2：为什么用 addr 而不是 content？**
地址分词专门用 `addr` 参数（且为 query），其它接入点才用 `content`。
**Q3：短地址没结果怎么办？**
保证 `addr` 长度 > 4，并传入较完整的地址文本。
**Q4：大量订单怎么控速？**
客户端限流 + 失败重试；具体档位以官方说明为准。
## 相关能力 / 下一步阅读
- [汉字多功能转换器：地址分词实战（物流/地图场景的地址智能切分）](https://www.showapi.com/guides/hanzi-address-segment-99)
- [汉字多功能转换器错误排查：showapi_res_code 与地址分词的 ret_code/msg](https://www.showapi.com/guides/hanzi-converter-errors-99)
- [汉字多功能转换器免费额度与档次限制：如何避免调用被限流](https://www.showapi.com/guides/hanzi-converter-rate-limit-99)
- **本系列共 12 篇**：查看[汉字多功能转换器指南总目录](https://www.showapi.com/guides/hanzi-converter-guides-99)
