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 đồ. API 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ột 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 sử dụng API Đường

Với API Đường, 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 đường khác. Với siêu dữ liệu đường này, bạn có thể cải thiện ứ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 đườ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 API Đường

Với Roads API, bạn có thể liên kết tọa độ 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.

  • Căn chỉnh theo đường Dịch vụ này trả về những con đường có khả năng cao nhất là đã đi qua 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. 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, dẫn đến một đường dẫn tuân theo hình học của đường một cách mượt mà.
  • Đườ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 nằm trên 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 Premium của Nền tảng Google Maps đã chuyển sang mức giá trả theo mức sử dụng, tính năng này vẫn 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 đường dẫn, đoạn đường hoặc dữ liệu giới hạn tốc độ. Ví dụ sau đây cho thấy một yêu cầu về những 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 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 trả về
Căn chỉnh theo đường

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 trên đường cùng với mã địa điểm. Xem thông tin chi tiết trong phần Phản hồi trong hướng dẫn Căn chỉnh 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 của con đường gần nhất cho 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 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 tệp này chứa giới hạn tốc độ và mã nhận dạng vị trí, với đơn vị là km/giờ hoặc dặm/giờ. 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ụng API Đường

1 Dùng thử bản minh hoạ về tính năng căn chỉnh với đường Nhấp vào bản minh hoạ để tạo một bản đồ và xem cách điểm cuối chụp nhanh đường cung cấp dữ liệu mượt mà. Xem Bản minh hoạ trong hướng dẫn Căn chỉnh với đường. 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 Google Cloud rồi hoàn tất hướng dẫn thiết lập theo sau, sau đó tìm hiểu cách sử dụng khoá API.
3 Thử yêu cầu chụp nhanh đường Sử dụng một trong các ví dụ về tính năng chụp nhanh đường 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 tuyến đường của bạn Sử dụng cùng dữ liệu đường dẫn mà bạn đã cung cấp cho yêu cầu chụp nhanh đường, hãy đưa ra truy vấn về giới hạn tốc độ. Xem Yêu cầu mẫu sử dụ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 Kiến thức nâng cao.
6 Tích hợp dữ liệu đường bộ vào ứng dụng của riêng bạn! Xem ví dụ về mã chi tiết từ bản minh hoạ đường chụp nhanh để 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.

Các thư viện ứng dụng hiện có

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ụ Maps của Google là các thư viện ứng dụng do cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp 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.

Bước tiếp theo