處理美國地址

本文件涵蓋美國特有的地址驗證:

在工作流程中使用 USPS 資料

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

系統不一定會填入這個物件,因此不建議採行此做法 屬性做為驗證地址的唯一方式,而是將 並解決系統中的元件

USPS 送達點驗證 (DPV)

uspsData 回應中,dpvConfirmation 欄位會傳回單一 字元,通知您 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, USA
  • 區域:美國
  • dpvConfirmation 欄位會傳回:N

表示這個內部號碼不存在,表示非常強烈 這條航線。和其他有問題的地址一樣,系統應會提示 要求修正。

DPV D 範例 - 修正地址

此範例使用位於紐約的 Google 辦公室,但不包含 因為這是地址中的必要項目。方法是使用 示範中的位址,不含子內部部署資訊。

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

這就代表輸入內容中缺少子飯店。前往 DPV 的 Y 標記,輸入時就必須包含有效的子場所。例如: 就可以包含 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, USA
  • 區域:美國
  • 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.