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:

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

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®)1 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ỉ.

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
}

  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.