傳送地址驗證要求

發送 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"]
  },
}

試試看！

地址要求欄位

要求主體包含一個欄位：

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

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

• regionCode - 建議選項，這是選用欄位，但如果省略，Address Validation API 會從地址推斷區域。但為獲得最佳結果，如果您知道 regionCode，請加入 regionCode。如需支援的區域清單，請參閱支援地區。
• addressLines：必要。包含地址結構較低地址的陣列。

請參閱參考指南中的 PostalAddress。

USPS CASSTM 選項

美國郵政署 (USPS®)¹ 負責維護協調準確性支援系統 (CASSTM)，以支援及認證地址驗證服務供應商。

針對僅限美國和 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 圖示 。

2. 視需要展開「Show Standard parameters」，然後將 fields 參數設為欄位遮罩。

3. 視需要編輯「要求主體」。

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

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