使用 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 傳回的內容而定，您可以向客戶提供下列提示：A. 確認建議地址。B. 提供缺少的資訊。C. 修正地址。
Address Validation API 的運作方式
地址驗證會接受含有 JSON 主體格式地址的 POST 要求。它會將地址分成個別元件，然後嘗試執行以下操作：
- Corrects：提供元件層級的驗證檢查，包括可用的子區塊。
- Completes：嘗試推斷缺少或不正確的地址元件。
- 格式：清理並標準化地址元件的格式。
資源
下表列出可透過 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 適用的用戶端程式庫清單，請參閱用戶端程式庫。
關於 CASS™
美國郵政服務® (USPS®)1 維護編碼準確性支援系統 (CASS™)，以支援及認證地址驗證服務供應商。經認證的 CASS™ 服務 (例如 Address Validation API) 已證實可填入地址中缺少的資訊、將資訊標準化並更新，以便提供最新且最準確的地址。
系統預設不會啟用 CASS，且僅支援「US」和「PR」區域。如要啟用 CASS，請將 enableUspsCass 設為 true，做為驗證要求的一部分。詳情請參閱「驗證地址」。
在使用 USPS 服務時，USPS 會評估人工建立地址的要求。如果 USPS 判定輸入地址是人為建立，Google 就必須停止為客戶驗證地址，並將客戶的聯絡資訊 (姓名和地址)、相關輸入地址和匯總使用資料回報給 USPS。使用 API 即表示您同意這些《服務特定條款》。
後續步驟
- 試用示範：前往「示範」
- 查看涵蓋範圍：請參閱「國家/地區涵蓋範圍詳細資料」
- 嘗試提出第一個驗證要求：請參閱「傳送地址驗證要求」
- 處理大量地址：請參閱「使用 Address Validation API 處理大量地址」
-
Google 地圖平台是 United States Postal Service® 的非專屬授權使用者。以下商標由 United States Postal Service® 所有，並經過授權使用：United States Postal Service®、CASS™、CASS Certified™。↩