阿里云地址标准化服务从开通到生产级API调用指南_AI热点日报

阿里云地址标准化服务从开通到生产级API调用指南

类型：热点整理2026-07-15

地址标准化这个技术概念，听起来可能有点抽象，但换个角度理解就简单了——它本质上是一套能“读懂”地址、并把它整理成标准格式的算法服务。阿里云基于海量的地址语料库和自然语言处理能力，把这套能力打磨成了产品。无论是解决“一地多名”的混乱、地址解析的困难，还是辨别地址真伪，它都能派上用场，尤其适合那些需要做

地址标准化这个技术概念，听起来可能有点抽象，但换个角度理解就简单了——它本质上是一套能“读懂”地址、并把它整理成标准格式的算法服务。阿里云基于海量的地址语料库和自然语言处理能力，把这套能力打磨成了产品。无论是解决“一地多名”的混乱、地址解析的困难，还是辨别地址真伪，它都能派上用场，尤其适合那些需要做地址数据清洗和标准化的企业、政府机构和开发者。

阿里云地址标准化服务完全对接指南：从开通到生产级API调用

从技术架构的角度看，地址标准化更像是一个一站式的闭环地址数据处理平台。它把各行业业务系统里登记的地址数据，进行纠错、补全、归一、结构化、标签化等一系列NLP处理，最终实现地址库的标准化。并且，在这个基础上，它还向上提供了地址智能填写、搜索联想、正逆编码、地址围栏等更高级的服务。

整个接口服务分为基础服务和高级服务两大类。其中高级服务覆盖了地址文本清洗、智能填写、智能应用、空间化、地点特征分析、语音对话六个场景，加起来有二十多个接口。

二、核心能力与功能接口

目前地址标准化支持的核心功能包括：地址结构化、物流面单信息提取、门址标准化、地址归一、地址补齐、行政区划识别、邮编识别。下面把几个主要接口拆开来说说。

地址结构化（StructureAddress）：把一段地址文字拆成省、市、区、街道、路名、门牌号这些要素，相当于给地址做“解剖”。
地址纠错（CorrectAddress）：对用户输入的地址做错误检测和修正，比如行政区划名称写错了、路名路号不对，它都能帮你改过来。
地址补全：地址信息缺了省、市、区或者街道？它能自动补上，不用你操心。
门址标准化：这个功能比较强大，它既会补全地址，又会修正行政区和路名路号的错误，最后输出标准的地名信息。
地址归一（OneAddress）：这是解决“同址异名”问题的利器。比如“北京市朝阳区建国路88号”和“北京朝阳建国路88号”，在系统里可能被当成两个地方，但归一化接口能把它们统一成标准表达。
行政区划识别：从地址文本里提取出省、市、区、县这些信息。
邮编识别：根据地址自动识别对应的邮政编码。
高精度经纬度查询（HpGeocode）：把地址解析成经纬度坐标，精度能到楼栋级别，相当精准。

在版本升级方面，地址标准化已经新增了多地址一致性判断、地址异常诊断等核心能力，模型效果也在持续提升。同时，还增加了定制干预管理模块，用户可以通过线上自定义的方式，自助修复模型的一些badcase。

三、对接前的准备工作

在正式使用之前，有几个准备工作需要先完成。

3.1 开通阿里云账号与服务

首先，注册并登录阿里云账号。从官网首页导航栏选择“产品分类”→“人工智能与机器学习”→“自然语言处理”→“地址标准化”，进入产品详情页。或者直接在首页搜索“地址标准化”也能找到。进入产品页面后，点击开通服务，按指引操作就行。

需要先登录阿里云控制台，点击：阿里云控制台

3.2 创建项目

服务开通后，还需要创建项目来管理API调用。操作路径是：打开地址标准化控制台，在左侧菜单选择“我的项目”，然后点击“创建项目”按钮。在弹出的对话框里输入项目名称和描述，确认后就算完成了。创建完成后，系统会为每个项目生成一个唯一的AppKey，后续调用API时要用它来做身份识别。

3.3 RAM权限配置

为了账号安全，建议用RAM子账号来调用API，而不是直接用主账号的AccessKey。RAM（访问控制）是阿里云提供的身份管理与访问控制服务，可以精细化管理用户对云资源的访问权限。

RAM用户默认没有任何权限，需要由阿里云账号管理员为其授权后才能访问地址标准化服务。具体操作流程如下：

登录RAM控制台，创建一个RAM用户。
为RAM用户授予地址标准化的相关权限策略。系统提供了两种预设策略：AliyunAddrpFullAccess（管理权限）和AliyunAddrpReadOnlyAccess（只读权限）。
如果系统策略不满足需求，可以创建自定义权限策略，用脚本编辑模式配置更精细化的Action和Resource授权。
在“身份管理-用户”中为RAM用户添加授权，完成后RAM用户就能通过AccessKey调用地址标准化API了。

推荐的做法是：把人员用户和程序用户分开，为不同的应用程序创建独立的RAM用户并授予最小权限。

四、API调用方式详解

地址标准化的API采用RPC风格，支持通过HTTP GET或POST请求来调用。下面详细说说请求结构和调用方法。

4.1 请求结构

API请求的基本结构如下：

https://Endpoint/?Action=xx&Parameters

各组成部分的含义：

Endpoint：服务接入地址，固定为 address-purification.cn-hangzhou.aliyuncs.com。
Action：要执行的操作名称，比如调用地址结构化接口时取值 StructureAddress。
Version：API版本号，地址标准化是 2019-11-18。
Parameters：请求参数，包含公共请求参数和API自定义参数，参数之间用“&”分隔。

4.2 公共参数

每个API请求都需要携带以下公共参数：

AccessKeyId：访问密钥ID，标识调用者身份。
Signature：请求签名，验证请求合法性。
SignatureMethod：签名算法，固定为 HMAC-SHA1。
SignatureVersion：签名版本，固定为 1.0。
SignatureNonce：唯一随机数，防止请求重放攻击。
Timestamp：请求时间戳，格式为 YYYY-MM-DDThh:mm:ssZ。
Format：返回结果格式，支持JSON和XML。

4.3 签名机制

签名计算是API调用的核心安全环节。流程如下：

构造规范化的请求字符串（Canonicalized Query String）：把所有请求参数按名字字典序排列，用 = 连接参数名和值，参数之间用 & 连接。
构造待签名字符串（StringToSign）：格式为 HTTP方法 & 编码后的URI & 编码后的规范化请求字符串。
使用AccessKey Secret对StringToSign进行HMAC-SHA1加密，结果进行Base64编码得到签名。
把签名添加到请求参数中，参数名为 Signature。
实际开发中，阿里云SDK已经自动封装了签名逻辑，开发者不需要手动计算签名。

五、SDK接入与代码示例

阿里云为地址标准化提供了多语言SDK，包括Ja va、Python、Go、.Net、C++、PHP等。可以在 https://open.aliyun.com/sdk 页面搜索“地址标准化”下载对应语言的SDK安装包。地址标准化SDK封装了2019-11-18版本API，用访问密钥识别调用者身份，提供自动签名等功能。使用地址标准化功能需要同时安装地址标准化SDK和阿里云核心库。

5.1 Python SDK 示例

首先安装Python SDK：

pip install aliyunsdkcore aliyunsdkaddress_purification

以下是一个调用地址结构化接口的完整Python示例：

from aliyunsdkcore.client import AcsClient
from aliyunsdkaddress_purification.request.v20191118 import StructureAddressRequest
# 初始化客户端
client = AcsClient(
    '您的AccessKeyId',
    '您的AccessKeySecret',
    'cn-hangzhou'
)
# 构造请求对象
request = StructureAddressRequest.StructureAddressRequest()
request.set_accept_format('json')
# 设置请求参数
request.set_AppKey('您的项目AppKey')
request.set_ServiceCode('addrp')
request.set_Text('杭州市余杭区五常街道文一西路969号阿里巴巴西溪园区')
request.set_DefaultProvince('浙江省')
request.set_DefaultCity('杭州市')
request.set_DefaultDistrict('余杭区')
# 发起请求并获取响应
try:
    response = client.do_action_with_exception(request)
    print(response.decode('utf-8'))
except Exception as e:
    print(f'调用失败: {e}')

以下是调用高精度经纬度查询接口（楼栋级别）的示例：

from aliyunsdkcore.client import AcsClient
from aliyunsdkaddress_purification.request.v20191118 import HpGeocodeRequest
client = AcsClient('您的AccessKeyId', '您的AccessKeySecret', 'cn-hangzhou')
request = HpGeocodeRequest.HpGeocodeRequest()
request.set_accept_format('json')
request.set_Text('杭州市阿里巴巴西溪园区')
request.set_DefaultProvince('浙江省')
request.set_DefaultCity('杭州市')
request.set_DefaultDistrict('余杭区')
response = client.do_action_with_exception(request)
print(response.decode('utf-8'))

5.2 Ja va SDK 示例

使用Ja va SDK需要引入以下Ma ven依赖：


    com.aliyun
    aliyun-ja va-sdk-core
    4.6.3


    com.aliyun
    aliyun-ja va-sdk-address-purification
    1.0.0

以下是Ja va调用地址纠错接口的示例：

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.address_purification.model.v20191118.CorrectAddressRequest;
import com.aliyuncs.address_purification.model.v20191118.CorrectAddressResponse;
import com.alibaba.fastjson.JSONObject;
public class AddressCorrectionDemo {
    public static void main(String[] args) {
// 创建客户端
DefaultProfile profile = DefaultProfile.getProfile(
    "cn-hangzhou",
    "您的AccessKeyId",
    "您的AccessKeySecret"
);
IAcsClient client = new DefaultAcsClient(profile);

// 构造请求
CorrectAddressRequest request = new CorrectAddressRequest();
request.setAppKey("您的项目AppKey");
request.setServiceCode("addrp");
request.setText("北京朝阳区建国路88号");
request.setDefaultProvince("北京市");
request.setDefaultCity("北京市");

try {
    CorrectAddressResponse response = client.getAcsResponse(request);
    System.out.println(JSONObject.toJSONString(response));
} catch (Exception e) {
    e.printStackTrace();
}
    }
}

5.3 直接调用HTTP API示例

如果不使用SDK，也可以直接发送HTTP请求调用API：

https://address-purification.cn-hangzhou.aliyuncs.com/
  ?Action=StructureAddress
  &Format=JSON
  &Version=2019-11-18
  &AccessKeyId=您的AccessKeyId
  &Signature=计算出的签名值
  &SignatureMethod=HMAC-SHA1
  &SignatureNonce=唯一随机数
  &SignatureVersion=1.0
  &Timestamp=2026-07-12T10:00:00Z
  &AppKey=您的项目AppKey
  &ServiceCode=addrp
  &Text=杭州市余杭区文一西路969号

六、控制台测试与监控

6.1 API测试和体验

在正式写代码之前，先在控制台进行API测试是个好习惯，可以验证接口功能和返回结果。操作路径是：打开地址标准化控制台，在左侧菜单选择“API测试和体验”。在项目选择的下拉菜单里选好对应的项目，然后选择要测试的API，在测试地址的文本框里输入地址，点击“开始测试”就能看到结果。

6.2 数据监控与统计

控制台提供了完善的数据监控功能。在左侧菜单选择“数据监控”，可以查不同项目在不同时间段内的服务调用量和QPS统计，并以折线图的形式展示出来。在图表上方可以选择不同的时间维度查看，也可以自定义时间间隔。数据监控会存在小时级别的延迟，建议定期查看，掌握服务使用情况。

6.3 定制干预管理

当模型对某些特定地址的处理结果不满足业务需求时，可以通过定制干预管理来修正。在控制台左侧菜单选择“定制管理”，点击“创建实例”可以新建一条实例干预修正规则。通过下拉选择项目并配置干预规则，就能实现模型badcase的自助修复。

七、地址归一化与高级能力

地址归一化是地址标准化的一项核心高级能力。在电商、物流、O2O这些业务场景中，用户提交的收货地址往往存在大量非标准化表达。比如，“北京市朝阳区建国路88号”与“北京朝阳建国路88号”、“北京市朝阳区建外街道建国路88号”虽然指向同一地点，但在系统中被视为不同地址，就会导致订单合并困难、配送路径规划低效、用户画像不准等问题。地址归一化接口能够把这些不同表述归一为标准地址，有效解决这些问题。

此外，地址标准化还提供了以下高级能力：

多地址一致性判断：判断多个地址描述是否指向同一个地理位置。
地址异常诊断：检测地址中存在的异常信息。
地址POI类型识别：识别地址对应的POI（兴趣点）类型。
语音场景优化：针对语音场景提供专门优化，包括语音地址识别和对话上下文地址推理功能，可应用于语音导航、智能客服等场景。

八、计费方式与成本优化

8.1 计费模式

地址标准化采用灵活的计费方式，主要包括按量后付费和资源包预付费两种模式。

按量后付费：根据实际API调用次数计费，各接口有独立的单价。基础服务中，地址抽取是2.8元/千次，地址结构化是6元/千次。每个API接口默认提供500次的免费调用额度。免费额度用完后继续调用会产生后付费账单。默认QPS是10，如果当前QPS不够用，可以付费调整。

资源包预付费：适合调用量比较大的场景。中小企业如果调用量起伏较大，每月总调用量在2500万次以下，推荐购买流量资源包。资源包不限制API接口，同服务类型下各API接口共用次数，有效期从开通起算十二个月。中大企业如果固定使用一个或几个API接口，调用量较大且每月总调用量超过2500万次，建议考虑包月订阅来降低成本。

8.2 成本优化建议

在正式上线前，充分利用各接口500次的免费额度进行功能验证和压力测试。
根据实际业务调用量选择合适的计费方式，避免按量计费带来的成本波动。
关注控制台的数据监控，及时发现异常调用并采取措施。
如果有私有化部署需求，可以在官网点击“私有化版本咨询”，由售前人员提供定制方案。

九、常见问题与解决方案

问题1：调用接口时一直报错，是什么原因？

答：接口报错通常由以下几个原因引起：未开通服务或服务已欠费停服；AccessKey或AppKey配置错误；RAM用户未获得相应权限；请求参数格式不符合要求。建议先检查控制台的服务状态，确认账号未欠费，然后核对AccessKey和AppKey是否正确，最后检查RAM权限配置。如果问题仍然存在，可以根据错误码定位具体原因。

问题2：没有创建项目是否可以调用接口？

答：不可以。测试和调用功能接口前，必须在控制台创建项目。每个项目有独立的AppKey，用于API调用时的身份识别。

问题3：地址补全功能识别结果不准怎么办？

答：如果地址补全功能识别不准确，可以尝试使用门址标准化功能。门址标准化 = 地址纠错 + 地址补全，能同时对地址进行纠错和补全。如果补全结果中存在重复元素，可以在做地址文本拼接时筛去重复部分。此外，还可以通过定制干预管理对特定badcase进行修正。

问题4：地址标准化仅支持国内地址吗？

答：地址标准化主要面向国内地址提供纠错、补全、归一化等功能。如果涉及港澳台或海外特殊行政区划，建议在选型前进行充分测试。

问题5：各功能接口的免费额度是多少？

答：地址标准化基础服务接口和高级服务接口分别有500次的免费额度。各接口共享对应服务类型的免费额度，用尽后按后付费价格计费。

问题6：如何获取技术支持？

答：如有产品使用问题，可以加入官方钉钉群：35111738。如需私有化部署咨询，可在官网点击“私有化版本咨询”联系售前人员。

来源：https://developer.aliyun.com/article/1747521

标准化

延伸阅读

补充最近整理过的热点入口。