處理美國地址

本文將說明美國的地址驗證機制:

工作流程中的 USPS 資料

驗證美國境內的地址時,Address Validation API 服務 也可以填入回傳值的 uspsData 部分。

由於這個物件不一定會填入,因此您不應將這個屬性視為驗證地址的唯一方式,而是應將判定結果和地址元件納入系統。

USPS 送達地點驗證 (DPV)

dpvConfirmation 欄位是 uspsData 回應的一部分,會傳回單一字元,讓您瞭解 USPS 是否可以將包裹送到指定地址。

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

  • 地址有效性
  • (如果 USPS 資料系統中沒有次要場所的號碼)。

服務會傳回四個 dpvConfirmation 值之一,或根本不傳回 dpvConfirmation 值。下表列出邏輯應針對每個可能的 5 種結果採用的建議行為。如要進一步瞭解這項邏輯,請參閱「使用驗證回應」一文中的工作流程總覽

行為

說明

N 或空白

修正地址

地址未經過 DPV 確認。

這表示 USPS 無法辨識輸入的地端部署號碼 無法送到所輸入街道 (路線) 的現有道路上,無法送達。

D

修正地址

地址僅針對主要號碼進行 DPV 確認,且缺少次要號碼資訊。

這表示輸入的門牌號碼位於輸入的街道上,但為了取得經過完整驗證/可送達的地址,您也必須提供有效的子門牌號碼。也就是說,輸入內容中缺少子門牌。

S

確認地址

該地址僅經確認為主要號碼的 DPV,且 包含次要號碼資訊,但尚未確認。

這表示輸入的門牌號碼位於輸入的路線上,但根據 USPS 的說法,所提供的子門牌並未位於該建築物內。

接受地址

地址已通過 DPV 確認,且有主要和任何次要號碼。

這表示 USPS 可以完全送達該地址,包括子門牌號碼 (如有)。

本節其餘部分將討論使用 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 存在的是 可以接收郵件,子內部部署的 Ste 101 不是有效的地址。 您的系統應與使用者確認此資訊,並提供 提供修正的機會

DPV Y 範例 - 接受位址

本例使用加州山景城的 Googleplex 地址做為 已知的品質地址

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

這個地址可由 USPS 完全送達。如此一來 相信 API 傳回了高品質地址,您可以使用它 如畫面所示

注意:DPV 不會指出 Address Validation API 是否對輸入內容進行任何變更,例如拼字修正。

美國地址的安全性訊息

本節介紹的 USPS 資料中針對 以人工方式建立位址這項安全措施旨在 透過偵測已提交地址的時間,以人工方式建立地址清單 似乎是人為建構而並非合法取得。 這種情況應該極少發生。

如果 USPS 發現是假造的地址,errorMessage 在回應的 uspsData 屬性中,欄位包含 錯誤訊息。例如:

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.