地址驗證

地址驗證任務會處理地址資料，以驗證和標準化地址。此服務同時支援自由格式地址行和結構化地址元件，並且可以選擇性地使用地理座標和國家/地區特定的郵遞區號屬性來增強結果。

地址驗證支援來自下列國家/地區的地址：澳洲、加拿大、英國和美國。

地址驗證功能

地址驗證提供下列功能來驗證和增強地址資料：

地址標準化

地址驗證會針對授權地址資料集進行檢查，以驗證地址是否存在且可交付。地址標準化格式根據官方郵政標準來設定地址，例如一致的縮寫、大寫和標點符號。它也可以修正拼字錯誤等錯誤，並新增缺少的地址元件，例如郵遞區號和街道名稱。

增強型驗證

地址驗證任務支援可增強驗證結果的選用其他功能：

位置 — 傳回已驗證地址的地理座標（經度和緯度），可讓您映射地址或執行地理分析。此功能僅適用於美國、加拿大和澳洲，並會產生額外費用。
CountrySpecificAttributes — 提供每個國家/地區的特定郵政系統資訊。例如，美國地址會收到 USPS 資料，例如交付點代碼和電信業者路由資訊，而澳洲地址會收到 Australia Post 識別符。

如需定價的詳細資訊，請參閱任務定價。

地址驗證使用案例

醫療保健系統和保險公司: 驗證患者和提供者地址是否符合宣告處理、照護協調和法規報告要求。
金融服務和保險公司: 標準化客戶地址，以支援身分驗證工作流程、風險評估和詐騙預防。
零售和電子商務營運: 清理客戶資料庫，以減少運送失敗、改善交付費率，並最佳化履行成本。
運輸和物流供應商: 驗證路由最佳化的交付地址，並減少最後一哩操作的失敗交付。
資料遷移和資料庫維護: 在系統轉換期間執行一次性資料庫清除，並定期驗證地址記錄以維護資料品質。
分析、報告和實體解析: 透過實體解析工作流程，標準化以位置為基礎的分析、人口統計分析和客戶關係管理 (CRM) 資料庫清除的地址。

輸入結構描述

地址驗證任務需要具有特定結構描述的輸入資料。結構描述支援自由格式地址行和結構化地址元件，可讓您以最符合您資料的格式提交地址。

輸入結構描述包含下列欄位：

Id: 要提供給此輸入記錄的選用識別符。如果提供，它會鏡像在輸出檔案中Input_Id，以協助您建立輸出記錄與其對應輸入的關聯。
地址行: 使用 AddressLines_1 到 AddressLines_5以取得自由格式的地址。在中輸入單行輸入AddressLines_1。根據區域郵政規則訂購多行輸入，如同郵件所示。
AddressComponents_Country: 地址所在的國家/地區的 alpha-2、alpha-3 字元碼或全名。
AddressComponents_Region: 輸入地址的區域，例如狀態、省或區域。
AddressComponents_SubRegion: 輸入地址的子區域，例如郡。
AddressComponents_Locality: 輸入地址的地區性，例如城市或城市。
AddressComponents_PostalCode: 輸入地址的郵遞區號。
AddressComponents_Street: 輸入地址的街道名稱。
AddressComponents_AddressNumber: 輸入地址的地址或房屋號碼。
AddressComponents_Unit: 輸入地址的單位。
AddressComponents_UnitDesignator: 輸入地址的單位名稱或類型，例如 Apt、 Suite 或 #。

注意

在請求中同時結合 AddressLines 和 AddressComponents 時，請在 AddressLines 中輸入一行地址元件 (AddressNumber、 Street、 Unit 和 UnitDesignator)。透過 AddressComponents 輸入最後一行元件（本機、區域、SubRegion、國家/地區和PostalCode)。

下列 Python 指令碼會使用地址資料建立範例 Parquet 檔案：


import pyarrow as pa
import pyarrow.parquet as pq

data = [
    {
        "Id": "record-001",
        "AddressLines_1": "Pike Place",
        "AddressLines_2": "Apartment 4B",
        "AddressLines_3": None,
        "AddressLines_4": None,
        "AddressLines_5": None,
        "AddressComponents_Country": "USA",
        "AddressComponents_Region": None,
        "AddressComponents_SubRegion": None,
        "AddressComponents_Locality": None,
        "AddressComponents_PostalCode": "98101",
        "AddressComponents_Street": None,
        "AddressComponents_AddressNumber": None,
        "AddressComponents_Unit": None,
        "AddressComponents_UnitDesignator": None
    },
    {
        "Id": "record-002",
        "AddressLines_1": "2901 E Madison St",
        "AddressLines_2": None,
        "AddressLines_3": None,
        "AddressLines_4": None,
        "AddressLines_5": None,
        "AddressComponents_Country": "USA",
        "AddressComponents_Region": None,
        "AddressComponents_SubRegion": None,
        "AddressComponents_Locality": None,
        "AddressComponents_PostalCode": "98112",
        "AddressComponents_Street": None,
        "AddressComponents_AddressNumber": None,
        "AddressComponents_Unit": None,
        "AddressComponents_UnitDesignator": None
    }
]

schema = pa.schema([
    ("Id", pa.string()),
    ("AddressLines_1", pa.string()),
    ("AddressLines_2", pa.string()),
    ("AddressLines_3", pa.string()),
    ("AddressLines_4", pa.string()),
    ("AddressLines_5", pa.string()),
    ("AddressComponents_Country", pa.string()),
    ("AddressComponents_Region", pa.string()),
    ("AddressComponents_SubRegion", pa.string()),
    ("AddressComponents_Locality", pa.string()),
    ("AddressComponents_PostalCode", pa.string()),
    ("AddressComponents_Street", pa.string()),
    ("AddressComponents_AddressNumber", pa.string()),
    ("AddressComponents_Unit", pa.string()),
    ("AddressComponents_UnitDesignator", pa.string())
])

table = pa.Table.from_pylist(data, schema=schema)
pq.write_table(table, 'addresses.parquet')

如需檔案大小限制，請參閱準備輸入資料。

輸出結構描述

地址驗證任務會產生輸出，其中包含標準化地址元件、驗證結果和選用的額外功能資料。下列各節說明地址驗證特定的輸出欄位。

如需一般輸出結構描述資訊以及如何擷取結果，請參閱擷取任務結果。

輸出地址欄位

具有 Output_字首的標準化地址元件，根據區域郵政規則格式化。

Output_AddressId: 傳回地址的唯一識別符。
Output_AddressLines_1: 完整傳回地址的第一行寫在多行上，因為它應該出現在一封郵件上。根據區域郵遞區號規則格式化。
Output_AddressLines_2: 完整傳回地址的第二行寫在多行上，因為它應該出現在一封郵件上。根據區域郵遞區號規則格式化。
Output_AddressLines_3: 完整傳回地址的第三行寫在多行上，應該會顯示在一封郵件上。根據區域郵遞區號規則格式化。
Output_AddressLines_4: 完整傳回地址的第四行寫在多行上，因為它應該出現在一封郵件上。根據區域郵遞區號規則格式化。
Output_AddressLines_5: 完整傳回地址的第 5 行寫在多行上，應該會顯示在一封郵件上。根據區域郵遞區號規則格式化。
Output_Address_Label: 根據區域郵遞區號規則，從地址元件建置的組合地址。
Output_Address_Country_Code2: 國家/地區的 Alpha-2 字元碼。
Output_Address_Country_Code3: 國家/地區的 Alpha-3 字元碼。
Output_Address_Country_Name: 國家/地區的全名。
Output_Address_Region_Code: 區域的縮寫程式碼。
Output_Address_Region_Name: 區域的全名。
Output_Address_SubRegion_Code: 子區域的縮寫程式碼。
Output_Address_SubRegion_Name: 子區域的完整名稱。
Output_Address_Locality: 地址的地區性元件，例如城市或城市。
Output_Address_PostalCode: 地址的完整郵遞區號元件。
Output_Address_PostalCodeDetails_Base: 郵遞區號的基本區段。
Output_Address_PostalCodeDetails_Extension: 郵遞區號的延伸或附加元件區段。
Output_Address_Street: 地址的完整街道元件。
Output_Address_StreetComponents_BaseName: 街道名稱的基本名稱部分。
Output_Address_StreetComponents_字首: 位於道路基本名稱前面但未包含在其中的方向識別符。
Output_Address_StreetComponents_Suffix: 道路基本名稱後面但不包含的方向識別符。
Output_Address_StreetComponents_Type: 街道名稱的街道類型部分，例如 ST、AVE、BLVD。
Output_Address_StreetComponents_TypePlacement: 定義街道類型是在基本名稱之前或之後。(BeforeBaseName 或 AfterBaseName)
Output_Address_AddressNumber: 地址的地址或門牌號碼元件。
Output_Address_SecondaryAddressComponents_Unit_Number: 單位次要地址元件的英數字元識別符。
Output_Address_SecondaryAddressComponents_Unit_Designator: 單位次要地址元件的代號，如地址標籤所示。
Output_Address_SecondaryAddressComponents_Floor_Number: 樓層次要地址元件的英數字元識別符。
Output_Address_SecondaryAddressComponents_Floor_Designator: 樓層次要地址元件的識別符，如地址標籤所示。

地址中繼資料

有關地址和交付特性的中繼資料。

Output_AddressMetadata_DeliveryIndicators_Mailable: 指出地址是否可郵寄。值：true/false
Output_AddressMetadata_DeliveryIndicators_Locatable: 指出地址是否可定位。值：true/false

驗證結果

地址的整體驗證品質指標。

Output_ValidationResults_ValidationGranularity

指出已驗證傳回地址的整體精細程度。數值：

Premise – 已驗證地址號碼層級的所有元件
Street – 已驗證街道層級的所有元件
LocalityAndPostalCode – 已驗證 Locality、PostalCode 和 Country
Locality – 已驗證地區和國家

Output_ValidationResults_MatchConfidence

指出地址驗證程序期間所執行之地址比對的整體可信度。值：High、MediumHigh、Medium、MediumLow、Low

Output_ValidationResults_MatchConfidenceScore

提供配對可信度的精確分數。範圍從 0 到 1.0，1.0 表示完美相符。

元件驗證狀態

對於每個地址元件，兩個欄位表示驗證結果：

Status 欄位表示驗證狀態： Validated或 Unconfirmed
StatusDetail 欄位提供有關驗證狀態的其他詳細資訊：
- NotFound – 找不到元件或為空。
- StandardizedNoMatch – 元件已剖析並標準化，但未在參考資料中識別。
- OutOfRange – 未識別元件，參考資料顯示元件超出範圍或未知。
- Corrected – 已使用參考資料修正元件。
- Exact – 元件已驗證，無需變更。
- Alias – 元件已使用參考資料別名進行驗證。
- Appended – 使用參考資料附加元件。

Output_ValidationResults_Components_Address_Country_Status: 國家/地區元件的驗證狀態。
Output_ValidationResults_Components_Address_Country_StatusDetail: 國家/地區元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_Region_Status: 區域元件的驗證狀態。
Output_ValidationResults_Components_Address_Region_StatusDetail: 區域元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_Locality_Status: 地區性元件的驗證狀態。
Output_ValidationResults_Components_Address_Locality_StatusDetail: 地區性元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_Street_Status: 街道元件的驗證狀態。
Output_ValidationResults_Components_Address_Street_StatusDetail: 街道元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_AddressNumber_Status: 地址號碼元件的驗證狀態。
Output_ValidationResults_Components_Address_AddressNumber_StatusDetail: 地址號碼元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_PostalCodeDetails_Base_Status: 郵遞區號基本元件的驗證狀態。
Output_ValidationResults_Components_Address_PostalCodeDetails_Base_StatusDetail: 郵遞區號基本元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_PostalCodeDetails_Extension_Status: 郵遞區號延伸元件的驗證狀態。
Output_ValidationResults_Components_Address_PostalCodeDetails_Extension_StatusDetail: 郵遞區號延伸元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_SecondaryAddressComponents_Unit_Status: 單位元件的驗證狀態。
Output_ValidationResults_Components_Address_SecondaryAddressComponents_Unit_StatusDetail: 單位元件的詳細驗證狀態。
Output_ValidationResults_Components_Address_SecondaryAddressComponents_Floor_Status: 落地元件的驗證狀態。
Output_ValidationResults_Components_Address_SecondaryAddressComponents_Floor_StatusDetail: 樓層元件的詳細驗證狀態。

其他功能輸出

如果您在啟動任務時請求其他功能，輸出會包括：

位置

World Geodetic System (WGS 84) 格式的地理座標。

Output_Position_Longitude: World Geodetic System (WGS 84) 格式的經度座標。
Output_Position_Latitude: World Geodetic System (WGS 84) 格式的緯度座標。

國家/地區特定的屬性

國家/地區特定的郵遞區號和人口普查資料。可用欄位因國家/地區而異。

AustraliaPost

Output_CountrySpecificAttributes_AUS_AustraliaPost_DeliveryPointIdentifier: Australia Post 開發的八位數代碼，可讓澳洲的每個交付點唯一識別。

人口普查

Output_CountrySpecificAttributes_AUS_Census_MeshBlockId: 網格區塊是 ABS 定義的最小地理區域，並構成澳洲統計地理標準 (ASGS) 較大區域的建置區塊。它們廣泛識別土地使用，例如住所、商業、主要生產和園區。

Gnaf

Output_CountrySpecificAttributes_AUS_Gnaf_AddressClass: 使用地址元素組合建構的地址類別。值包括： A(Alias)、 P (Principal)、 PP(Principal Primary)、 PS(Principal Secondary)、 AP(Alias Primary)、 AS(Alias Secondary)。
Output_CountrySpecificAttributes_AUS_Gnaf_GnafPid: 持久性識別符對於此記錄代表的真實世界特徵是唯一的。持久性識別符 (PID) 是 14 個字元的英數字串，可唯一識別每個 G-NAF 地址。
Output_CountrySpecificAttributes_AUS_Gnaf_LegalParcelId: G-NAF 中的此欄位旨在保留與特定地址相關聯之土地包裹的唯一識別符。包裹 ID，代表計畫上的批次描述。供政府機構使用。格式有所不同。
Output_CountrySpecificAttributes_AUS_Gnaf_StatisticalArea1: 從整個網格區塊建置的地理區域。整個 SA1s彙總以形成統計區域層級 2 (SA2s)。統計區域層級 1 (SA1) 欄位，代表普查中使用的地理區域。七位數的唯一代碼。

CanadaPost

Output_CountrySpecificAttributes_CAN_CanadaPost_BuildingType: 表示該建築物是商業建築物還是公寓建築物的程式碼。有效值為： 1 = 駐留， 2 = 商業。
Output_CountrySpecificAttributes_CAN_CanadaPost_RecordType: 定義地址查詢和文字查詢檔案中的記錄類型。值包括： A1 （高層建築物）、 B1 （大型磁碟區接收者）、 C1（政府地址）、 D2（由鎖定方塊提供的 LVR)、 E2（由鎖定方塊提供的政府）、 F2（由一般交付提供的 LVR)、 11 （街道）、 21（由路由提供的街道）、 32 (PO 方塊）。

人口普查

Output_CountrySpecificAttributes_CAN_Census_DisseminationArea: 唯一識別傳播區域。它由兩位數的省或區域代碼、兩位數的人口普查分割代碼和四位數的傳播區域代碼組成。
Output_CountrySpecificAttributes_CAN_Census_Division: 唯一識別人口普查分。CDuid 的前兩位數識別省或區域 (PR)。
Output_CountrySpecificAttributes_CAN_Census_MetropolitanArea: 由一或多個以人口中心（稱為核心）為中心的相鄰城市組成。
Output_CountrySpecificAttributes_CAN_Census_Subdivision: 唯一識別國家/地區的人口普查子區。省/區域、人口普查部門和人口普查子部門（城市）代碼結合在一起，代表標準地理分類 (SGC)。
Output_CountrySpecificAttributes_CAN_Census_Tract: 識別 CMA/CA 內的人口普查管道。若要唯一識別其對應人口普查都會區中的每個人口普查管道，或牽引人口普查彙總，三位數 CMA/CA 程式碼必須在人口普查管道 'name' 前面。

USPS

Output_CountrySpecificAttributes_USA_Usps_CarrierRoute: 郵遞區號中的一組郵寄地址，USPS 會將其分組在一起，讓郵件交付程序更有效率。與郵遞區號將國家/地區劃分為不同區域的方式相同，電信業者路由會將這些郵遞區號劃分。
Output_CountrySpecificAttributes_USA_Usps_DefaultFlag: 表示處理的記錄已取得 ZIP + 4 產品中高聳、農村路線或街道預設記錄的相符項目。 Y- 預設標記指標已設定，N或空白 - 可接受。
Output_CountrySpecificAttributes_USA_Usps_DeliveryPoint_Barcode: 房屋/箱的 2 位數交付點。
Output_CountrySpecificAttributes_USA_Usps_DeliveryPoint_CheckDigit: 新增至 DPBC 中其他數字總和的數字，以產生 10 的倍數。
Output_CountrySpecificAttributes_USA_Usps_Elot_AscendingDescendingFlag: 遞增/遞減程式碼表示序號內的大致交付順序。
Output_CountrySpecificAttributes_USA_Usps_Elot_SequenceNumber: 增強型行 (eLOT) 序號，可協助郵件者以符合電信業者交付路徑的方式排序郵件。指出第一次對電信業者路由內的附加元件範圍進行交付。
Output_CountrySpecificAttributes_USA_Usps_NonDeliverableRecord: 階段 I 檔案上的欄位表示地址測試問題與 ZIP + 4® 產品上的記錄有效相符。不過，會比對無法交付 (ND) 類型的記錄。 Y- 記錄是 ND 類型，空白 - 記錄不是 ND 類型。
Output_CountrySpecificAttributes_USA_Usps_PoBoxOnlyFlag: 城市狀態產品有一部分包含僅限郵政信箱的交付區域。檔案配置會利用 P做為著作權詳細資訊代碼，這與現有的 ZIP 不同。P 分類代碼位於城市州詳細資訊記錄的第十三 (13) 個位置，指出有郵政信箱和其他類型的交付到社群。這些區域沒有其他形式的郵政遞送。
Output_CountrySpecificAttributes_USA_Usps_RecordType: 符合輸入地址的地址記錄類型，例如公司 (F) 一般交付 (G) Highrise (H) P.O. Box (P) Rural Route (R) 或街道記錄 ()S。
Output_CountrySpecificAttributes_USA_Usps_RuralRouteDefault: 表示農村路由相符。 Y - 地址符合農村路由記錄。 N或空白 - 地址不符合農村路由記錄。
Output_CountrySpecificAttributes_USA_Usps_Urbanization: 波多黎各城市化名稱。
Output_CountrySpecificAttributes_USA_Usps_ZipValid: 代表有效郵遞區號的 true/false 旗標。指出地址記錄是否可以新增至表單 3553。五位數驗證需要城市狀態和郵遞區號的最後一行值彼此對應。
Output_CountrySpecificAttributes_USA_Usps_Zip10: 具有破折號分隔符號的 10 位數郵遞區號 (ZIP + 4)。
Output_CountrySpecificAttributes_USA_Usps_Zip9: 9 位數郵遞區號 (ZIP + 4)。

人口普查

Output_CountrySpecificAttributes_USA_Census_BlockId: 2020 年人口普查區塊 ID。
Output_CountrySpecificAttributes_USA_Census_CombinedStatisticalArea_Number: 合併統計區域 (CSA) 號碼。
Output_CountrySpecificAttributes_USA_Census_CombinedStatisticalArea_Name: 合併統計區域 (CSA) 名稱。
Output_CountrySpecificAttributes_USA_Census_CoreBasedStatisticalArea_Number: 核心型統計區域 (CBSA) 號碼。
Output_CountrySpecificAttributes_USA_Census_CoreBasedStatisticalArea_Name: 地址所在的核心型統計區域 (CBSA) 名稱。
Output_CountrySpecificAttributes_USA_Census_CountyFipsCode: 郡 FIPS 代碼。
Output_CountrySpecificAttributes_USA_Census_MetropolitanAreaFlag: 指出地址所在的核心型統計區域 (CBSA) 是都會區域還是微型區域 (Y/N)。

RoyalMail

Output_CountrySpecificAttributes_GBR_RoyalMail_SubBuilding: 地址的子建置名稱和/或識別符。
Output_CountrySpecificAttributes_GBR_RoyalMail_ThoroughfareName: 地址的街道或周遊的基本名稱。
Output_CountrySpecificAttributes_GBR_RoyalMail_DependentThoroughfareName: 地址的雙相依周遊費。當其他具名的 thoroughfares 中有具名的 thoroughfares 時，就會使用此值。
Output_CountrySpecificAttributes_GBR_RoyalMail_DependentLocality: 地址的相依地區。當地區內存在具有相同或類似名稱的 thoroughfares 時，就會使用此值。
Output_CountrySpecificAttributes_GBR_RoyalMail_DoubleDependentLocality: 地址的雙相依地區。當相依位置中有多個具有相同或類似名稱的 thoroughfares 時，就會使用此值。
Output_CountrySpecificAttributes_GBR_RoyalMail_OrganizationName: 在地址註冊的組織名稱。
Output_CountrySpecificAttributes_GBR_RoyalMail_Udprn: 唯一交付點參考號碼 (UDPRN) 是由 Royal Mail 指派給英國地址的唯一 8 位數代碼。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

錯誤處理

任務 APIs