本文件涵蓋美國特有的地址驗證:
- 在工作流程中使用 USPS 資料
- USPS 交付點驗證欄位 (dpv)
- 安全性訊息
在工作流程中使用 USPS 資料
驗證美國的地址時,Address Validation API 服務也可以填入傳回的 uspsData 部分。
由於系統並不會填入這個物件,因此您不應以該屬性做為驗證地址的唯一方式,而應該將判定和地址元件納入系統中。
USPS 送達點驗證 (DPV)
在 uspsData
回應中,dpvConfirmation
欄位會傳回單一字元,讓您瞭解 USPS 是否能傳送至指定地址。
您可以使用這個欄位來判斷:
- 地址有效性
- 。
- (如果 USPS 資料系統中沒有次要場所的號碼)。
服務會傳回四個 dpvConfirmation
值的其中之一,否則根本不會傳回 dpvConfirmation
值。下表列出邏輯應針對這 5 個可能結果使用的邏輯建議行為。如要進一步瞭解這個邏輯,請參閱「使用驗證回應」一文中的「工作流程總覽」。
值 |
行為 |
說明 |
---|---|---|
N 或空白 |
修正地址 |
地址未經過 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.