門址標準化是指對用戶原始地址,包括缺省地址信息進行補全,同時對行政區劃(省/市/區/街道)及路名、路號等錯誤信息,修改成正確結果,從而對標準地名信息的規范標準化的服務。
測試
您可以在地址標準化產品控制臺進行API測試。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | StreetStd | 系統規定參數。取值: StreetStd |
AppKey | String | 是 | Axqwerasdf1a | 項目AppKey |
ServiceCode | String | 是 | addrp | 固定值:addrp |
Text | String | 是 | 文一西路969號阿里巴巴西溪園區 | 文本內容 |
DefaultProvince | String | 否 | 浙江省 | 默認省份 |
DefaultCity | String | 否 | 杭州市 | 默認城市 |
DefaultDistrict | String | 否 | 余杭區 | 默認行政區 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
Data | String | {"street_std":"prov=浙江省\tcity=杭州市\tdistrict=余杭區\ttown=五常街道\troad=文一西路\troadno=969號\poi=阿里巴巴西溪園區", "status":"OK", "time_used":{"rt":{"basic_chunking":0.010355472564697266, "StreetStd":0.0001628398895263672,"segment":0.0003783702850341797, "address_correct":0.0030519962310791016, "address_search":0.12972450256347656, "structure":0.000080108642578125},"start":1675067580.6475735} | street_std:門址標準化結果 struct:地址結構化信息 time_used:算法處理耗時 status:狀態 |
RequestId | String | 3A9AB010-AC38-4E53-9D25-6B97238C2897 | RequestId |
示例
請求示例
http(s)://[Endpoint]/?Action=StreetStd
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=文一西路969號阿里巴巴西溪園區
&<公共請求參數>
正常返回示例
XML格式
<RequestId>3A9AB010-AC38-4E53-9D25-6B97238C2897</RequestId>
<Data>
<street_std>prov=浙江省 city=杭州市 district=余杭區 town=五常街道 road=文一西路 roadno=969號</street_std>
<status>OK</status>
<time_used>
<rt>
<basic_chunking>0.010355472564697266</basic_chunking>
<street_std>0.0001628398895263672</street_std>
<segment>0.0003783702850341797</segment>
<address_correct>0.0030519962310791016</address_correct>
<address_search>0.12972450256347656</address_search>
<structure>0.000080108642578125</structure>
</rt>
<start>1675067580.6475735</start>
</time_used>
</Data>
JSON格式
{
"RequestId": "3A9AB010-AC38-4E53-9D25-6B97238C2897",
"Data": {
"street_std":"prov=浙江省\tcity=杭州市\tdistrict=余杭區\ttown=五常街道\troad=文一西路\troadno=969號",
"status":"OK",
"time_used":{
"rt":{
"basic_chunking":0.010355472564697266,
"street_std":0.0001628398895263672,
"segment":0.0003783702850341797,
"address_correct":0.0030519962310791016,
"address_search":0.12972450256347656,
"structure":0.000080108642578125
},
"start":1675067580.6475735
}
}
}
錯誤碼
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. | 用戶狀態無效 |
訪問錯誤中心查看更多錯誤碼。