使用 Address Validation API 的好處
使用 Address Validation API 時，您可以改善顧客體驗，進而提高交付項目的預測性，並減少交付失敗情形。方法是找出無效位址，並提高地址特性的掌握度。
如果您不需要驗證個別地址元件，Geocoding API 可能更符合您的需求。Geocoding API 會將地址轉換為經緯度座標，Address Validation API 則會驗證地址的正確性。如需詳細比較，請參閱架構中心的「使用 Google 地圖平台建構位置驗證功能」一文。
Address Validation API 的用途
只要使用 Address Validation API，您就可以判斷地址是否參照實際地點。如果地址不是實際存在的地點，API 就能識別出可能有誤的元件，讓您可以向客戶顯示來更正錯誤。以下是使用 API 的工作流程範例：
客戶輸入地址 - 下圖顯示可讓客戶輸入地址的簡易表單，可能屬於結帳程序的一部分。
應用程式將位址傳送至 API：應用程式會將這個地址做為輸入內容傳送至 Address Validation API。
API 驗證並標準化地址 – 在回應中，Address Validation API 會傳回 API 判定的完整地址，或指出缺少資訊的位置。
客戶修正或確認建議的地址 – 視 API 傳回的內容而定，您可以為客戶提供以下提示：
向客戶提供建議的地址以確認：
提示客戶補上遺漏的資訊：
如果 API 因缺少資訊或資訊錯誤而無法驗證輸入地址，請提示使用者修正地址：
Address Validation API 運作方式
地址驗證接受 POST 要求，其中地址格式為 JSON 主體。它會將地址分隔為個別元件，然後進行以下檢查和修正：
- 正確：提供元件層級的驗證檢查，包括子內部部署 (如適用)。
- 完成：嘗試推論遺漏或不正確的地址元件。
- 說明格式：清除地址元件的格式並標準化。
如想瞭解 Address Validation API 的實際運作情形，請進行示範。
資源
下表摘要說明可透過 Address Validation API 取得的資源，以及該 API 傳回的資料。詳情請參閱 Address Validation API 參考資料。
| 資料資源 | 傳回的資料 |
|---|---|
|
採用 JSON 格式的地址元件。 請參閱驗證地址。 |
完整且經過驗證的地址 (如果有的話)。 每個地址元件的驗證狀態。 適用地址的國家/地區：
請參閱「瞭解驗證回應」。 |
如何使用 Address Validation API
| 1 | 體驗功能 | 探索示範，瞭解使用各種地址表單 (無論地址正確或不正確)。這個示範可讓您輕鬆探索服務傳回的值，以及 JSON 格式化的 API 回應。 |
| 2 | 查詢保固範圍 | 如要瞭解 Address Validation API 支援的國家/地區，請參閱涵蓋範圍詳細資料。 |
| 3 | 做好準備 | 從設定 Google Cloud 專案開始，並按照後續指示操作。 |
| 4 | 要求驗證地址 | 以簡單的地址開始。如要提高準確率，您可以啟用 CASS (僅適用於美國和公關地址)。請參閱「要求驗證地址」。 |
| 5 | 處理回覆 | Address Validation API 回應提供兩項屬性，每個屬性可由不同方式使用。請參閱瞭解基本回應。 |
| 6 | 提高驗證準確度 | 歡迎針對 Address Validation API 回應提供意見回饋，藉此提高地址準確度。請參閱「處理更新後的地址」。 |
可用的用戶端程式庫
如需 Address Validation API 可用的用戶端程式庫清單，請參閱用戶端程式庫。
關於 CASSTM
United States Postal Service® (USPS®)1 負責維護協調準確性支援系統 (CASSTM)，以支援及認證地址驗證服務供應商。經確認，CASS CertifiedTM 服務 (例如 Address Validation API) 可填入地址缺少的資訊、將地址標準化，並更新服務，為您提供最新且最正確的地址。
根據預設，系統不會啟用 CASS，且這項功能僅適用於「US」和「PR」區域。如要啟用 CASS，請在驗證要求中將 enableUspsCass 設為 true。詳情請參閱驗證位址。
在使用 USPS 服務時，USPS 會評估人工建立地址的要求。如果 USPS 發現輸入地址是人為建立，則 Google 必須停止為該客戶驗證地址，且必須將客戶的聯絡資訊 (姓名和地址)、相關輸入地址、匯總使用資料回報給 USPS。使用 API，即表示您同意這些服務專屬條款。
後續步驟
- 查看常見問題：前往常見問題
- 查看適用區域：請參閱「國家/地區和區域涵蓋範圍詳細資料」
- 大量處理地址：請參閱「使用 Address Validation API 處理大量地址」一文
-
Google 地圖平台是美國郵政署(Postal Service®) 的非專屬執照。下列商標的擁有者為 United States Postal Service®，且已獲授權使用：United States Postal Service®、CASSTM、CASS CertifiedTM。↩