傳送地址驗證要求

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

試試看！

地址要求欄位

要求主體包含單一欄位：

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

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

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

請參閱參考指南中的 PostalAddress。

USPS CASS™ 選項

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

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

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

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

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

試試看！

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

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

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

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

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

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

---

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