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 đồ. Dịch vụ này sử dụng các điểm này để tìm các đoạn đường lân cận và trả về Mã địa điểm cùng với siêu dữ liệu như đoạn đường gần nhất và giới hạn tốc độ.

Lý do nên sử dụng Roads API

Với Roads API, bạn có thể nhận được giới hạn tốc độ, thời gian đến dự kiến hoặ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ể cải thiện các ứng dụng lái xe bằng các tính năng sau:

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

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

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

  • Snap to Roads Dịch vụ này trả về những con đường có khả năng được di chuyển nhiều nhất dựa trên tập hợp 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. Ngoài ra, bạn cũng có thể yêu cầu dịch vụ này nội suy thêm các điểm, tạo ra một đường dẫn mượt mà theo hình học của đường.
  • Nearest Roads 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 mà bạn chỉ định không cần phải thuộc một đườ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 độ được đăng cho một đoạn đường. Dịch vụ Giới hạn tốc độ được cung cấp 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 sử dụng Gói cao cấp của Google Maps Platform đã chuyển sang mô hình giá trả tiền theo mức dùng, tính năng này vẫn hoạt động.

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

Roads API 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 đi, đ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ề các con đườ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 Roads API 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 trả về
Snap to roads

Trả về một mảng gồm tối đa 100 điểm GPS từ một tuyến đường. Bao gồm toạ độ kinh độ/vĩ độ được điều chỉnh theo đường cùng với mã địa điểm. Xem thông tin chi tiết trong Phản hồi trong hướng dẫn Snap to roads.
  • JSON
Nearest roads

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 mỗi điểm được chỉ định. Các điểm không cần phải liên tục. Xem thông tin chi tiết trong Phản hồi trong hướng dẫn Nearest roads.
Speed limits

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

Cách sử dụng Roads API

1 Dùng thử bản minh hoạ snap to roads Nhấp vào bản minh hoạ để tạo một tuyến đường và xem cách điểm cuối snap to roads cung cấp dữ liệu mượt mà. Xem Bản minh hoạ trong hướng dẫn Snap to roads. Bạn không cần khoá API.
2 Thiết lập Bắt đầu bằng cách Thiết lập dự án trên đám mây của Google và hoàn tất hướng dẫn thiết lập tiếp theo, sau đó tìm hiểu cách sử dụng khoá API.
3 Thử yêu cầu snap to roads Sử dụng một trong các ví dụ về snap to roads và thử một ví dụ liên quan đến trường hợp sử dụng của bạn.
4 Nhận giới hạn tốc độ cho đường đi của bạn Sử dụng cùng một dữ liệu đường dẫn mà bạn đã cung cấp cho yêu cầu snap to roads, hãy đưa ra một truy vấn về giới hạn tốc độ. Xem phần Yêu cầu mẫu bằng đường dẫn.
5 Tìm hiểu cách xử lý các đường dẫn dài Làm theo các phần 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ề đường vào ứng dụng của riêng bạn! Xem ví dụ chi tiết về mã từ bản minh hoạ về đường được điều chỉnh để bắt đầu xây dựng chức năng dữ liệu về đường vào ứng dụng của riêng bạn.

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

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 Go và Ứng dụng Node.js cho Dịch vụ Google Maps là các thư viện ứng dụng do cộng đồng hỗ trợ, được cung cấp dưới dạng mã nguồn mở theo Giấy phép Apache 2.0. Tải các thư viện này xuống từ GitHub, nơi bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Bước tiếp theo