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 的工作流程範例:
客戶輸入地址 - 下圖為簡易形式,可讓客戶在結帳流程中輸入地址。
應用程式傳送位址至 API – 應用程式會將這個位址做為輸入內容傳送至 Address Validation API。
API 會驗證地址並將其標準化 – 在回應中,Address Validation API 會傳回由 API 決定的完整地址,或指出資訊遺漏之處。
客戶修正或確認建議的地址:視 API 傳回的內容而定,您可以向客戶提供下列提示:
向客戶提供建議的地址,方便客戶確認:
請客戶補上缺少的資訊:
如果 API 因資訊缺漏或不正確而無法驗證輸入地址,請提示使用者修正地址:
Address Validation API 的運作方式
位址驗證程序接受以 JSON 主體格式包含地址的 POST 要求。它會將地址拆成個別元件,然後執行下列檢查和修正:
- 正確:提供元件層級驗證檢查,包括可用的子內部部署。
- Complete:嘗試推斷遺漏或不正確的地址元件。
- 正確格式:清理及標準化地址元件格式。
您可以試用看看,瞭解 Address Validation API 的實際運作情形。
資源
下表摘要列出透過 Address Validation API 取得的資源及其傳回的資料。詳情請參閱 Address Validation API 參考資料。
資料資源 | 傳回的資料 |
---|---|
JSON 格式的地址元件。 請參閱「驗證地址」一節。 |
完整且通過驗證的地址 (如果可以的話)。 每個地址元件的驗證狀態。 地址適用範圍:
請參閱瞭解驗證回應。 |
如何使用 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®)1 負責維護程式設計正確性支援系統 (CASSTM),以支援及驗證地址驗證服務供應商。已確認 Address Validation API 等 CASS CertifiedTM 服務可以填入地址中缺少的資訊、將其標準化並更新,取得最新且最正確的地址。
系統預設不會啟用 CASS,且僅支援「US」和「PR」地區。如要啟用 CASS,請在驗證要求中將 enableUspsCass
設為 true
。詳情請參閱「驗證地址」。
使用 USPS 服務時,USPS 會評估人工建立位址的要求。如果 USPS 確認輸入地址是以人工建立的方式,Google 就必須停止驗證客戶地址,且必須將客戶聯絡資訊 (姓名和地址)、相關輸入地址及匯總使用資料回報給 USPS。使用 API 即表示您同意這些服務專屬條款。
後續步驟
- 查看常見問題:請參閱常見問題
- 查看服務涵蓋範圍:請參閱「國家/地區和區域涵蓋範圍詳細資料」
- 處理大量地址:請參閱「使用 Address Validation API 處理大量地址」
-
Google 地圖平台是美國郵政服務®的非專屬被授權人。下列商標為美國郵政服務® 所有,且經授權使用:United States Postal Service®、CASSTM、CASS CertifiedTM。↩