Trang này được dịch bởi Cloud Translation API.

Di chuyển từ API hướng dẫn hoặc API ma trận từ xa

Hướng dẫn này mô tả cách di chuyển các ứng dụng sử dụng API Chỉ đường hoặc API Ma trận khoảng cách sang sử dụng API Tuyến đường. Để biết thông tin chi tiết về Routes API, hãy xem tổng quan về sản phẩm.

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

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

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 nội dung yêu cầu HTTPS

Với API chỉ đường và API Distance Matrix, bạn truyền các thuộc tính cấu hình dưới dạng tham số URL đến 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 truyền các tham số trong phần 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:

Chuyển đổi các điểm trung gian được mã hoá bằng đa tuyến thành điểm trung gian vị trí

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

Chuyển đổi tham số

Các bảng sau đây liệt kê các tham số trong API Chỉ đường và API Ma trận khoảng cách đã đượ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. Hãy cập nhật mã của bạn nếu bạn đang sử dụng bất kỳ thông số nào trong số này.

Yêu cầu chuyển đổi tham số

Tham số ma trận Đường đi hoặc Khoảng cách	Tham số API tuyến	Ghi chú
`alternatives`	`computeAlternativeRoutes`
`arrival_time`	`arrivalTime`	Chỉ có trong chế độ `TRANSIT` và không cùng lúc với `departureTime`.
`avoid`	`routeModifiers`
`departure_time`	`departureTime`	Không thể sử dụng cùng lúc với `arrivalTime`.
`language`	`languageCode`	Chỉ hỗ trợ cho Tuyến tính toán.
`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 API Chỉ đường, trong một tuyến phương tiện công cộng, mỗi phân đoạn của một chuyến đi có cùng một phương thức 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à các hướng dẫn riêng lẻ cho phương thức di chuyển đó nằm trong các bước phụ. Ngược lại, trong Route API, các bước luôn là một hướng dẫn điều hướng trên tất cả các loại phương tiện di chuyển. Vì vậy, mỗi hướng dẫn điều hướng là một bước. Đối với nhiều bước trong một phương thức 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 phương thức 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ợ đường đa tuyến tính được mã hoá.
`optimize=true` cho điểm tham chiếu	`"optimizeWaypointOrder": "true"`	Tìm hiểu thêm

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

Tham số ma trận Đường đi hoặc Khoảng cách	Tham số API tuyến	Ghi chú
`copyrights`		Không có trong phản hồi. Bạn phải đưa vào câu lệnh 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ể được tính bằng mét.
`duration_in_traffic`	`duration`	Đã xoá trong API Tuyến đường, 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ỉ hỗ trợ cho Tuyến tính toán. Chỉ chứa thông tin phản hồi về việc mã hoá địa lý cho các điểm trung gian được chỉ định dưới dạng địa chỉ.
`bounds`	`viewport`
`legs.end_address`	Không có.
`legs.start_address`	Không có.
`overview_polyline`	hình nhiều đường
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`