處理美國地址

本文將說明美國的地址驗證：

工作流程中的 USPS 資料

在美國驗證地址時，Address Validation API 服務也會填入回傳內容的 uspsData 部分。

由於這個物件不一定會填入資料，因此您不應只依據這個屬性驗證地址，而是應將判決結果和地址元件也納入系統。

美國郵政署遞送點驗證 (DPV)

在 uspsData 回應中，dpvConfirmation 欄位會傳回單一字元，告知你美國郵政署是否可將郵件遞送到提供的地址。

您可以使用這個欄位判斷下列事項：

  • 地址有效性。
  • 地址缺少子處所號碼。
  • 如果 USPS 資料系統中沒有子地址號碼。

服務會傳回四個 dpvConfirmation 值之一，或完全不傳回 dpvConfirmation 值。下表顯示邏輯可能採用的行為，適用於 5 種可能結果。如要進一步瞭解這項邏輯，請參閱「建立驗證邏輯」中的「範例工作流程」。

值

行為

說明

N 或空白

修正地址

地址未通過 DPV 確認。

這表示 USPS 無法辨識輸入的門牌號碼，因此可能無法將郵件送達該地址。

D

新增子場所

地址僅針對主要號碼通過 DPV 確認，且缺少次要號碼資訊。

這表示輸入的門牌號碼位於輸入的街道上，但如要取得完全驗證/可送達的地址，還必須提供有效的子門牌號碼。換句話說，輸入內容缺少子場所。

S

確認地址

地址已通過 DPV 確認，但僅適用於主要號碼，次要號碼資訊存在但未通過確認。

這表示輸入的地址號碼位於輸入的路線上，但根據 USPS 的資料，提供的子地址不存在於該建築物內。

是

接受地址

主要和次要號碼的地址都已通過 DPV 確認。

這表示美國郵政署可完整投遞郵件至該地址，包括住宅單元號碼 (如有)。

本節的其餘部分將討論使用 DPV 代碼的實際情境。

DPV N 示例 - 修正地址

這個範例在有效的地址中使用了不存在的街號。

  • 輸入的地址：12 Amphitheatre Parkway, Mountain View, CA, 94043
  • 區域：美國
  • 「dpvConfirmation」欄位會傳回：N

這項資訊極具參考價值，代表這條路線上沒有這個門牌號碼。與其他有問題的地址一樣，系統應提示使用者修正。

DPV D 範例 - 新增子處所

這個範例使用紐約的 Google 辦公室，但未包含地址的必要部分 (子場所)。您可以在示範中使用這個地址，但不要提供子處所資訊。

  • 輸入的地址：111 8th Avenue, New York, NY, 10011
  • 區域：美國
  • 「dpvConfirmation」欄位會傳回：D

這表示輸入內容缺少子處所。如要取得 Y 的 DPV，輸入內容必須包含有效的子前提。舉例來說，您可以納入 FL 4 (4 樓) 的有效子處所，取得 dpvConfirmation 值 Y。

DPV S 範例 - 確認地址

這個範例使用的子處所號碼在建築物內不存在：

  • 輸入的地址：1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 區域：美國
  • 「dpvConfirmation」欄位會傳回：S

這表示 1600 Amphitheatre Parkway 是有效地址，但子處所「Suite 101」並非有效地址的一部分。建議您與使用者確認這項資訊，並提供更正機會。

DPV Y 範例 - 接受地址

本範例使用加州山景城 Googleplex 的地址做為已知的有效地址。

  • 輸入的地址：1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • 區域：美國
  • 「dpvConfirmation」欄位會傳回：Y

美國郵政署可將郵件配送至該地址。這表示 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.