Tổng quan về API Đường

Roads API là một dịch vụ chấp nhận các yêu cầu HTTPS có toạ độ vĩ độ/kinh độ cho một hoặc nhiều điểm trên bản đồ. Ứng dụng này sử dụng các điểm này để tìm các đoạn đường gần đó và trả về mã địa điểm cùng với siêu dữ liệu chẳng hạn như đoạn đường gần nhất và giới hạn tốc độ.

Lý do sử dụngAPI Đường

Với API Đường, bạn có thể xem giới hạn tốc độ, thời gian đến dự kiến hoặc các siêu dữ liệu khác về đường. Với siêu dữ liệu về đường này, bạn có thể nâng cao ứng dụng lái xe của mình với các tính năng sau:

  • Kết nối toạ độ vĩ độ/kinh độ với đường hoặc những con đường.
  • Tìm đường gần nhất cho một tập hợp các toạ độ
  • Xem giới hạn tốc độ cho các đoạn đường

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

Với Roads API, bạn có thể lập bản đồ toạ độ GPS theo hình học của đường và xác định giới hạn tốc độ trên các đoạn đường.

  • Bám theo đường Dịch vụ này trả về những con đường có nhiều khả năng đã đi nhất dựa trên bộ toạ độ GPS được cung cấp. Bạn có thể chỉ định tối đa 100 điểm GPS được thu thập dọc theo một tuyến đường. Nếu muốn, bạn cũng có thể yêu cầu dịch vụ nội suy các điểm bổ sung, tạo ra một đường đi mượt mà theo hình dạng của đường.
  • Đường gần nhất Dịch vụ này trả về đoạn đường gần nhất cho một điểm GPS. Bạn có thể chỉ định tối đa 100 điểm GPS. Các điểm bạn chỉ định không cần phải là một phần của đường dẫn liên tục.
  • Giới hạn tốc độ Dịch vụ này trả về giới hạn tốc độ đã đăng cho một đoạn đường. Dịch vụ Giới hạn tốc độ dành cho tất cả khách hàng có giấy phép Theo dõi tài sản. Đối với những khách hàng Gói cao cấp của Nền tảng Google Maps đã chuyển đổi sang hình thức trả tiền theo mức dùng, tính năng này vẫn sẽ hoạt động.

Cách hoạt động của API Đường

API đường sử dụng 3 điểm cuối chấp nhận toạ độ vĩ độ/kinh độ hoặc mã địa điểm để cung cấp dữ liệu về đường, đoạn đường hoặc giới hạn tốc độ. Ví dụ sau đây cho thấy một yêu cầu về đường gần nhất dựa trên một tập hợp toạ độ vĩ độ/kinh độ:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Tài nguyên

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

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng của yêu cầu trả lại hàng
Bám theo các đường đi

Trả về một mảng gồm tối đa 100 điểm GPS từ một tuyến đường. Bao gồm các toạ độ kinh độ/vĩ độ được chụp nhanh cùng với mã địa điểm. Hãy xem thông tin chi tiết trong phần Phản hồi trong hướng dẫn Bám theo đường.
  • JSON
Đường gần nhất

Một mảng gồm tối đa 100 toạ độ vĩ độ/kinh độ độc lập cùng với mã địa điểm cho con đường gần nhất đối với từng điểm được chỉ định. Các điểm không cần phải liên tục. Hãy xem thông tin chi tiết trong phần Phản hồi trong hướng dẫn về Đường gần nhất.
Giới hạn tốc độ

Một mảng gồm tối đa 100 phần tử siêu dữ liệu về đường. Các tham số này chứa giới hạn tốc độ và mã địa điểm, với đơn vị theo KPH hoặc MPH. Hãy xem thông tin chi tiết trong phần Phản hồi trong hướng dẫn về Giới hạn tốc độ.

Cách sử dụngAPI Đường

1 Thử bản minh hoạ chụp nhanh đường Nhấp vào bản minh hoạ để tạo đường đi và xem cách điểm cuối nhanh trên đường cung cấp dữ liệu mượt mà. Xem phần Bản minh hoạ trong hướng dẫn Bám theo đường đi. Bạn không cần khoá API.
2 Thiết lập Hãy bắt đầu từ bước Thiết lập dự án Google Cloud và hoàn thành phần hướng dẫn thiết lập sau đó, sau đó tìm hiểu cách sử dụng khoá API.
3 Thử chụp nhanh yêu cầu đường Dùng một trong những ví dụ chụp nhanh đường đi và thử một ví dụ phù hợp với trường hợp sử dụng của bạn.
4 Xem giới hạn tốc độ cho đường đi Sử dụng cùng một dữ liệu đường dẫn mà bạn đã cung cấp cho yêu cầu chụp nhanh đường, đưa ra truy vấn giới hạn tốc độ. Xem Ví dụ về yêu cầu bằng cách sử dụng đường dẫn.
5 Tìm hiểu cách xử lý đường dẫn dài Hãy làm theo các mục về Xử lý đường dẫn dài trong hướng dẫn Khái niệm nâng cao.
6 Kết hợp dữ liệu về tuyến đường vào ứng dụng của riêng bạn! Hãy xem ví dụ chi tiết về mã từ bản minh hoạ chụp nhanh đường để bắt đầu xây dựng chức năng dữ liệu đường vào ứng dụng của riêng bạn.

Thư viện ứng dụng có sẵn

Hãy gọi API này bằng ngôn ngữ bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng Java, Ứng dụng Python, Ứng dụng khách Go và Ứng dụng Node.js cho Dịch vụ Google Maps là các thư viện ứng dụng được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Hãy tải các dự án này xuống từ GitHub. Tại đây, bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Các bước tiếp theo