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 bằng vĩ độ/kinh độ của một hoặc nhiều điểm trên bản đồ. Công cụ này sử dụng điểm để tìm đ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 chẳng hạn như đoạn đường gần nhất và giới hạn tốc độ.

Tại sao nên sử dụng API đường

Với API đường, bạn có thể nhận được giới hạn tốc độ, ước tính thời gian đến hoặc siêu dữ liệu khác về đường. Có đường này siêu dữ liệu, bạn có thể cải thiện ứng dụng hỗ trợ lái xe bằng các khả năng sau:

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

Bạn có thể thực hiện những gì với API đường

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

  • Bám theo đường Dịch vụ này có khả năng trả về nhiều nhất đường đi dựa trên tập hợp toạ độ GPS được cung cấp. Bạn có thể chỉ định tối đa 100 Các đ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 đường dẫn thuận lợi theo hình học của con đường.
  • Đường gần nhất Dịch vụ này trả về đườ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 trong đườ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 độ cho đ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 Gói cao cấp của Nền tảng Google Maps những khách hàng đã chuyển đổi sang định giá trả tiền theo mức dùng, tính năng này vẫn giữ nguyên đang hoạt động.

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

API đường sử dụng ba điểm cuối chấp nhận vĩ độ/kinh độ toạ độ 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 yêu cầu về đường gần nhất dựa trên một tập hợp 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 Road API cùng với dữ liệu mà nó trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Điều 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 toạ độ kinh độ/vĩ độ do đường cố định dọc theo bằng mã địa điểm. Xem chi tiết trong Phản hồi trong thẻ Nắm bắt đường của chúng tôi.

  • 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 đườ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. Xem chi tiết trong Phản hồiĐường gần nhất của chúng tôi.

Giới hạn tốc độ

Một mảng gồm tối đa 100 phần tử siêu dữ liệu đường. Các định dạng này có chứa thông tin về tốc độ giới hạn và mã địa điểm, với đơn vị tính theo KPH hoặc MPH. Xem chi tiết trong phần Câu trả lời trong Giới hạn tốc độ của chúng tôi.

Cách sử dụng Road API (API Đường)

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

Thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ của thông qua một trong các thư viện ứng dụng sau đây:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Google Maps Các dịch vụ là thư viện ứng dụng được cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp đó 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.

Các bước tiếp theo