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. Dịch vụ này chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ cũng như một mã địa điểm, hoặc chuyển đổi toạ độ vĩ độ và kinh độ hoặc một 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 để lấy 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 phiên bản 4 này bao gồm việc phát hành các điểm cuối sau:

Bạn có thể kiểm soát vị trí xuất hiện của kết quả và giới hạn kết quả trong một khu vực, quận hoặc mã bưu chính cụ thể.

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

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

  • Mã hoá địa lý: Chuyển đổi địa chỉ (chẳng hạn như "1600 Amphitheatre Parkway, Mountain View, CA") thành toạ độ vĩ độ và kinh độ hoặc mã địa điểm. Bạn có thể 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ị.
  • Địa lý mã hoá ngược: Chuyển đổi toạ độ (vĩ độ và kinh độ) hoặc Mã địa điểm thành một đị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ả giao hàng hoặc đến lấy 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 điểm cuối 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ỉ, các thành phần địa chỉ và loại địa chỉ. Xem tài liệu Phản hồi mã hoá địa lý.
  • JSON
Mã hoá địa lý ngược Trả về địa chỉ, các thành phần địa chỉ và loại địa chỉ. Xem tài liệu Phản hồi mã hoá địa lý ngược.
Mã hoá địa lý cho địa điểm Trả về địa chỉ, các thành phần địa chỉ và loại địa chỉ. Hãy xem tài liệu Phản hồi mã hoá địa lý của đị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ìm kiếm điểm đến.

Các tính năng trong Geocoding API phiên bản 4

Geocoding API phiên bản 4 cung cấp những tính năng mới sau.

Điểm cuối tìm kiếm điểm đến

v4 giới thiệu một Điểm cuối 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 bản tóm tắt dựa trên AI và mã thông báo điểm điều hướng chứa thông tin theo bối cảnh có thể được truyền đến Navigation SDK để định tuyến chính xác.

Được triển khai trên nền tảng tiêu chuẩn của Google Cloud

Geocoding API phiên bản 4 đượ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 lại mức độ nhất quán giữa các API, giúp cải thiện hiệu quả phát triển bằng Geocoding API phiên bản 4.

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

Geocoding API phiên bản 4 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ạ cho 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 điểm cuối Mã hoá địa lý một địa chỉ, Mã hoá địa lý một vị trí và Mã hoá địa lý địa điểm, theo mặc định, tất cả các trường trong đối tượng phản hồi đều được trả về. Đối với điểm cuối Tìm kiếm điểm đến, bạn phải chỉ định một mặt nạ trường trong yêu cầu API.

Không mất phí sử dụng trong thời gian Dùng thử

Geocoding API phiên bản 4 đang ở giai đoạn Xem trước trước khi phát hành công khai và bạn không phải trả phí khi sử dụng API trong giai đoạn Xem trước. Các lệnh gọi API sẽ xuất hiện trên trang Thanh toán trong Cloud Console, nhưng các khoản phí sẽ là 0 USD.

Phản hồi

Đây là một tính năng Xem trước. Chúng tôi rất mong nhận được ý kiến phản hồi tại địa chỉ geocoding-feedback-channel@google.com.