傳送地址驗證要求

歐洲經濟區 (EEA) 開發人員

如果您的帳單地址位於歐洲經濟區，自 2025 年 7 月 8 日起，使用服務時將適用《 Google Maps Platform 歐洲經濟區服務條款》。功能會因區域而異。 瞭解詳情。

如要傳送地址驗證要求，請向下列其中一個端點發出 POST 要求：

• validateAddress (REST)
• ValidateAddress (gRPC)

注意： 本文件中的範例使用 REST，但方法與 gRPC 類似。

要求也應將 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"]
  },
}

APIs Explorer 可讓您傳送即時要求，熟悉 API 和 API 選項：

試試看！

地址要求欄位

要求主體包含單一欄位：

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

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

• regionCode：建議使用。這是選填欄位，但如果省略，Address Validation API 會從地址推斷區域。不過，為獲得最佳結果，如果您知道 regionCode，請一併提供。如需支援的地區清單，請參閱「支援的地區」。
• addressLines：必要。包含地址的陣列，用於描述地址的較低結構。

請參閱參考指南中的 PostalAddress。

USPS CASS™ 選項

美國郵政署 (USPS®)¹ 設有編碼準確度支援系統 (CASS™)，為地址驗證服務供應商提供支援和認證。

注意： Address Validation API 已確認為 CASS-Certified™ 服務。這表示該服務已確認能填補缺少的地址資訊、將地址標準化，並更新為最新且正確的地址。

僅限美國和波多黎各地區，您可以在要求主體中將 enableUspsCass 設為 true，啟用 CASS 處理功能。使用 CASS 時，為獲得最佳結果，請提供包含街道和門牌號碼，以及城市、州和郵遞區號的地址：

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

注意： 如果您不需要 CASS 處理，或要驗證美國和波多黎各以外地區的地址，Google 建議您不要啟用這項功能。

試試看！

APIs Explorer 可讓您提出範例要求，熟悉 API 和 API 選項。

1. 選取頁面右側的 API 圖示 api。

2. 視需要編輯要求參數。

3. 選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

4. 在 APIs Explorer 面板中，選取全螢幕圖示 fullscreen，展開 APIs Explorer 視窗。

---

1. Google 地圖平台是美國郵政署(United States Postal Service®) 的非專屬授權對象。下列商標為美國郵政署所有，並經授權使用：United States Postal Service®、CASS™、CASS Certified™。↩