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

Chỉ dẫn API là một dịch vụ chấp nhận yêu cầu HTTP và trả về Chỉ đường ở đị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 Chỉ đường API, bạn có thể tìm chỉ đường cho một số chế độ phương tiện giao thông, 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 chỉ đường, bạn có thể tính toán chỉ đường giữa các vị trí, bao gồm các thông tin chi tiết sau:

  • 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.
  • Chỉ đường nhiều chặng bằng cách sử dụng một loạt điểm tham chiếu.
  • Chỉ định nguồn gốc, đích đến và điểm tham chiếu theo nhiều cách, bao gồm như chuỗi văn bản (ví dụ: "Chicago, IL" hoặc "Darwin, NT, Australia"), đặt Mã hoặc vĩ độ/kinh độ.

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

Chỉ dẫn API trả về các tuyến đường hiệu quả nhất khi tính toán hướng. 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ố vòng

Yêu cầu mẫu sau đây trả về 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 Chỉ đường API 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 nguồn gốc và điểm đến dưới dạng mã địa điểm, địa chỉ, hoặc vĩ độ/kinh độ. Xem các thông số bắt buộc để biết thông tin chi tiết.

Chỉ đường chi tiết, được chia thành các tuyến đường, các chặng và các bước. Xem Phản hồi về đường đi để 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 bằng việc Thiết lập Dự án trên Google Cloud và hoàn tất quá trình thiết lập tiếp theo.
2 Xem bản minh hoạ Sau khi có khoá API và một dự án trên đám mây mà bạn dùng thử bản minh hoạ đường đi mà không mất phí. Xem Bản minh hoạ API chỉ đường.
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 lựa chọn bạn có thể cung cấp, chẳng hạn như phương tiện đi lại, điểm tham chiếu và tuyến đường bị hạn chế. Xem Ví dụ về đường đi.
4 Tìm hiểu thông tin cơ bản về câu trả lời Khám phá các câu trả lời về dữ liệu để chuẩn bị sử dụng dữ liệu chỉ đường 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 Tích hợp dữ liệu chỉ đường vào ứng dụng của 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 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