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 的設定確認地址。

    • 提示客戶新增缺少的資訊:
      請客戶輸入缺少的地址資訊。

    • 如果 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®)1 負責維護程式設計準確性支援系統 (CASSTM),藉此支援及認證地址驗證服務供應商。經過確認,CASS CertifiedTM 服務 (例如 Address Validation API) 可以填入地址中缺少的資訊、進行標準化,並更新服務,提供最新且最正確的地址。

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

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

後續步驟


  1. Google 地圖平台是美國郵政服務(Postal Service®) 的非專屬執照。下列商標由美國郵政服務®擁有,且經授權使用:United States Postal Service®、CASSTM、CASS CertifiedTM