Di chuyển từ Directions API (Cũ) hoặc Distance Matrix API (Cũ)

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

Nếu địa chỉ thanh toán của bạn ở Khu vực kinh tế Châu Âu, thì kể từ ngày 8 tháng 7 năm 2025, Điều khoản dịch vụ của Nền tảng Google Maps ở EEA sẽ áp dụng cho việc bạn sử dụng Dịch vụ. Chức năng này thay đổi theo khu vực. Tìm hiểu thêm.

Hướng dẫn này mô tả cách di chuyển các ứng dụng sử dụng Directions API hoặc Distance Matrix API sang Routes API. Để biết thông tin chi tiết về Routes API, hãy xem tổng quan về sản phẩm.

Lưu ý: Nếu bạn đang sử dụng bản phát hành Xem trước của Routes API, hãy xem phần Di chuyển từ bản Xem trước sang bản phát hành công khai để biết thông tin về cách di chuyển sang bản phát hành công khai.

Các phương pháp hay nhất về việc thanh toán khi di chuyển

Hướng dẫn này áp dụng nếu mức sử dụng API của bạn đủ cao để chuyển sang mức giá cấp thứ hai. Khi di chuyển sang phiên bản mới hơn của một API, bạn cũng sẽ bị tính phí cho một SKU khác. Để tránh tăng chi phí trong tháng chuyển đổi, bạn nên chuyển sang dùng các API mới trong quá trình sản xuất càng gần đầu tháng càng tốt. Điều này sẽ đảm bảo bạn đạt được các bậc giá theo tháng tiết kiệm chi phí nhất trong tháng di chuyển. Để biết thông tin về các bậc giá, hãy xem trang định giá và câu hỏi thường gặp về giá.

Cập nhật các điểm cuối REST API

Cập nhật mã để sử dụng các điểm cuối mới của Routes API

Từ Directions API

Directions API	https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API	https://routes.googleapis.com/directions/v2:computeRoutes

Từ Distance Matrix API

Distance Matrix API	https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API	https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Chuyển đổi các tham số URL để sử dụng phần nội dung yêu cầu HTTPS

Với Directions API và Distance Matrix API, bạn sẽ truyền các thuộc tính cấu hình dưới dạng tham số URL cho một yêu cầu HTTP GET. Ví dụ: đối với Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Với Routes API, bạn sẽ truyền các tham số trong nội dung yêu cầu hoặc trong tiêu đề như một phần của yêu cầu HTTP POST. Để biết ví dụ, hãy xem:

• Tính toán tuyến đường
• Tính toán ma trận tuyến đường

Chuyển đổi các điểm tham chiếu được mã hoá bằng đường nhiều đường thành các điểm tham chiếu vị trí

Bạn có thể chỉ định điểm tham chiếu dưới dạng nhiều đường thẳng được mã hoá trong Directions API (cũ) để phù hợp với một số lượng lớn điểm tham chiếu trong giới hạn URL là 16384 ký tự. Tính năng này không cần thiết trong Routes API vì bạn có thể truyền các điểm tham chiếu trong nội dung yêu cầu REST hoặc gRPC dưới dạng toạ độ vĩ độ/kinh độ. Ví dụ: hãy xem Ví dụ về HTTP trong tài liệu Tính toán ma trận tuyến đường hoặc Xác định điểm tham chiếu trung gian trong tài liệu Chỉ định điểm tham chiếu trung gian.

Tham số chuyển đổi

Các bảng sau đây liệt kê các tham số trong Directions API và Distance Matrix API đã được đổi tên hoặc sửa đổi, hoặc các tham số không được hỗ trợ trong bản phát hành GA. Cập nhật mã nếu bạn đang sử dụng bất kỳ thông số nào trong số này.

Chuyển đổi tham số yêu cầu

Tham số Đường đi hoặc Ma trận khoảng cách	Tham số Routes API	Ghi chú
alternatives	computeAlternativeRoutes
arrival_time	arrivalTime	Chỉ có ở chế độ TRANSIT và không có cùng lúc với departureTime.
avoid	routeModifiers
departure_time	departureTime	Không thể dùng cùng lúc với arrivalTime.
language	languageCode	Chỉ được hỗ trợ cho Compute Routes.
mode	travelMode	Thêm tính năng hỗ trợ cho TWO_WHEELER và TRANSIT.
region	regionCode
traffic_model	trafficModel	Tìm hiểu thêm
transit_mode	"travelMode": "TRANSIT"	Trong Directions API (Phiên bản cũ), trong một tuyến đường công cộng, mỗi đoạn của một chuyến đi có cùng chế độ di chuyển (ví dụ: Đi bộ hoặc Phương tiện công cộng) được coi là một bước và chỉ dẫn riêng cho chế độ di chuyển đó nằm trong các bước phụ. Ngược lại, trong Routes API, các bước luôn là một chỉ dẫn điều hướng trên tất cả các loại hình di chuyển. Vì vậy, mỗi chỉ dẫn điều hướng là một bước. Đối với nhiều bước trong một chế độ di chuyển, Routes API cung cấp siêu dữ liệu chứa thông tin tóm tắt về các bước cho chế độ di chuyển đó trong `stepsOverview`. Để yêu cầu siêu dữ liệu này, hãy sử dụng mặt nạ trường `routes.legs.stepsOverview`. Tìm hiểu thêm.
transit_routing_preference	transitRoutingPreference	Tìm hiểu thêm
units	units	Tìm hiểu thêm
waypoints	intermediates	Đã xoá tính năng hỗ trợ cho đường nhiều đoạn được mã hoá.
optimize=true cho điểm đánh dấu	"optimizeWaypointOrder": "true"	Tìm hiểu thêm

Chuyển đổi tham số phản hồi

Tham số Đường đi hoặc Ma trận khoảng cách	Tham số Routes API	Ghi chú
copyrights		Không được đưa vào phản hồi. Bạn phải đưa ra tuyên bố sau đây khi hiển thị kết quả cho người dùng: Powered by Google, ©YEAR Google Ví dụ: Powered by Google, ©2022 Google
distance	distanceMeters	Khoảng cách chỉ có thể đo bằng mét.
duration_in_traffic	duration	Đã xoá trong Routes API, hãy sử dụng duration.
status		Không có. Sử dụng mã phản hồi HTTP cho các lỗi do API báo cáo. Hãy xem phần Xử lý lỗi yêu cầu để biết thêm thông tin.
geocoded_waypoints	geocoding_results	Chỉ được hỗ trợ cho Compute Routes. Chỉ chứa thông tin phản hồi về mã hoá địa lý cho các điểm tham chiếu được chỉ định là địa chỉ.
bounds	viewport
legs.end_address	Không có.
legs.start_address	Không có.
overview_polyline	polyline
summary	description
waypoint_order	optimizedIntermediateWaypointIndex