Tổng quan về API hướng dẫn

API đường đi là một dịch vụ chấp nhận yêu cầu HTTP và trả về đường đi theo định dạng JSON hoặc XML giữa các vị trí.

Lý do bạn nên sử dụng API Hướng dẫn

Với API Chỉ đường, bạn có thể xem đường đi cho một số phương thức di chuyển, chẳng hạn như phương tiện công cộng, lái xe, đi bộ hoặc đi xe đạp.

Bạn có thể làm gì với API Hướng dẫn?

Với API Đường đi, bạn có thể tính toán thông tin đường đi giữa các vị trí, bao gồm cả những thông tin chi tiết sau đây:

  • Chỉ đường cho một số phương thức di chuyển, bao gồm phương tiện công cộng, lái xe, đi bộ hoặc đi xe đạp.
  • Chia thành nhiều phần chỉ đường bằng một loạt các điểm tham chiếu.
  • Chỉ định điểm gốc, điểm đến và điểm tham chiếu theo nhiều cách, bao gồm cả chuỗi văn bản (ví dụ: "Chicago, IL" hoặc "Darwin, NT, Australia"), mã địa điểm hoặc vĩ độ/kinh độ.

Cách hoạt động của API Hướng dẫn

API Đường đi sẽ trả về các tuyến hiệu quả nhất khi tính toán đường đi. Sản phẩm tính đến các yếu tố du lịch sau đây khi xác định tuyến đường hiệu quả nhất:

  • Thời gian di chuyển (chính)
  • Khoảng cách
  • Số lượt rẽ

Yêu cầu mẫu sau đây trả về thông tin chỉ đường lái xe từ Toronto, Ontario đến Montreal, Quebec ở định dạng JSON:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &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 chỉ đường cùng với dữ liệu mà API đó trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Đường đi

Cung cấp điểm bắt đầu và điểm đến dưới dạng mã địa điểm, địa chỉ hoặc toạ độ vĩ độ/kinh độ. Xem các tham số bắt buộc để biết thông tin chi tiết.

Thông tin đường đi chi tiết, chia thành tuyến đường, chân và bước. Xem phần Phản hồi chỉ đường để biết thông tin chi tiết.
  • JSON
  • XML

Cách sử dụng API Hướng dẫn

1 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 các hướng dẫn thiết lập sau đó.
2 Dùng thử bản minh hoạ Sau khi có khoá API và một dự án trên đám mây, bạn sẽ dùng thử bản minh hoạ hướng dẫn mà không tốn phí. Xem Bản minh hoạ API Hướng dẫn.
3 Tạo yêu cầu Hãy xem các yêu cầu mẫu và tìm hiểu về các tuỳ chọn mà bạn có thể cung cấp, chẳng hạn như chế độ đi lại, điểm tham chiếu và quy định hạn chế về tuyến đường. Xem Ví dụ về chỉ đường.
4 Tìm hiểu thông tin cơ bản về cách phản hồi Khám phá các phản hồi về dữ liệu để chuẩn bị sử dụng dữ liệu về đường đi cho ứng dụng của bạn. Xem Phản hồi về đường đi để biết thông tin chi tiết.
5 Kết hợp dữ liệu về đường đi vào ứng dụng của riêng bạn! Bạn có thể sử dụng dữ liệu này để tính khoảng cách và thời gian di chuyể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. 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.

Các bước tiếp theo