Address Validation API 總覽

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

使用 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 傳回的內容而定，您可以向客戶提供下列提示：A. 確認建議地址。B. 提供缺少的資訊。C. 修正地址。

    請客戶確認 API 判定的地址。提示客戶輸入缺少的地址資訊。 請客戶修正地址資訊。

Address Validation API 的運作方式

地址驗證會接受含有 JSON 主體格式地址的 POST 要求。它會將地址拆分為個別元件，然後嘗試執行以下操作：

  • Corrects：提供元件層級的驗證檢查，包括可用的子區塊。
  • Completes：嘗試推斷缺少或不正確的地址元件。
  • 格式：清理並標準化地址元件的格式。

資源

下表列出可透過 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 適用的用戶端程式庫清單，請參閱用戶端程式庫。

關於 CASS™

美國郵政服務® (USPS®)1 維護編碼準確性支援系統 (CASS™)，以支援及認證地址驗證服務供應商。經認證的 CASS™ 服務 (例如 Address Validation API) 已證實可填入地址中缺少的資訊、將資訊標準化，並更新資訊，為您提供最新且最準確的地址。

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

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

後續步驟

  1. Google 地圖平台是 United States Postal Service® 的非專屬授權使用者。以下商標由 United States Postal Service® 所有，並經過授權使用：United States Postal Service®、CASS™、CASS Certified™。↩