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 đến một trong các điểm cuối sau:

• validateAddress (REST)
• ValidateAddress (gRPC)

Lưu ý: Tài liệu này dùng REST cho các ví dụ, nhưng cách tiếp cận cũng tương tự như 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. 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 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ử!

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 – trường thuộc loại PostalAddress phải chứa í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 nên chứa các trường phụ sau:

• regionCode – Được đề xuất. Đây là trường không bắt buộc, nhưng nếu bị bỏ qua, Address Validation API (API Xác thực địa chỉ) sẽ suy ra khu vực dựa trên đị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 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 dưới của địa chỉ.

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

Tuỳ chọn USPS CASSTM

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

Lưu ý: API Xác thực địa chỉ được xác nhận là dịch vụ được chứng nhận CASSTM. Điều này có nghĩa là dịch vụ được xác nhận về khả năng điền thông tin địa chỉ còn thiếu, chuẩn hoá và cập nhật địa chỉ đó lên địa chỉ mới nhất và chính xác nhất.

Riêng đối với các khu vực Hoa Kỳ và PR, bạn có thể bật quá 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 một địa chỉ bao gồm số nhà 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
}

Lưu ý: Nếu bạn không yêu cầu xử lý CASS hoặc nếu bạn đang xác thực địa chỉ bên ngoài Hoa Kỳ và các khu vực PR, thì bạn không nên bật tính năng này.

Hãy dùng thử!

API Explorer cho phép bạn thực hiện các yêu cầu mẫu để bạn có thể làm quen với các API và các tuỳ chọn API.

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

2. (Không bắt buộc) Mở rộng mục Show standard parameters (Hiện tham số chuẩn) và đặt tham số fields thành mặt nạ trường.

3. Chỉnh sửa Nội dung yêu cầu nếu muốn.

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 dùng để thực hiện 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.

---

1. Google Maps Platform là một Bên được cấp phép không độc quyền của Hoa Kỳ Postal Service®. (Các) nhãn hiệu sau thuộc sở hữu của Hoa Kỳ Postal Service® và được sử dụng với sự cho phép: United States Postal Service®, CASSTM, CASS CertificateTM. ↩