Gửi yêu cầu xác thực địa chỉ

Gửi yêu cầu xác thực địa chỉ bằng cách đưa ra yêu cầu POST đến một trong các điểm cuối sau:

• validateAddress (REST)
• ValidateAddress (gRPC)

Yêu cầu của bạn cũng phải truyền phần nội dung yêu cầu JSON đến yêu cầu xác định địa chỉ cần xác thực. Nội dung yêu cầu sau đây chứa một trường và ba trường con:

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"

Bạn cũng có thể bỏ qua locality và chỉ định locality làm phần tử trong mảng addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Hãy làm thử!

Các trường yêu cầu địa chỉ

Nội dung yêu cầu bao gồm một trường duy nhất:

• address – một trường thuộc loại PostalAddress, phải chứa ít nhất một mục trong addressLines.

Khi gửi trường address đến Address Validation API, bạn chỉ cần cung cấp một trường: addressLines. Tuy nhiên, yêu cầu địa chỉ đơn giản nhất phải chứa các trường con sau:

• regionCode – Nên dùng. Đây là trường không bắt buộc, nhưng nếu bạn bỏ qua, API Xác thực địa chỉ sẽ suy luận khu vực từ địa chỉ. Tuy nhiên, để có kết quả tốt nhất, hãy thêm regionCode nếu bạn biết. Để biết danh sách các khu vực được hỗ trợ, hãy xem phần khu vực được hỗ trợ.
• addressLines – Bắt buộc. Một mảng có địa chỉ mô tả cấu trúc thấp hơn của địa chỉ.

Xem PostalAddress trong hướng dẫn tham khảo.

Lựa chọn USPS CASS™

Dịch vụ Bưu chính Hoa Kỳ® (USPS®)¹ duy trì Hệ thống hỗ trợ độ chính xác mã hoá (CASS™) để hỗ trợ và chứng nhận các nhà cung cấp dịch vụ xác thực địa chỉ.

Chỉ dành cho các khu vực Hoa Kỳ và Puerto Rico, bạn có thể bật tính năng xử lý CASS bằng cách đặt enableUspsCass thành true trong phần nội dung yêu cầu. Để có kết quả tốt nhất khi sử dụng CASS, hãy cung cấp địa chỉ bao gồm tên đường và số nhà cùng với thành phố, tiểu bang và mã bưu chính:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Hãy dùng thử!

Trình khám phá API cho phép bạn tạo các yêu cầu mẫu để bạn có thể làm quen với API và các tuỳ chọn API.

1. Chọn biểu tượng API, , ở bên phải trang.

2. Bạn có thể mở rộng phần Hiện các tham số chuẩn và đặt tham số fields thành mặt nạ trường.

3. Chỉnh sửa Phần nội dung yêu cầu (không bắt buộc).

4. Chọn nút Thực thi. Trong hộp thoại, hãy chọn tài khoản mà bạn muốn sử dụng để gửi yêu cầu.

5. Trong bảng điều khiển API Explorer (Trình khám phá API), hãy chọn biểu tượng mở rộng, , để mở rộng cửa sổ API Explorer.