傳送地址驗證要求

傳送 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 負責維護 使用程式設計準確率支援系統 (CASSTM) 提供支援和認證 地址驗證供應商

如果是僅限美國和公關區域,您可以藉由設定方式啟用 CASS 處理 要求主體中的 enableUspsCasstrue。為確保使用 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. 選取「Execute」按鈕。在對話方塊中,選擇要執行哪項帳戶的帳戶 並指定要用於發出要求的選項

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


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