傳送 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
,請在此納入。 如需支援的區域清單,請參閱支援地區。addressLines
:必要。包含說明較低地址的陣列 地址結構
請參閱參考指南中的 PostalAddress。 |
USPS CASSTM 選項
美國郵政署 (USPS®)1 負責維護 使用程式設計準確率支援系統 (CASSTM) 提供支援和認證 地址驗證供應商
如果是僅限美國和公關區域,您可以藉由設定方式啟用 CASS 處理
要求主體中的 enableUspsCass
到 true
。為了在使用網路時獲得最佳效果
CASS:提供地址,請一併註明門牌號碼和門牌號碼
城市、州和郵遞區號:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
試試看!
API Explorer 可讓您提出請求範例 熟悉 API 和 API 選項
選取 API 圖示
。 網頁右側。
視需要展開「Show Standard parameters」(顯示標準參數),然後設定
fields
參數設為欄位 遮罩。視需要編輯「要求主體」。
選取「執行」按鈕。在對話方塊中,選擇要執行哪項帳戶的帳戶 並指定要用於發出要求的選項
在 API Explorer 面板中,選取展開圖示
,展開「API Explorer」視窗。
-
Google 地圖平台是非專屬授權的美國授權人 郵政服務®。下列商標的所有人為美國 Postal Service®,取得許可的情況下使用:United States Postal Service®、 CASSTM、CASS CertifiedTM。↩