Address Validation API 總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Address Validation API 是一種接受地址、識別地址元件並驗證其的服務。也會將郵寄地址標準化。這有助於瞭解地址是否為實際地點。如果地址並非代表實際位置,則可以識別可能錯誤的元件,讓使用者更正。

Address Validation API 提供了許多可協助您處理地址的功能,包括:

  • 將位址分隔成各自的元件,然後提供元件層級的驗證檢查,包括子內部部署 (如果適用)。

  • 清理、標準化及推斷遺漏或錯誤的地址元件。

  • 使用地址、地址精確度以及郵政服務資料等其他地址來補充地址。

  • 傳回包含 API 決定之完整地址的單一字串。

試用示範,瞭解地址驗證 API 的實際運作情形。

將 Address Validation API 新增至工作流程

Address Validation API 最常見的用途之一,就是確保客戶提供正確的地址,藉此提升客戶體驗。地址驗證有助於擷取地址有誤,並提升地址特性的提高可預測性,進而降低傳送失敗的情況。

下圖顯示可讓客戶輸入地址 (可能是結帳流程的一部分) 的簡單形式。將此位址做為位址驗證,傳送至位址驗證 API。

客戶輸入的地址。

Address Validation API 的回應中會傳回完整地址,由 API 判斷。向客戶顯示完整地址,做為建議的地址:

API 判定的地址。

如果 Address Validation API 偵測到遺漏的資訊,請提示使用者新增該資訊:

提示客戶輸入缺少地址資訊的表單。

如果 API 因缺少資訊或資訊不正確而無法驗證輸入地址,請提示使用者修正地址:

此表單提示客戶更正地址資訊。

Address Validation API 和 Geocoding API 之間的差異

Geocoding API 和 Address Validation API 都會嘗試回答「此使用者輸入內容的最佳位置為何?」這個問題與 Geocoding API 不同,Address Validation API 也會嘗試:

  • 找出「這項使用者輸入內容代表的是實際地址嗎?」這個問題,
  • 即使輸入部分無法與可用資料進行比對,也能瞭解輸入位址
  • 針對不同元件的有效性提供意見
  • 確認地址是否完整,並標記缺少任何必要的元件
  • 為傳回的郵件專用地址設定合適的地址格式

舉例來說,假設地址是「123 Fake St, Mountain View, CA」,地址就是 123 Falit, 123 Fake St.,因為山景城中沒有這類街道 (或名稱類似的街道)。

另一方面,Address Validation API 能夠辨識「123」是門牌號碼,「假貨」

CASSTM 簡介

美國郵政服務® (USPS®)1 負責維護編碼準確性支援系統 (CASSTM),以支援及驗證地址驗證服務供應商。已確認 CASS CertifiedTM 服務 (例如 Address Validation API) 是否能填入地址中遺漏的資訊、將其標準化並更新,以提供最新、最精確的地址。

CASS 預設為不啟用,因此僅適用於「US」和「PR」區域。如要啟用 CASS,請將 enableUspsCass 設為 true 做為驗證要求的一部分。詳情請參閱驗證地址一文。

使用 USPS 服務時,USPS 會評估由人工建立位址提出的要求。如果 USPS 將輸入地址辨識為人工建立,Google 就必須停止驗證客戶的地址,且必須向 USPS 回報客戶的聯絡資訊 (姓名和地址)、相關輸入地址,以及匯總的使用資料。使用 API 即表示您同意《服務專屬條款》。

後續步驟


  1. Google 地圖平台是美國郵政服務的非專屬被授權人。以下商標是由美國郵政服務擁有,並經過授權使用:United States Postal Service®、CASSTM、CASS CertifiedTM。