本文將說明美國的地址驗證機制:
- 在工作流程中使用 USPS 資料
- USPS 交付點驗證欄位 (dpv)
- 安全性訊息
工作流程中的 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.