本文件涵蓋美國特有的地址驗證：
- 在工作流程中使用 USPS 資料
- USPS 交付點驗證欄位 (dpv)
- 安全性訊息
在工作流程中使用 USPS 資料
驗證美國的地址時，Address Validation API 服務也可以填入傳回的 uspsData 部分。
由於系統並不會填入這個物件，因此您不應以該屬性做為驗證地址的唯一方式，而應該將判定和地址元件納入系統中。
USPS 送達點驗證 (DPV)
在 uspsData 回應中，dpvConfirmation 欄位會傳回單一字元，讓您瞭解 USPS 是否能傳送至指定地址。
您可以使用這個欄位來判斷：
- 地址有效性
- 。
- (如果 USPS 資料系統中沒有次要場所的號碼)。
服務會傳回四個 dpvConfirmation 值的其中之一，否則根本不會傳回 dpvConfirmation 值。下表列出邏輯應針對這 5 個可能結果使用的邏輯建議行為。如要進一步瞭解這個邏輯，請參閱「使用驗證回應」一文中的「工作流程總覽」。
值 |
行為 |
說明 |
|---|---|---|
N 或空白 |
修正地址 |
地址未經過 DPV 確認。 這表示 USPS 無法辨識輸入的街道 (路線) 上現有的就業號碼，因此無法送達。 |
D |
修正地址 |
地址只經確認為主要號碼的 DPV，但缺少次要號碼資訊。 |
六 |
確認地址 |
地址只有主要號碼的 DPV，但有次要號碼資訊，但尚未確認。 這表示輸入的道路上存在於輸入的路線中，但 USPS 指出，提供的次要場所並不存在於該建築物內。 |
必要 |
接受地址 |
已確認主要號碼和任何次要號碼的 DPV。 這表示這個地址可由 USPS 完整送達，包括次要場所的號碼 (如適用)。 |
本節其餘部分將討論使用 DPV 代碼的實際情境。
DPV N 範例 - 修正地址
此範例在其他有效地址使用了不存在的門牌號碼。
- 輸入的地址：12 Amphitheatre Parkway, Mountain View, CA, 94043, USA
- 區域：美國
dpvConfirmation欄位會傳回：N
這是這個路線上不存在的極為強烈的訊號。如同其他有問題的地址，系統應提示使用者更正。
DPV D 範例 - 修正地址
本範例使用位於紐約的 Google 辦公室，但不包含次要場所，這是地址的必要部分。只要使用示範中的地址就能查看，不需要帶有子內部部署資訊。
- 輸入的地址：111 8th Avenue, New York, NY, 10011
- 區域：美國
dpvConfirmation欄位會傳回：D
這就代表輸入內容中缺少子飯店。如要取得 Y 的 DPV，輸入內容中必須包含有效的子場所。例如，您可以加入 FL 4 (4 樓) 的有效子環境，取得 Y 的 dpvConfirmation 值。
DPV S 範例 - 確認地址
以下範例使用建築物中沒有的次要建築物號碼：
- 輸入的地址：1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043, USA
- 區域：美國
dpvConfirmation欄位會傳回：S
這表示 1600 Amphitheatre Parkway 存在的位址可以接收郵件，但副內部部署的 Ste 101 並不是地址的有效部分。您的系統應與使用者確認這項資訊，並提供修正的機會。
DPV Y 範例 - 接受位址
此範例使用加州山景城的 Googleplex 地址做為已知的品質地址。
- 輸入的地址：1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA
- 區域：美國
dpvConfirmation欄位會傳回：Y
USPS 可完整遞送地址。這可讓您非常確信 API 傳回的地址品質良好，而您可以直接使用這項資訊。
注意：DPV 不會指出 Address Validation API 是否已對輸入內容進行任何變更，例如拼寫校正。
美國地址的安全性訊息
本節說明針對人為建立位址的 USPS 資料提供的安全性標記。這項安全措施可偵測提交的地址是否以人為方式建構，而非以正當方式獲取，藉此防止人為建立地址清單。這種情況應該很少發生。
如果 USPS 發現人工建立的地址，回應的 uspsData 屬性的 errorMessage 欄位會包含說明問題的錯誤訊息。例如：
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.