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

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

API Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để có thể làm quen với API và các lựa chọn API:

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à một trường không bắt buộc, nhưng nếu bạn bỏ qua trường này, Address Validation API 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. Để xem danh sách các khu vực được hỗ trợ, hãy tham khảo phần 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 thấp hơn của địa chỉ.

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 của mã (CASS™) để hỗ trợ và chứng nhận các nhà cung cấp dịch vụ xác thực địa chỉ.

Chỉ đối với các khu vực ở Hoa Kỳ và Puerto Rico, bạn có thể bật quy trình xử lý CASS bằng cách đặt enableUspsCass thành 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 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 đưa ra các yêu cầu mẫu để có thể làm quen với API và các lựa chọn API.

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

2. Bạn có thể chỉnh sửa các tham số yêu cầu (không bắt buộc).

3. 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 dùng để đưa ra yêu cầu.

4. Trong bảng điều khiển APIs Explorer, hãy chọn biểu tượng toàn màn hình fullscreen để mở rộng cửa sổ APIs Explorer.