請向下列任一端點發出 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 維護編碼準確性支援系統 (CASS™),以便支援和認證地址驗證服務供應商。
針對僅限美國和 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 選項。
選取頁面右側的 API 圖示 。
您可以選擇展開「顯示標準參數」,然後將
fields
參數設為欄位遮罩。您可以選擇編輯要求主體。
選取「執行」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。
在「API Explorer」面板中選取展開圖示 ,展開「API Explorer」視窗。
-
Google 地圖平台是 United States Postal Service® 的非專屬授權使用者。以下商標由 United States Postal Service® 所有,並經過授權使用:United States Postal Service®、CASS™、CASS Certified™。↩