這份文件涵蓋美國專屬的地址驗證資訊:
- 在工作流程中使用 USPS 資料
- USPS 遞送點驗證欄位 (dpv)
- 安全性訊息
工作流程中的 USPS 資料
驗證美國的地址時,Address Validation API 服務也可以填入傳回的 uspsData 部分。
由於這個物件不會一律填入,因此建議您不要依賴這個屬性,只是驗證地址的唯一方法,而是將判定結果和地址元件納入系統中。
USPS 快遞驗證 (DPV)
在 uspsData
回應中,dpvConfirmation
欄位會傳回單一字元,讓您瞭解 USPS 是否可以將 USPS 傳送至提供的地址。
您可以使用這個欄位來判斷下列項目:
- 地址效力。
- 地址中缺少次要場所的號碼。
- (如果 USPS 資料系統中沒有次要內部部署的號碼)。
服務會傳回四個 dpvConfirmation
值的其中一個,或者完全不會傳回 dpvConfirmation
值。下表列出邏輯在這 5 種可能結果中應使用的建議行為。如要進一步瞭解這個邏輯,請參閱「使用驗證回應」中的工作流程總覽。
值 |
行為 |
說明 |
---|---|---|
否或空白 |
修正地址 |
地址未經過 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.