地址异常检测是指对用户输入的地址进行检测，判断地址是否为合法地址，并且对地址书写规范性、完整性、是否存在事实错误等进行检查，并输出地址的异常类型，如行政区划错误、路网信息不存在、村/社区不存在等。
测试
您可以在地址标准化产品控制台进行API测试。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | AddressAssessment | 系统规定参数。取值：AddressAssessment |
AppKey | String | 是 | Axqwerasdf1a | 项目AppKey |
ServiceCode | String | 是 | addrp | 固定值：addrp |
Text | String | 是 | 阿里巴巴西溪园区 | 文本内容 |
DefaultProvince | String | 否 | 浙江省 | 默认省份 |
DefaultCity | String | 否 | 杭州市 | 默认城市 |
DefaultDistrict | String | 否 | 余杭区 | 默认行政区 |
返回数据
名称 | 类型 | 示例值 | 描述 |
Data | String | {"address_assessment": {"error_code": "0102020204000000", "error_content": ["缺少信息，但不影响理解", "没有行政区划", "路名缺失", "缺少行政村"]}, "status": "OK", "time_used": { "rt": {"basic_chunking": 0.0172121524810791, "address_assessment": 0.0002608299255371094, "structure":0.0003032684326171875}, "start": 1669001158.3608806}} | address_assessment：地址异常检测结果 error_code：检测结果返回码，参考下方编码规则 error_content：检测结果返回码的文本解释，参考下方编码规则 time_used：算法处理耗时 status：状态 |
RequestId | String | E0627DDE-28D7-4C00-A611-E047DF81AF05 | RequestId |
示例
请求示例
http(s)://[Endpoint]/?Action=AddressAssessment
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=阿里巴巴西溪园区
&<公共请求参数>正常返回示例
XML格式
<RequestId>226BD68D-6208-4140-A6EC-2F2BF434B601</RequestId>
<Data>
<address_assessment>
<error_code>0102020204000000</error_code>
<error_content>缺少信息，但不影响理解</error_content>
<error_content>没有行政区划</error_content>
<error_content>路名缺失</error_content>
<error_content>缺少行政村</error_content>
</address_assessment>
<status>OK</status>
<time_used>
<rt>
<basic_chunking>0.0172121524810791</basic_chunking>
<address_assessment>0.0002608299255371094</address_assessment>
<structure>0.0003032684326171875</structure>
</rt>
<start>1669001158.3608806</start>
</time_used>
</Data>JSON格式
{
"RequestId": "226BD68D-6208-4140-A6EC-2F2BF434B601",
"Data": {
"address_assessment": {
"error_code": "0102020204000000",
"error_content": ["缺少信息，但不影响理解", "没有行政区划", "路名缺失", "缺少行政村"]
},
"status": "OK",
"time_used": {
"rt": {
"basic_chunking": 0.0172121524810791,
"address_assessment": 0.0002608299255371094,
"structure": 0.0003032684326171875
},
"start": 1669001158.3608806
}
}
}地址异常检测类型编码规则
返回码由16位数字组成
01 00 00 00 00 00 00 00
第1、2位表示返回码版本号，当前为01版本。
第3、4位表示问题大类。具体含义见下表 (50以内为不规范，50以上为异常、错误)。
第5、6位表示行政区划异常信息，具体含义见下表 (50以内为不规范，50以上为异常、错误)。
第7、8位表示路网信息异常信息，具体含义见下表。
第9、10位表示目标实体异常信息，具体含义见下表。
第11、12位表示目标地址详情异常信息，具体含义见下表。
第13、16位为预留部分，无含义。
检查部分 | 初级检查项 | 错误类型 | 高级检查项 | 错误码 |
问题大类 | 地址整体问题 | 00 正确 01 地址元素密度低 02 缺少信息，但不影响理解（包含缺少可补齐行政区划、只有路名+路号或poi其中之一，缺少详细地址） 03 地址范围过大，即缺乏行政村、社区以下级别内容 04 潜在冲突（多条道路、多个poi） 51 行政区划存在事实性错误，大类映射有问题。 52 目标地址存在事实性错误 | 无 | 无 |
行政区划 | 行政区划是否完整、行政区划是否正确（区分变迁、别名）、是否有冲突 | 00 正确 01 使用了旧的区划信息或别名（包括缩写） 02 没有行政区划 03 省级行政区划部分缺失（无法补齐） 04 地市级行政区划部分缺失（无法补齐） 05 区县级行政区划部分缺失（无法补齐） 06 乡镇级行政区划部分缺失（无法补齐） 51 行政区划冲突 52 省行政区划错误 (不存在) 53 市行政区划错误 (不存在) 54 区行政区划错误(不存在) 55 镇行政区划错误(不存在) | 无 | 无 |
路网信息 | 是否有路网信息、路号是否符合规则 | 00 正确 01 道路数量过多 02 路名缺失 03 路号缺失 04 路号异常 | 路名是否真实存在 | 51 路名不存在 52 路号不存在 |
目标实体信息 | 简单数量检查。是否多个poi、是否缺失 | 00 正确 01 多个poi 02 仅有无名POI 03 没有poi 04 缺少行政村 51 多个同级村名 52 缺少自然名 | 事实性检查。地名是否错别字、是否存在、poi是否相邻、poi与路名路号是否对应 | 53 地名不存在 54 poi与路名、路号不对应 |
目标地址详情 | 号码是否符合规则 | 01 出现重复元素 02 详细地址异常 | 号码是否存在 | 51 详细地址不存在 |
辅助信息 | 不做检查 | 无 | 无 | 无 |
非地址元素 | 不做检查 | 无 | 无 | 无 |
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
403 | Forbidden.NoAuth | Failed to perform user authentication. | 用户鉴权失败 |
500 | InternalError | A service error occurred. | 服务内部异常 |
400 | InvalidParameter | The parameter is invalid. | 参数无效 |
404 | ResourceDoesNotExist | The resource does not exist. | 资源不存在 |
429 | Throttling.User | Flow control has been triggered. | 触发流控 |
400 | UserStatusInvalid | The user status is invalid. | 用户状态无效 |
访问错误中心查看更多错误码。