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à
uspsDatacho 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
- Dịch vụ cần bật:
addressvalidation.googleapis.com - Xác thực: Khoá API, OAuth 2.0, Tài khoản dịch vụ
- Bắt đầu: Thiết lập Address Validation API
- Tài liệu tham khảo: Tài liệu tham khảo về Address Validation API
- Giá: Mức sử dụng và thanh toán cho Address Validation API
- Chính sách: Chính sách về Address Validation API
- Ghi chú phát hành: Ghi chú phát hành về Address Validation API
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
addressCompletebị 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ínhaddressCompletebị thiếu làfalsehoặ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êmregionCodevàoPostalAddresskhi bạn biết. Hãy xem /maps/documentation/address-validation/requests-validate-address. - Vấn đề: Đối tượng
uspsDatakhô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àouspsDatalà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
provideValidationFeedbackphải tham chiếu đếnresponseIdtừ lệnh gọivalidateAddressđầ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ữresponseIdtừ phản hồivalidateAddressđầ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.
- Trả về một địa chỉ đã xác thực cho một địa chỉ hoặc một phần địa chỉ được chỉ định.
- Trả về toạ độ vĩ độ/kinh độ cho một địa chỉ đã xác thực.
- Trả về giá trị nhận dạng địa điểm trên Google cho một địa chỉ đã xác thực.
- Sử dụng chứng nhận của Hệ thống hỗ trợ về độ chính xác của mã (CASS) của Dịch vụ bưu chính Hoa Kỳ (USPS) để xác thực địa chỉ.
- Trả về thông tin về việc địa chỉ đã xác thực là doanh nghiệp, nơi cư trú hay hộp thư bưu điện.
- Trả về siêu dữ liệu giao hàng của Dịch vụ Bưu chính Hoa Kỳ (USPS) cho một địa chỉ đã xác thực.
- Trả về phiên bản tiếng Anh của một địa chỉ đã xác thực. Xem trước
- Trả về Plus Code cho một địa chỉ đã xác thực.