Address Validation API 總覽

Address Validation API 是一項接受地址的服務。可識別地址元件並進行驗證。它也會將郵寄地址標準化，找出最適合的已知經緯度座標。對於美國和波多黎各的地址，您也可以選擇啟用編碼準確度支援系統 (CASSTM)。

使用 Address Validation API 的好處

使用 Address Validation API 時，您可以改善傳送可預測性並減少傳送失敗，藉此提供更優質的客戶體驗。這麼做可以找出錯誤的位址，並提升對地址特性的瞭解。

如果您無須驗證要求的個別地址元件，Geocoding API 可能更符合您的需求。Geocoding API 會將地址轉換為經緯度座標，而 Address Validation API 則會驗證地址的正確性。詳情請參閱下方的 Address Validation API 運作方式和 Geocoding API 總覽。

Address Validation API 的用途

使用 Address Validation API 時，您可以判斷地址是否是指真實地點。如果地址無法參照實際地點，API 可能會找出可能有誤的元件，並向客戶修正。以下是使用 API 的工作流程範例：

1. 「Customers an address」(客戶輸入地址) - 下圖顯示了簡易表單，讓客戶可以在結帳流程中輸入地址。
   

2. 應用程式將位址傳送至 API：應用程式會將此地址做為輸入內容傳送至 Address Validation API。

3. API 驗證並標準化地址：在回應中，Address Validation API 會傳回 API 決定的完整地址，或指出資訊遺漏的部分。

4. 客戶修正或確認建議的地址 – 視 API 傳回的內容而定，您可以向客戶提供下列提示：

   • 提供建議的地址，請客戶確認：
     

   • 提示客戶新增缺少的資訊：
     

   • 如果 API 因資訊缺漏或不正確而無法驗證輸入地址，請提示使用者修正地址：
     

Address Validation API 的運作方式

地址驗證程序接受地址格式為 JSON 主體的 POST 要求。它會將地址分隔成個別元件，然後執行下列檢查與修正：

• 正確：提供元件層級的驗證檢查，包括可能的子地端部署。
• 完成：嘗試推斷遺漏或不正確的地址元件。
• 正確格式：清除地址元件格式並標準化。

試用示範，看看 Address Validation API 的實際運作情況。

資源

下表摘要列出可透過 Address Validation API 使用的資源，以及其傳回的資料。詳情請參閱 Address Validation API 參考資料。

資料資源	傳回的資料
以 JSON 格式地址元件。 請參閱驗證地址。	提供完整且通過驗證的地址 (如果可以的話)。 每個地址元件的驗證狀態。 適用於地址的國家/地區： Geocode 地址精確度 郵政服務資料 (如果有的話)。 請參閱瞭解驗證回應一節。

如何使用 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

美國郵政署 (USPS®)¹ 負責維護編碼準確度支援系統 (CASSTM)，以便支援並認證地址驗證服務供應商。CASS CertifiedTM 服務 (例如 Address Validation API) 已確認可以填入地址缺少的資訊、將地址標準化，並提供更新，提供最新且最準確的地址。

CASS 預設為不啟用，且僅適用於「US」和「PR」地區。如要啟用 CASS，請在驗證要求中將 enableUspsCass 設為 true。詳情請參閱驗證地址。

使用 USPS 服務時，USPS 會評估人為建立地址的要求。如果 USPS 將輸入地址視為人工建立，Google 必須停止驗證該客戶地址，而且必須回報客戶的聯絡資訊 (姓名和地址)、相關輸入地址，以及經過匯總的使用資料給 USPS。使用 API 即表示您同意遵守這些《服務專屬條款》。

後續步驟

• 查看常見問題：請參閱常見問題
• 查看涵蓋範圍：請參閱「國家/地區和區域涵蓋範圍詳細資料」
• 大量處理地址：請參閱「使用 Address Validation API 處理大量地址」一文