多地址相似性判断

通过对两条输入地址文本,判断其是否为同一地址,并对其相似性进行打分,针对不同部分片段返回输入文本的最细粒度相同层级及两个地址的基于经纬度点的距离。

测试

您可以在地址标准化产品控制台进行API测试

请求参数

名称

类型

是否必选

示例值

描述

Action

String

GetAddressSimilarity

系统规定参数。取值:GetAddressSimilarity。

AppKey

String

Axqwerasdf1a

项目AppKey

ServiceCode

String

addrp

固定值:addrp

Text

String

杭州市阿里巴巴西溪园区;杭州市文一西路969号1号楼

待处理的两段地址文本,需要英文分号“;”作为分隔符

DefaultProvince

String

浙江省

默认省份

DefaultCity

String

杭州市

默认城市

DefaultDistrict

String

余杭区

默认行政区

返回数据

名称

类型

示例值

描述

Data

String

{"sim_level":{"level":"none","address_a":"杭州市阿里巴巴西溪园区",

"address_b":"杭州市文一西路969号1号楼",

"is_same":false,

"same_info":"prov=浙江省 city=杭州市 district=余杭区 town=五常街道 road=北侧道路 poi=阿里巴巴西溪园区"}

"time_used":{"rt":{"sim_level":"0.415966272354126"},"start":"1665298648.3907936"},"status": "OK"}

sim_level:地址相似层级判定结果

level:最细颗粒度的相似层级

same_info:表示输入两个地址的相同部分信息

address_a:输入的前一条地址的原始文本

address_b:输入的后一条地址的原始文本

is_same:判断是否为同一地址

time_used:算法处理耗时

status:状态

RequestId

String

F1BD3BD6-3510-4144-996A-B7FCA70A5F81

RequestId

示例

请求示例

http(s)://[Endpoint]/?Action=GetAddressSimilarity
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=杭州市阿里巴巴西溪园区;杭州市文一西路969号1号楼
&<公共请求参数>

正常返回示例

XML格式

<RequestId>F1BD3BD6-3510-4144-996A-B7FCA70A5F81</RequestId>
<Data>
<sim_level>
<level>none</level>
<address_a>杭州市阿里巴巴西溪园区</address_a>
<address_b>杭州市文一西路969号1号楼</address_b>
<is_same>false</is_same>
<same_info>prov=浙江省 city=杭州市 district=余杭区 town=五常街道 road=北侧道路 poi=阿里巴巴西溪园区</same_info>
</sim_level>
<time_used>
<rt>
<sim_level>0.415966272354126</sim_level>
</rt>
<start>1665298648.3907936</start>
</time_used>
<status>OK</status>
</Data>

JSON格式

{
  "RequestId": "F1BD3BD6-3510-4144-996A-B7FCA70A5F81",
  "Data": {
    "sim_level": {
      "level": "none",
      "address_a": "杭州市阿里巴巴西溪园区",
      "address_b": "杭州市文一西路969号1号楼",
      "is_same": false
      "same_info": "prov=浙江省 city=杭州市 district=余杭区 town=五常街道 road=北侧道路 poi=阿里巴巴西溪园区"
    },
    "time_used": {
      "rt": {
        "sim_level": "0.415966272354126"
      },
      "start": "1665298648.3907936"
    },
    "status": "OK"
  }
}

错误码

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.

用户状态无效

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