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 運作方式

地址驗證接受 POST 要求，其中地址格式為 JSON 主體。它會將地址分隔為個別元件，然後進行以下檢查和修正：

• 正確：提供元件層級的驗證檢查，包括子內部部署 (如適用)。
• 完成：嘗試推論遺漏或不正確的地址元件。
• 說明格式：清除地址元件的格式並標準化。

如想瞭解 Address Validation API 的實際運作情形，請進行示範。

資源

下表摘要說明可透過 Address Validation API 取得的資源，以及該 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)，以支援及認證地址驗證服務供應商。經確認，CASS CertifiedTM 服務 (例如 Address Validation API) 可填入地址缺少的資訊、將地址標準化，並更新服務，為您提供最新且最正確的地址。

根據預設，系統不會啟用 CASS，且這項功能僅適用於「US」和「PR」區域。如要啟用 CASS，請在驗證要求中將 enableUspsCass 設為 true。詳情請參閱驗證位址。

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

後續步驟

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