Address Validation API 總覽

Address Validation API 是一項可接受地址的服務。它能識別並驗證地址元件。也能將郵寄地址標準化，找出最適合該地址的經緯度座標。如果是美國和波多黎各地址，您可以啟用程式設計準確率支援系統 (CASSTM)。

使用 Address Validation API 的好處

透過 Address Validation API，您可以提高交付項目的預測能力並減少交付失敗，從而提供更優質的客戶體驗。做法是攔截錯誤的地址，並提高地址特性的警覺。

如果您不需要驗證個別地址元件，Geocoding API 可能更符合您的需求。Geocoding API 會將地址轉換為經緯度座標，Address Validation API 則會驗證地址是否正確。如需詳細比較資訊，請參閱架構中心的「使用 Google 地圖平台建構位置驗證功能」一文。

Address Validation API 的用途

使用 Address Validation API，您可以判斷地址是否指到實際地點，如果地址未參照到實際位置，API 可以識別可能有誤的元件，而這些元件可提供給客戶修正。以下是使用 API 的工作流程範例：

1. 客戶輸入地址 - 下圖為簡易形式，可讓客戶在結帳流程中輸入地址。
   

2. 應用程式傳送位址至 API – 應用程式會將這個位址做為輸入內容傳送至 Address Validation API。

3. API 會驗證地址並將其標準化 – 在回應中，Address Validation API 會傳回由 API 決定的完整地址，或指出資訊遺漏之處。

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

   • 向客戶提供建議的地址，方便客戶確認：
     

   • 請客戶補上缺少的資訊：
     

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

Address Validation API 的運作方式

位址驗證程序接受以 JSON 主體格式包含地址的 POST 要求。它會將地址拆成個別元件，然後執行下列檢查和修正：

• 正確：提供元件層級驗證檢查，包括可用的子內部部署。
• Complete：嘗試推斷遺漏或不正確的地址元件。
• 正確格式：清理及標準化地址元件格式。

您可以試用看看，瞭解 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

United States Postal Service® (USPS®)¹ 負責維護程式設計正確性支援系統 (CASSTM)，以支援及驗證地址驗證服務供應商。已確認 Address Validation API 等 CASS CertifiedTM 服務可以填入地址中缺少的資訊、將其標準化並更新，取得最新且最正確的地址。

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

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

後續步驟

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