Tài liệu tham khảo nhanh về Directions API

Directions API (Phiên bản cũ) là một dịch vụ web tính toán đường đi giữa các vị trí cho việc lái xe, đi bộ, đi xe đạp và phương tiện công cộng, bao gồm cả các tuyến đường nhiều phần có điểm tham chiếu, đồng thời trả về các tuyến đường, chặng và bước ở định dạng JSON hoặc XML. API này đang ở trạng thái Cũ: kể từ tháng 10 năm 2026, bạn không thể bật API này cho các dự án trên đám mây mới trên Google Cloud; hãy di chuyển sang Routes API.

Directions API: dữ kiện chính

  • Sản phẩm: Directions API
  • Còn được gọi là: Directions API (Cũ)
  • Danh mục: Tuyến đường
  • Nền tảng: Dịch vụ web (REST)
  • Chạy trên: Máy chủ (mã phụ trợ)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Cũ
  • Được thay thế bằng: Routes API
  • Tổng quan: Tổng quan về Directions API
  • Phạm vi cung cấp theo khu vực: Toàn cầu. Phạm vi cung cấp sẽ khác nhau tuỳ theo khu vực và phương tiện di chuyển (phương tiện công cộng phụ thuộc vào dữ liệu của nhà cung cấp dịch vụ công cộng). (thông tin chi tiết về phạm vi bảo hiểm)

Directions API: trường hợp sử dụng

Sử dụng Directions API khi:

  • Bạn duy trì một dự án trên đám mây của Google Cloud hiện có đã bật Directions API (Cũ) và gọi maps/api/directions.
  • Bạn cần có thông tin đường đi phía máy chủ cho việc lái xe, đi bộ, đi xe đạp hoặc đi phương tiện công cộng (chỉ có điểm tham chiếu cho các phương thức không phải phương tiện công cộng), ở định dạng JSON hoặc XML, trong một dự án hiện có.

Đừng sử dụng Directions API khi:

  • Bạn đang bắt đầu một dự án trên đám mây mới của Google; kể từ tháng 10 năm 2026, bạn không thể bật Directions API (Phiên bản cũ) cho các dự án mới. Hãy sử dụng Routes API.
  • Bạn cần các tính năng định tuyến mới và hiệu suất được cải thiện. Hãy sử dụng Routes API.
  • Bạn cần thời gian di chuyển và khoảng cách cho nhiều điểm khởi hành và điểm đến trong một yêu cầu. Hãy sử dụng Routes API.

Directions API: thiết lập

Directions API: lỗi thường gặp

  • Vấn đề: Các yêu cầu gửi đến Directions API (Cũ) từ một dự án không bật API cũ sẽ không thực hiện được và trả về lỗi LegacyApiNotActivatedMapError. Cách khắc phục: Nếu bạn sở hữu ứng dụng, hãy di chuyển sang Routes API. Để giải quyết tạm thời trong khi di chuyển hoặc chờ bản cập nhật ứng dụng, bạn có thể kích hoạt API cũ bằng cách hoàn tất biểu mẫu kích hoạt API cũ. Xem /maps/legacy.
  • Vấn đề: Việc sử dụng tiền tố via: trên các điểm tham chiếu khiến các điểm này trở thành điểm đi qua nghiêm ngặt, có thể gây ra tình trạng đi đường vòng nghiêm trọng hoặc trạng thái ZERO_RESULTS. Cách khắc phục: Sử dụng điểm tham chiếu dừng (không có tiền tố via:) trừ phi cần có điểm đi qua nghiêm ngặt. Xem /maps/documentation/directions/get-directions.
  • Vấn đề: Các yêu cầu có từ 11 đến 25 điểm tham chiếu, optimize:true, thời gian di chuyển có tính đến tình hình giao thông (duration_in_traffic) hoặc đối tượng sửa đổi vị trí side_of_road hoặc heading sẽ được tính phí theo SKU Chỉ đường nâng cao (Pro) có giá cao hơn. Cách khắc phục: Chỉ sử dụng các tính năng này khi cần; giữ số lượng điểm tham chiếu ở mức 10 trở xuống và bỏ qua optimize:true, departure_time (đối với lái xe), side_of_road và heading để tiếp tục sử dụng SKU Essentials. Xem /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Vấn đề: Đối với việc lái xe, departure_time không được nằm trong quá khứ (yêu cầu không thành công với INVALID_REQUEST). Nếu không có departure_time, tuyến đường và thời gian sẽ sử dụng lưu lượng truy cập trung bình không phụ thuộc vào thời gian và không có duration_in_traffic nào được trả về. Cách khắc phục: Đặt departure_time thành now hoặc một thời điểm trong tương lai bằng mode=driving để nhận duration_in_traffic. Những yêu cầu trả về duration_in_traffic sẽ được tính phí theo SKU Chỉ đường nâng cao (Pro). Xem /maps/documentation/directions/get-directions.