傳送地址驗證要求

向下列其中一個端點發出 POST 要求,傳送地址驗證要求:

您的要求也會將 JSON 要求主體傳送到定義要驗證位址的要求。以下要求主體包含一個欄位和三個子欄位:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

您也可以省略 locality,並將其指定為 addressLines 陣列中的元素:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

地址要求欄位

要求主體由單一欄位組成:

  • addressPostalAddress 類型的欄位,該欄位的 addressLines 中必須至少包含一個項目。

address 欄位傳送至 Address Validation API 時,只需要提供一個欄位:addressLines。不過,最簡單的地址要求應包含下列子欄位:

  • regionCode - 建議選項。這是選填欄位,但如果省略該欄位,Address Validation API 會從地址推測地區。不過,為獲得最佳效果,如果您知道 regionCode,請加入 regionCode。如需支援的區域清單,請參閱支援的地區
  • addressLines:必要項目。包含地址的陣列,說明地址較低結構。
請參閱參考指南中的 PostalAddress

USPS CASSTM 選項

United States Postal Service® (USPS®)1 負責維護程式設計正確性支援系統 (CASSTM),以支援及驗證地址驗證服務供應商。

僅適用於美國和 PR 區域,只要在要求主體中將 enableUspsCass 設為 true,即可啟用 CASS 處理。為了在使用 CASS 時獲得最佳結果,您提供的地址必須包含街道和門牌號碼,以及城市、州/省和郵遞區號:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

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