處理美國地址

本文將說明美國的地址驗證：

• 在工作流程中使用 USPS 資料
• USPS 投遞點驗證欄位 (dpv)
• 安全性訊息

工作流程中的 USPS 資料

在美國驗證地址時，Address Validation API 服務也會填入回傳內容的 uspsData 部分。

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

美國郵政署遞送點驗證 (DPV)

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

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

• 地址有效性。
• 地址缺少子處所號碼。
• 如果 USPS 資料系統中沒有子地址號碼。

服務會傳回四個 dpvConfirmation 值之一，或完全不傳回 dpvConfirmation 值。下表顯示邏輯可能採用的行為，適用於 5 種可能結果。如要進一步瞭解這項邏輯，請參閱建構驗證邏輯中的範例工作流程。

本節的其餘部分將討論使用 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 是有效地址，但子處所「Suite 101」並非有效地址的一部分。建議您與使用者確認這項資訊，並提供更正機會。

DPV Y 範例 - 接受地址

本範例使用加州山景城 Googleplex 的地址做為已知的有效地址。

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

美國郵政署可將郵件送達該地址。這表示 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.