通過對兩條輸入地址文本，判斷其是否為同一地址，并對其相似性進行打分，針對不同部分片段返回輸入文本的最細粒度相同層級及兩個地址的基于經緯度點的距離。
測試
您可以在地址標準化產品控制臺進行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. | 用戶狀態無效 |
訪問錯誤中心查看更多錯誤碼。