向下列其中一個端點發出 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 選項
United States Postal Service® (USPS®)1 負責維護程式設計正確性支援系統 (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 選項
選取頁面右側的 API 圖示 。
視需要展開「Show standard parameters」,並將
fields
參數設為欄位遮罩。視需要編輯要求主體。
選取「執行」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。
在 API Explorer 面板中選取展開圖示 ,展開 API Explorer 視窗。
-
Google 地圖平台是美國郵政服務®的非專屬被授權人。下列商標為美國郵政服務® 所有,且經授權使用:United States Postal Service®、CASSTM、CASS CertifiedTM。↩