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 決定的地址。

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

    • 如果 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 地圖平台是美國郵政服務® 的非專屬被授權人。下列商標由美國郵政服務® 擁有,且經許可使用:United Postal Service®、CASSTM、CASS CertifiedTM。