處理美國地址

本文件涵蓋美國專用的地址驗證：

工作流程中的 USPS 資料

驗證美國地址時，Address Validation API 也可以填入傳回值的 uspsData 部分。

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

USPS 投遞點驗證 (DPV)

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

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

  • 地址有效性。
  • 地址缺少子建築物編號。
  • 如果 USPS 資料系統中沒有子門牌號碼。

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

值

行為

說明

否

或空白

修正地址

地址未通過 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 樓)，取得 Y 的 dpvConfirmation 值。

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 判定地址是人為建立，回應的 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.