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:

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"]
  },
}

Trình khám phá API cho phép bạn tạo các yêu cầu trực tiếp để làm quen với API và các tuỳ chọn API:

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®)1 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 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 sử dụng để gửi yêu cầu.

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

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