通过对两条输入地址文本,判断其是否为同一地址,并对其相似性进行打分,针对不同部分片段返回输入文本的最细粒度相同层级及两个地址的基于经纬度点的距离。
测试
您可以在地址标准化产品控制台进行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. | 用户状态无效 |
访问错误中心查看更多错误码。