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
- Dịch vụ cần bật:
directions-backend.googleapis.com - Xác thực: Khoá API
- Bắt đầu: Thiết lập Directions API
- Tài liệu tham khảo: Tài liệu tham khảo Directions API
- Giá: Mức sử dụng và thanh toán cho Directions API
- Chính sách: Chính sách về Directions API
- Ghi chú phát hành: Ghi chú phát hành về Directions API
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áiZERO_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_roadhoặcheadingsẽ đượ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ỏ quaoptimize:true,departure_time(đối với lái xe),side_of_roadvà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_timekhông được nằm trong quá khứ (yêu cầu không thành công vớiINVALID_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_trafficnào được trả về. Cách khắc phục: Đặtdeparture_timethànhnowhoặc một thời điểm trong tương lai bằngmode=drivingđể nhậnduration_in_traffic. Những yêu cầu trả vềduration_in_trafficsẽ được tính phí theo SKU Chỉ đường nâng cao (Pro). Xem /maps/documentation/directions/get-directions.