Tổng quan về API chỉ đường (Cũ)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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

Lý do nên sử dụng Directions API (cũ)

Với Directions API (Legacy), bạn có thể nhận được đường đi cho nhiều 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.

Những việc bạn có thể làm với Directions API (phiên bản cũ)?

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

  • Đường đi cho nhiều 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 đạp xe.
  • Chỉ đường nhiều phần bằng cách sử dụng một loạt điểm tham chiếu.
  • Chỉ định điểm xuất phát, đ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, Úc"), mã địa điểm hoặc toạ độ vĩ độ/kinh độ.

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

Directions API (Phiên bản cũ) trả về các tuyến đường hiệu quả nhất khi tính toán đường đi. Các yếu tố về sản phẩm trong những 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ề 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 Directions API (cũ) 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 tham số bắt buộc để biết thông tin chi tiết.

Chỉ dẫn chi tiết, chia thành các tuyến đường, chặng đườ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 Directions API (cũ)

1 Thiết lập. Bắt đầu bằng cách Thiết lập dự án trên đám mây của bạn trên Google Cloud và hoàn tất các hướng dẫn thiết lập tiếp theo.
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ạ chỉ đường mà không mất phí. Xem Bản minh hoạ Directions API (cũ).
3 Tạo yêu cầu 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ư chế độ di chuyển, đ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 những kiến thức cơ bản về phản hồ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 riêng 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.

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:

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

Bước tiếp theo