Address Validation API 接受地址、識別並驗證地址元件、將地址標準化以利郵寄,並傳回最合適的經緯度座標。如果是美國和波多黎各的地址,您可以選擇啟用 USPS CASS 處理。
Address Validation API:重要資訊
- 產品:Address Validation API
- 類別:地點
- 平台:網路服務 (REST)
- 執行位置:伺服器 (後端程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:Address Validation API 總覽
- 適用地區:有限。支援的國家/地區和資料品質因國家/地區而異,部分國家/地區處於預先發布版階段。只有在涵蓋範圍頁面標記的國家/地區,才會傳回住宅和商業中繼資料。USPS CASS 僅適用於美國和波多黎各。(涵蓋範圍詳細資料)
Address Validation API:使用時機
Address Validation API 的適用情況:
- 您需要檢查地址是否指向實際地點,並找出缺少或可能錯誤的元件。
- 您需要標準化並填寫完整的郵寄地址,例如在結帳程序中。
- 美國或波多黎各的地址必須通過 USPS CASS 認證和
uspsData。 - 您需要涵蓋範圍頁面所列國家/地區的住宅或商業地址中繼資料。
不適合使用 Address Validation API 的情況:
- 您只需要將地址轉換成經緯度,不必驗證個別地址元件。請改用 Geocoding API。
- 您需要超本地目的地詳細資料,例如建築物入口、建築物輪廓或導航點。請改用 Geocoding API。
Address Validation API:設定
- 要啟用的服務:
addressvalidation.googleapis.com - 驗證:API 金鑰、OAuth 2.0、服務帳戶
- 開始使用:設定 Address Validation API
- 參考資料:Address Validation API 參考資料
- 定價:Address Validation API 用量與計費
- 政策:Address Validation API 政策
- 版本資訊:Address Validation API 版本資訊
官方 Address Validation API 套件:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
Address Validation API:常見錯誤
- 問題:如果
addressComplete屬性的值為false,判定結果會省略該屬性,因此預期該欄位存在的程式碼可能會誤讀不完整的地址。修正方式:將缺少的addressComplete屬性視為false,或檢查屬性是否存在。請參閱 /maps/documentation/address-validation/understand-response。 - 問題:如果省略
regionCode,API 會從地址推斷區域,結果可能較不準確。修正方式:如果知道regionCode,請在PostalAddress中加入。請參閱 /maps/documentation/address-validation/requests-validate-address。 - 問題:
uspsData物件不一定會為每個經過驗證的美國地址填入完整資料。修正方式:請勿只依賴uspsData做為驗證信號,也應使用判定結果和地址元件。請參閱 /maps/documentation/address-validation/handle-us-address。 - 問題:使用
provideValidationFeedback傳送的意見回饋必須參照序列中第一個validateAddress呼叫的responseId,而非後續呼叫。修正:儲存第一個validateAddress回應中的responseId,並在意見回饋要求中傳送。請參閱 /maps/documentation/address-validation/handle-updated-address。
Address Validation API 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 傳回指定地址或部分地址的驗證地址。
- 傳回已驗證地址的經緯度座標。
- 傳回已驗證地址的 Google 地點 ID。
- 使用美國郵政署 (USPS) 編碼準確度支援系統 (CASS) 認證進行地址驗證。
- 傳回資訊,指出經過驗證的地址是商家、住宅或郵政信箱。
- 傳回已驗證地址的美國郵政署 (USPS) 投遞中繼資料。
- 傳回英文版的已驗證地址。預覽
- 傳回已驗證地址的 Plus Code。