Tổng quan về Geocoding API phiên bản 4

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

Geocoding API là một dịch vụ chấp nhận một địa điểm dưới dạng địa chỉ, toạ độ vĩ độ và kinh độ hoặc Mã địa điểm. API này chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ và Mã địa điểm, hoặc chuyển đổi toạ độ vĩ độ và kinh độ hoặc Mã địa điểm thành địa chỉ.

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

Bạn có thể sử dụng Geocoding API để thu thập dữ liệu mã hoá địa lý cho một hoặc nhiều địa chỉ hoặc địa điểm, bao gồm cả những dữ liệu sau:

Bản phát hành Geocoding API v4 này bao gồm bản phát hành các điểm cuối sau:

Bạn có thể kiểm soát vị trí hiển thị kết quả và giới hạn kết quả cho một vùng, quận hoặc mã bưu chính cụ thể.

Xem bản minh hoạ

Cách hoạt động của Geocoding API

Geocoding API thực hiện cả mã hoá địa lý và mã hoá địa lý ngược:

  • Mã hoá địa lý: Chuyển đổi các địa chỉ như "1600 Amphitheatre Parkway, Mountain View, CA" thành toạ độ vĩ độ và kinh độ hoặc Mã địa điểm. Bạn có thể sử dụng các toạ độ này để đặt điểm đánh dấu trên bản đồ hoặc để căn giữa hoặc định vị lại bản đồ trong khung hiển thị.
  • Mã hoá địa lý ngược: Chuyển đổi toạ độ vĩ độ và kinh độ hoặc Mã địa điểm thành địa chỉ mà con người có thể đọc được. Bạn có thể sử dụng địa chỉ cho nhiều trường hợp, bao gồm cả việc giao hàng hoặc nhận hàng.

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Geocoding API cùng với dữ liệu mà mỗi phương thức trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Mã hoá địa lý Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem tài liệu về phản hồi Geocode.
  • JSON
Mã hoá địa lý ngược Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem tài liệu về phản hồi mã hoá địa lý ngược.
Mã hoá địa lý địa điểm Trả về địa chỉ, thành phần địa chỉ và loại địa chỉ. Xem tài liệu về phản hồi mã hoá địa lý địa điểm.
Tìm kiếm điểm đến Trả về thông tin chi tiết về nhiều điểm đến dựa trên các tiêu chí đầu vào khác nhau, chẳng hạn như địa chỉ, Mã địa điểm hoặc toạ độ vĩ độ và kinh độ. Xem tài liệu về tính năng Tìm kiếm điểm đến documentation.

Các tính năng trong Geocoding API v4

Phiên bản 4 của Geocoding API cung cấp các tính năng mới sau.

Phương thức Tìm kiếm điểm đến

v4 giới thiệu phương thức Tìm kiếm điểm đến cho phép bạn truy xuất thông tin chi tiết về nhiều điểm đến dựa trên các tiêu chí đầu vào khác nhau, chẳng hạn như địa chỉ, Mã địa điểm hoặc toạ độ vĩ độ và kinh độ. Phản hồi bao gồm các bản tóm tắt do AI cung cấp và mã thông báo điểm điều hướng chứa thông tin theo ngữ cảnh có thể được truyền đến SDK Điều hướng để định tuyến chính xác.

Triển khai trên nền tảng tiêu chuẩn của Google Cloud

Geocoding API v4 được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Việc triển khai này mang đến một nền tảng an toàn và đáng tin cậy hơn với các lựa chọn bảo mật nâng cao như OAuth. Thiết kế API tiêu chuẩn này mang đến mức độ nhất quán trên các API giúp cải thiện hiệu quả của quá trình phát triển bằng Geocoding API v4.

Đã thêm tính năng hỗ trợ OAuth

Geocoding API v4 hỗ trợ việc sử dụng OAuth 2.0 để xác thực. Google hỗ trợ các trường hợp OAuth 2.0 phổ biến, chẳng hạn như các trường hợp dành cho máy chủ web.

Đã thêm tính năng hỗ trợ mặt nạ trường

Sử dụng mặt nạ trường để chỉ định thông tin mà phản hồi sẽ trả về. Đối với các phương thức Mã hoá địa lý một địa chỉ, Mã hoá địa lý một vị trí và Mã hoá địa lý địa điểm, tất cả các trường trong đối tượng phản hồi đều được trả về theo mặc định. Đối với phương thức Tìm kiếm điểm đến, bạn phải chỉ định mặt nạ trường trong yêu cầu API.

Bảo mật API

Geocoding API v4 được thiết kế dưới dạng API từ máy chủ đến máy chủ. Các lệnh gọi trực tiếp phía máy khách từ trình duyệt khiến khoá API gặp rủi ro đáng kể về việc bị đánh cắp và sử dụng sai mục đích, vì các hạn chế về HTTP referrer không đủ để bảo vệ các điểm cuối dịch vụ web.

Bạn nên gọi Geocoding API v4 từ máy chủ phụ trợ của riêng mình. Để biết thêm thông tin chi tiết về các mẫu triển khai an toàn và các lựa chọn thay thế cho nhu cầu phía máy khách, hãy xem phần Cân nhắc về bảo mật.