文档

地址异常检测

更新时间:

地址异常检测是指对用户输入的地址进行检测,判断地址是否为合法地址,并且对地址书写规范性、完整性、是否存在事实错误等进行检查,并输出地址的异常类型,如行政区划错误、路网信息不存在、村/社区不存在等。

测试

您可以在地址标准化产品控制台进行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.

用户状态无效

访问错误中心查看更多错误码。

  • 本页导读 (0)