地址智能解析识别API接口(address)说明文档

以下是关于地址智能识别API接口(address)的整理说明，供开发参考：

1. 接口简介

• 功能：对非结构化地址文本进行智能解析，提取结构化信息（如姓名、电话、省市区等）。

• 适用行业：快递、电商等需批量处理地址的场景。

• 特点：高识别率、精准解析、稳定合规，支持技术对接服务。

---

2. 请求说明

• 请求方式：GET/POST（Query参数）

• 请求URL：ip/address（示例，需替换为实际URL）

• 字符限制：text参数最大支持1000字节（约500汉字）。

• 请求参数

参数名	类型	是否必需	说明	示例值
text	string	是	待识别的非结构化地址文本	深圳市南山区腾讯大厦35层电话86013388
token	string	是	身份认证密钥（需申请获取）	your_access_token

---

3. 返回响应

{
  "status": "success",
  "left_nums": "100",       // 剩余调用次数
  "timestamp": "1620000000",// 时间戳
  "data": {
    "person": "张三",       // 姓名
    "phonenum": "86013388", // 电话
    "province": "广东省",    // 省份
    "city": "深圳市",        // 城市
    "county": "南山区",      // 区县
    "town": "粤海街道",      // 乡镇/街道
    "detail": "麻岭社区科技中一路腾讯大厦35层", // 详细地址
    "province_code": "44",  // 省份编码
    "city_code": "4403",    // 城市编码
    "county_code": "440305",// 区县编码
    "town_code": "440305012",// 街道编码
    "lat": 22.5401,         // 纬度
    "lng": 113.9343,        // 经度
    "text": "原始输入文本"   // 回传原始文本
  },
  "log_id": 123456          // 请求日志ID
}

---

4. 错误处理

• 400 Bad Request：参数缺失或text超长。

• 401 Unauthorized：token无效或过期。

• 500 Server Error：服务端异常，需联系技术支持。

---

5. 调用示例（Python）

import requests

url = "https://api.example.com/address"
params = {
    "text": "深圳市南山区腾讯大厦35层电话86013388",
    "token": "your_access_token"
}

response = requests.get(url, params=params)
if response.status_code == 200:
    result = response.json()
    print("解析结果：", result["data"])
else:
    print("请求失败：", response.text)

---

6. 注意事项

1. 密钥管理：token需保密，防止盗用。

2. 限频控制：根据left_nums合理规划调用频率。

3. 数据合规：确保用户地址信息处理符合隐私政策。

如需进一步协助，请联系技术支持团队。