傳送地址驗證要求

向下列任一端點發出 POST 要求，傳送地址驗證要求：

• validateAddress (REST)
• ValidateAddress (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™)，以支援及認證地址驗證服務供應商。

只有在美國和波多黎各地區，您才能在要求內文中將 enableUspsCass 設為 true，啟用 CASS 處理程序。使用 CASS 時，如要獲得最佳結果，請提供地址，包括街道和門牌號碼，以及城市、州和郵遞區號：

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

試試看！

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

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

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

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

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