Tài liệu tham khảo nhanh về Address Validation API

Address Validation API chấp nhận một địa chỉ, xác định các thành phần của địa chỉ đó và xác thực các thành phần đó, chuẩn hoá địa chỉ để gửi thư và trả về toạ độ vĩ độ/kinh độ đã biết chính xác nhất cho địa chỉ đó. Đối với địa chỉ ở Hoa Kỳ và Puerto Rico, bạn có thể bật quy trình xử lý CASS của USPS (không bắt buộc).

Address Validation API: thông tin chính

  • Sản phẩm: Address Validation API
  • Danh mục: Địa điểm
  • Nền tảng: Dịch vụ web (REST)
  • Chạy trên: Máy chủ (mã phụ trợ)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về Address Validation API
  • Phạm vi cung cấp theo khu vực: Có giới hạn. Các quốc gia được hỗ trợ và chất lượng dữ liệu sẽ khác nhau tuỳ theo quốc gia, và một số quốc gia đang ở giai đoạn Xem trước. Siêu dữ liệu về khu dân cư và khu thương mại chỉ được trả về cho những quốc gia được gắn cờ trên trang phạm vi bao phủ. USPS CASS chỉ được hỗ trợ ở Hoa Kỳ và Puerto Rico. (thông tin chi tiết về phạm vi bảo hiểm)

Address Validation API: thời điểm sử dụng

Sử dụng Address Validation API khi:

  • Bạn cần kiểm tra xem một địa chỉ có phải là địa điểm thực hay không và tìm xem thành phần nào bị thiếu hoặc có thể bị sai.
  • Bạn cần chuẩn hoá và hoàn tất địa chỉ gửi thư, chẳng hạn như trong quy trình thanh toán.
  • Bạn cần có quy trình xác thực được CASS của USPS chứng nhận và uspsData cho các địa chỉ ở Hoa Kỳ hoặc Puerto Rico.
  • Bạn cần có siêu dữ liệu về địa chỉ nhà riêng hoặc địa chỉ doanh nghiệp cho một quốc gia có trong danh sách trên trang phạm vi áp dụng.

Không sử dụng Address Validation API khi:

  • Bạn chỉ cần chuyển đổi địa chỉ thành vĩ độ/kinh độ và không cần xác thực từng thành phần địa chỉ. Thay vào đó, hãy sử dụng Geocoding API.
  • Bạn cần thông tin chi tiết về điểm đến theo vị trí cụ thể, chẳng hạn như lối vào toà nhà, đường viền toà nhà hoặc điểm điều hướng. Thay vào đó, hãy sử dụng Geocoding API.

Address Validation API: thiết lập

Các gói Address Validation API chính thức:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: các lỗi thường gặp

  • Vấn đề: Thuộc tính addressComplete bị bỏ qua trong kết quả khi giá trị của thuộc tính này là false, vì vậy, mã dự kiến trường này xuất hiện có thể đọc sai địa chỉ chưa hoàn chỉnh. Cách khắc phục: Coi thuộc tính addressComplete bị thiếu là false hoặc kiểm tra xem thuộc tính đó có tồn tại hay không. Xem /maps/documentation/address-validation/understand-response.
  • Vấn đề: Nếu bạn bỏ qua regionCode, API sẽ suy luận khu vực từ địa chỉ, điều này có thể cho kết quả kém chính xác hơn. Cách khắc phục: Thêm regionCode vào PostalAddress khi bạn biết. Hãy xem /maps/documentation/address-validation/requests-validate-address.
  • Vấn đề: Đối tượng uspsData không được đảm bảo sẽ được điền đầy đủ thông tin cho mọi địa chỉ đã xác thực ở Hoa Kỳ. Cách khắc phục: Đừng chỉ dựa vào uspsData làm tín hiệu xác thực duy nhất; hãy sử dụng cả kết quả và thành phần địa chỉ. Hãy xem /maps/documentation/address-validation/handle-us-address.
  • Vấn đề: Ý kiến phản hồi được gửi bằng provideValidationFeedback phải tham chiếu đến responseId từ lệnh gọi validateAddress đầu tiên trong trình tự, chứ không phải lệnh gọi sau. Cách khắc phục: Lưu trữ responseId từ phản hồi validateAddress đầu tiên và gửi trong yêu cầu phản hồi. Xem /maps/documentation/address-validation/handle-updated-address.

Những việc bạn có thể làm với Address Validation API

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.