發送 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®)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 地圖平台是美國郵政署(Postal Service®) 的非專屬執照。下列商標的擁有者為 United States Postal Service®,且已獲授權使用:United States Postal Service®、CASSTM、CASS CertifiedTM。↩