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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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:

Yêu cầu của bạn cũng phải truyề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 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 thuộc tính này làm một phần tử trong mảng addressLines:

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

APIs 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 tuỳ 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 nhập 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 phụ sau:

  • regionCode – Nên dùng. Đây là trường tuỳ chọn, nhưng nếu bạn bỏ qua, 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 cung cấp 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ó cá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®)1 duy trì Hệ thống hỗ trợ về độ 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 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ã ZIP:

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

Hãy dùng thử!

APIs Explorer 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 api ở bên phải trang.

  2. Chỉnh sửa các tham số yêu cầu (không bắt buộc).

  3. Chọn nút Execute (Thực thi). Trong hộp thoại, hãy chọn tài khoản mà bạn muốn dùng để gửi 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.

  1. Google Maps Platform là Bên được cấp phép không độc quyền của United States Postal Service®. (Các) nhãn hiệu sau đây thuộc quyền sở hữu của United States Postal Service® và được sử dụng khi có sự cho phép: United States Postal Service®, CASS™, CASS Certified™. ↩