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 gửi yêu cầu POST cho 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 chuyể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. Phần nội dung yêu cầu sau đây chứa một trường và 3 trường phụ:

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 hàm này là một phần tử trong mảng addressLines:

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

Hãy làm thử!

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ại ít nhất một mục nhập trong addressLines.

Khi gửi trường address đến API xác thực địa chỉ, 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 phụ sau:

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

Lựa chọn USPS CASS™

United States Postal Service® (USPS®)¹ duy trì Hệ thống hỗ trợ độ chính xác lập trình (CASSTM) để hỗ trợ và chứng nhận nhà cung cấp dịch vụ xác thực địa chỉ.

Bạn có thể bật tính năng xử lý CASS bằng cách cài đặt (chỉ ở Hoa Kỳ và khu vực Quan hệ công chúng) enableUspsCass đến true trong 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 cả số nhà và số nhà cùng với thành phố, tiểu bang và mã ZIP:

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

Hãy dùng thử!

API Explorer cho phép bạn thực hiện các yêu cầu mẫu để mà 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 của trang.

2. Mở rộng tuỳ chọn Hiển thị các tham số chuẩn và đặt fields tham số vào trường mặt nạ.

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, chọn tài khoản mà bạn muốn sử dụng để đưa ra yêu cầu.

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