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

API Chỉ đường 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 sử dụng Directions API

Với API Chỉ đường, bạn có thể xem đường đi cho một số 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 Chỉ đường?

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

  • Thông tin chỉ đường cho một số phương tiện đi lại, bao gồm phương tiện công cộng, ô tô, đi bộ hoặc đi xe đạp.
  • Chỉ đường nhiều phần bằng một loạt điểm trung gian.
  • Chỉ định điểm xuất phát, điểm đến và điểm trung gian theo nhiều cách, bao gồm cả dưới dạng chuỗi văn bản (ví dụ: "Chicago, IL" hoặc "Darwin, NT, Australia"), mã nhận dạng vị trí hoặc toạ độ vĩ độ/kinh độ.

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

API chỉ đường trả về các tuyến đường hiệu quả nhất khi tính toán đường đi. Sản phẩm này xem xét các yếu tố sau đây của chuyến đi 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 API Chỉ đườ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ề
Đường đi

Cung cấp điểm xuất phát và điểm đến ở dạng mã địa điểm, địa chỉ hoặc toạ độ vĩ độ/kinh độ. Hãy xem các thông số bắt buộc để biết thông tin chi tiết.

Chỉ dẫn chi tiết, được chia thành các tuyến, chặng và bước. Hãy xem phần Phản hồi về đường đi để biết thông tin chi tiết.
  • JSON
  • XML

Cách sử dụng API Chỉ đường

1 Thiết lập. Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất hướng dẫn thiết lập theo sau.
2 Dùng thử bản minh hoạ Sau khi có khoá API và dự án trên đám mây, bạn có thể dùng thử bản minh hoạ về chỉ đường mà không tốn 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 mà 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à quy định hạn chế về tuyến đường. 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 phản hồi dữ liệu để chuẩn bị sử dụng dữ liệu chỉ đường cho ứng dụng của bạn. Hãy xem phần Phản hồi chỉ đường để 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 toán khoảng cách và thời gian di chuyển.

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

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 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