地址異常檢測(cè)
地址異常檢測(cè)是指對(duì)用戶輸入的地址進(jìn)行檢測(cè)，判斷地址是否為合法地址，并且對(duì)地址書寫規(guī)范性、完整性、是否存在事實(shí)錯(cuò)誤等進(jìn)行檢查，并輸出地址的異常類型，如行政區(qū)劃錯(cuò)誤、路網(wǎng)信息不存在、村/社區(qū)不存在等。
測(cè)試
您可以在地址標(biāo)準(zhǔn)化產(chǎn)品控制臺(tái)進(jìn)行API測(cè)試。
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | AddressAssessment | 系統(tǒng)規(guī)定參數(shù)。取值：AddressAssessment |
AppKey | String | 是 | Axqwerasdf1a | 項(xiàng)目AppKey |
ServiceCode | String | 是 | addrp | 固定值：addrp |
Text | String | 是 | 阿里巴巴西溪園區(qū) | 文本內(nèi)容 |
DefaultProvince | String | 否 | 浙江省 | 默認(rèn)省份 |
DefaultCity | String | 否 | 杭州市 | 默認(rèn)城市 |
DefaultDistrict | String | 否 | 余杭區(qū) | 默認(rèn)行政區(qū) |
返回?cái)?shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
Data | String | {"address_assessment": {"error_code": "0102020204000000", "error_content": ["缺少信息，但不影響理解", "沒(méi)有行政區(qū)劃", "路名缺失", "缺少行政村"]}, "status": "OK", "time_used": { "rt": {"basic_chunking": 0.0172121524810791, "address_assessment": 0.0002608299255371094, "structure":0.0003032684326171875}, "start": 1669001158.3608806}} | address_assessment：地址異常檢測(cè)結(jié)果 error_code：檢測(cè)結(jié)果返回碼，參考下方編碼規(guī)則 error_content：檢測(cè)結(jié)果返回碼的文本解釋，參考下方編碼規(guī)則 time_used：算法處理耗時(shí) status：狀態(tài) |
RequestId | String | E0627DDE-28D7-4C00-A611-E047DF81AF05 | RequestId |
示例
請(qǐng)求示例
http(s)://[Endpoint]/?Action=AddressAssessment
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=阿里巴巴西溪園區(qū)
&<公共請(qǐng)求參數(shù)>正常返回示例
XML格式
<RequestId>226BD68D-6208-4140-A6EC-2F2BF434B601</RequestId>
<Data>
<address_assessment>
<error_code>0102020204000000</error_code>
<error_content>缺少信息，但不影響理解</error_content>
<error_content>沒(méi)有行政區(qū)劃</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": ["缺少信息，但不影響理解", "沒(méi)有行政區(qū)劃", "路名缺失", "缺少行政村"]
},
"status": "OK",
"time_used": {
"rt": {
"basic_chunking": 0.0172121524810791,
"address_assessment": 0.0002608299255371094,
"structure": 0.0003032684326171875
},
"start": 1669001158.3608806
}
}
}地址異常檢測(cè)類型編碼規(guī)則
返回碼由16位數(shù)字組成
01 00 00 00 00 00 00 00
第1、2位表示返回碼版本號(hào)，當(dāng)前為01版本。
第3、4位表示問(wèn)題大類。具體含義見(jiàn)下表 (50以內(nèi)為不規(guī)范，50以上為異常、錯(cuò)誤)。
第5、6位表示行政區(qū)劃異常信息，具體含義見(jiàn)下表 (50以內(nèi)為不規(guī)范，50以上為異常、錯(cuò)誤)。
第7、8位表示路網(wǎng)信息異常信息，具體含義見(jiàn)下表。
第9、10位表示目標(biāo)實(shí)體異常信息，具體含義見(jiàn)下表。
第11、12位表示目標(biāo)地址詳情異常信息，具體含義見(jiàn)下表。
第13、16位為預(yù)留部分，無(wú)含義。
檢查部分 | 初級(jí)檢查項(xiàng) | 錯(cuò)誤類型 | 高級(jí)檢查項(xiàng) | 錯(cuò)誤碼 |
問(wèn)題大類 | 地址整體問(wèn)題 | 00 正確 01 地址元素密度低 02 缺少信息，但不影響理解（包含缺少可補(bǔ)齊行政區(qū)劃、只有路名+路號(hào)或poi其中之一，缺少詳細(xì)地址） 03 地址范圍過(guò)大，即缺乏行政村、社區(qū)以下級(jí)別內(nèi)容 04 潛在沖突（多條道路、多個(gè)poi） 51 行政區(qū)劃存在事實(shí)性錯(cuò)誤，大類映射有問(wèn)題。 52 目標(biāo)地址存在事實(shí)性錯(cuò)誤 | 無(wú) | 無(wú) |
行政區(qū)劃 | 行政區(qū)劃是否完整、行政區(qū)劃是否正確（區(qū)分變遷、別名）、是否有沖突 | 00 正確 01 使用了舊的區(qū)劃信息或別名（包括縮寫） 02 沒(méi)有行政區(qū)劃 03 省級(jí)行政區(qū)劃部分缺失（無(wú)法補(bǔ)齊） 04 地市級(jí)行政區(qū)劃部分缺失（無(wú)法補(bǔ)齊） 05 區(qū)縣級(jí)行政區(qū)劃部分缺失（無(wú)法補(bǔ)齊） 06 鄉(xiāng)鎮(zhèn)級(jí)行政區(qū)劃部分缺失（無(wú)法補(bǔ)齊） 51 行政區(qū)劃沖突 52 省行政區(qū)劃錯(cuò)誤 (不存在) 53 市行政區(qū)劃錯(cuò)誤 (不存在) 54 區(qū)行政區(qū)劃錯(cuò)誤(不存在) 55 鎮(zhèn)行政區(qū)劃錯(cuò)誤(不存在) | 無(wú) | 無(wú) |
路網(wǎng)信息 | 是否有路網(wǎng)信息、路號(hào)是否符合規(guī)則 | 00 正確 01 道路數(shù)量過(guò)多 02 路名缺失 03 路號(hào)缺失 04 路號(hào)異常 | 路名是否真實(shí)存在 | 51 路名不存在 52 路號(hào)不存在 |
目標(biāo)實(shí)體信息 | 簡(jiǎn)單數(shù)量檢查。是否多個(gè)poi、是否缺失 | 00 正確 01 多個(gè)poi 02 僅有無(wú)名POI 03 沒(méi)有poi 04 缺少行政村 51 多個(gè)同級(jí)村名 52 缺少自然名 | 事實(shí)性檢查。地名是否錯(cuò)別字、是否存在、poi是否相鄰、poi與路名路號(hào)是否對(duì)應(yīng) | 53 地名不存在 54 poi與路名、路號(hào)不對(duì)應(yīng) |
目標(biāo)地址詳情 | 號(hào)碼是否符合規(guī)則 | 01 出現(xiàn)重復(fù)元素 02 詳細(xì)地址異常 | 號(hào)碼是否存在 | 51 詳細(xì)地址不存在 |
輔助信息 | 不做檢查 | 無(wú) | 無(wú) | 無(wú) |
非地址元素 | 不做檢查 | 無(wú) | 無(wú) | 無(wú) |
錯(cuò)誤碼
HttpCode | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
403 | Forbidden.NoAuth | Failed to perform user authentication. | 用戶鑒權(quán)失敗 |
500 | InternalError | A service error occurred. | 服務(wù)內(nèi)部異常 |
400 | InvalidParameter | The parameter is invalid. | 參數(shù)無(wú)效 |
404 | ResourceDoesNotExist | The resource does not exist. | 資源不存在 |
429 | Throttling.User | Flow control has been triggered. | 觸發(fā)流控 |
400 | UserStatusInvalid | The user status is invalid. | 用戶狀態(tài)無(wú)效 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。