本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 地址驗證
<a name="address-validation-concepts"></a>

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

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

## 地址驗證功能
<a name="address-validation-features"></a>

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

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

**增強型驗證**  
地址驗證任務支援可增強驗證結果的選用其他功能：  
+ **位置** — 傳回已驗證地址的地理座標 （經度和緯度），可讓您映射地址或執行地理分析。此功能僅適用於美國、加拿大和澳洲，並會產生額外費用。
+ **CountrySpecificAttributes** — 提供每個國家/地區的特定郵政系統資訊。例如，美國地址會收到 USPS 資料，例如交付點代碼和電信業者路由資訊，而澳洲地址會收到 Australia Post 識別符。
如需定價的詳細資訊，請參閱 [任務定價](jobs-pricing.md)。

## 地址驗證使用案例
<a name="address-validation-use-cases"></a>

**醫療保健系統和保險公司**  
驗證患者和提供者地址是否符合宣告處理、照護協調和法規報告要求。

**金融服務和保險公司**  
標準化客戶地址，以支援身分驗證工作流程、風險評估和詐騙預防。

**零售和電子商務營運**  
清理客戶資料庫，以減少運送失敗、改善交付費率，並最佳化履行成本。

**運輸和物流供應商**  
驗證路由最佳化的交付地址，並減少最後一哩操作的失敗交付。

**資料遷移和資料庫維護**  
在系統轉換期間執行一次性資料庫清除，並定期驗證地址記錄以維護資料品質。

**分析、報告和實體解析**  
透過實體解析工作流程，標準化以位置為基礎的分析、人口統計分析和客戶關係管理 (CRM) 資料庫清除的地址。

## 輸入結構描述
<a name="address-validation-input-schema"></a>

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

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

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 指令碼
<a name="address-validation-input-sample"></a>

下列 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')
```

如需檔案大小限制，請參閱 [準備輸入資料](preparing-input-data.md)。

## 輸出結構描述
<a name="address-validation-output-schema"></a>

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

如需一般輸出結構描述資訊以及如何擷取結果，請參閱 [擷取任務結果](retrieving-results.md)。

### 輸出地址欄位
<a name="output-address-fields"></a>

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

#### 輸出地址欄位的完整清單
<a name="output-address-fields-list"></a>

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  
樓層次要地址元件的識別符，如地址標籤所示。

### 地址中繼資料
<a name="address-metadata"></a>

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

Output\_AddressMetadata\_DeliveryIndicators\_Mailable  
指出地址是否可郵寄。值：`true`/`false`

Output\_AddressMetadata\_DeliveryIndicators\_Locatable  
指出地址是否可定位。值：`true`/`false`

### 驗證結果
<a name="validation-results"></a>

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

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 表示完美相符。

### 元件驗證狀態
<a name="component-validation-status"></a>

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

#### 元件驗證欄位對
<a name="component-validation-fields-list"></a>

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  
樓層元件的詳細驗證狀態。

### 其他功能輸出
<a name="additional-feature-output"></a>

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

#### 位置
<a name="position-output"></a>

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

Output\_Position\_Longitude  
World Geodetic System (WGS 84) 格式的經度座標。

Output\_Position\_Latitude  
World Geodetic System (WGS 84) 格式的緯度座標。

#### 國家/地區特定的屬性
<a name="country-specific-attributes"></a>

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

##### 澳洲
<a name="australia-attributes"></a>

##### AustraliaPost
<a name="australia-post"></a>

Output\_CountrySpecificAttributes\_AUS\_AustraliaPost\_DeliveryPointIdentifier  
Australia Post 開發的八位數代碼，可讓澳洲的每個交付點唯一識別。

##### 人口普查
<a name="australia-census"></a>

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

##### Gnaf
<a name="australia-gnaf"></a>

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) 欄位，代表普查中使用的地理區域。七位數的唯一代碼。

##### 加拿大
<a name="canada-attributes"></a>

##### CanadaPost
<a name="canada-post"></a>

Output\_CountrySpecificAttributes\_CAN\_CanadaPost\_BuildingType  
表示該建築物是商業建築物還是公寓建築物的程式碼。有效值為： `1` = 駐留， `2` = 商業。

Output\_CountrySpecificAttributes\_CAN\_CanadaPost\_RecordType  
定義地址查詢和文字查詢檔案中的記錄類型。值包括： `A1` （高層建築物）、 `B1` （大型磁碟區接收者）、 `C1`（政府地址）、 `D2`（由鎖定方塊提供的 LVR)、 `E2`（由鎖定方塊提供的政府）、 `F2`（由一般交付提供的 LVR)、 `11` （街道）、 `21`（由路由提供的街道）、 `32` (PO 方塊）。

##### 人口普查
<a name="canada-census"></a>

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' 前面。

##### 美國
<a name="usa-attributes"></a>

##### USPS
<a name="usa-usps"></a>

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)。

##### 人口普查
<a name="usa-census"></a>

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`)。

##### 英國
<a name="uk-attributes"></a>

##### RoyalMail
<a name="uk-royalmail"></a>

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 位數代碼。