傳送地址驗證要求

請向下列任一端點發出 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"]
  },
}

試試看!

地址要求欄位

要求主體包含單一欄位:

  • address:類型為 PostalAddress 的欄位,必須在 addressLines 中包含至少一個項目。

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

  • regionCode - 建議選項,這是選用欄位,但如果省略,Address Validation API 會從地址推斷地區。不過,如要獲得最佳結果,請在瞭解 regionCode 的情況下加入該值。如需支援的區域清單,請參閱「支援的區域」。
  • addressLines:必填。陣列含有地址,說明地址的較低層級結構。
請參閱參考指南中的 PostalAddress

USPS CASSTM 選項

美國郵政服務® (USPS®)1 維護編碼準確性支援系統 (CASS™),以便支援和認證地址驗證服務供應商。

針對僅限美國和 PR 區域,您可以在要求主體中將 enableUspsCass 設為 true,即可啟用 CASS 處理。為確保使用 CASS 時獲得最佳成效,請提供包含街道和門牌號碼的地址,以及城市、州和郵遞區號:

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

試試看!

您可以使用 API Explorer 提出範例要求,熟悉 API 和 API 選項。

  1. 選取頁面右側的 API 圖示 展開 API Explorer。

  2. 您可以選擇展開「顯示標準參數」,然後將 fields 參數設為欄位遮罩

  3. 您可以選擇編輯要求主體

  4. 選取「執行」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。

  5. 在「API Explorer」面板中選取展開圖示 展開 API Explorer。,展開「API Explorer」視窗。


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