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ề tuyến đường API, hãy xem tổng quan về sản phẩm.
Cập nhật các điểm cuối của API REST
Cập nhật mã của bạn để sử dụng các điểm cuối Routes API mới
Từ API hướng dẫn
API Chỉ đường | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
API Bộ định tuyến | https://routes.googleapis.com/directions/v2:computeRoutes |
Từ Distance Matrix API (API Ma trận khoảng cách)
API ma trận khoảng cách | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
API Bộ định tuyến | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Chuyển đổi tham số URL để sử dụng nội dung yêu cầu HTTPS
Với API chỉ dẫn và API ma trận từ xa, bạn sẽ 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 (API Chỉ dẫn):
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Với API Tuyến đường, 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:
Chuyển đổi điểm tham chiếu được mã hoá nhiều đường thành điểm tham chiếu vị trí
Việc chỉ định điểm tham chiếu dưới dạng hình nhiều đường được mã hoá hiện có sẵn trong Directions API để phù hợp với một số lượng lớn các đ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 API Tuyến đường vì điểm tham chiếu có thể được truyền trong 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 tham chiếu trung gian trong tài liệu Chỉ định điểm tham chiếu trung gian.
Chuyển đổi thông số
Các bảng sau 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. Cập nhật mã nếu bạn đang sử dụng bất kỳ tham số nào trong số này.
Yêu cầu chuyển đổi thông số
Tham số ma trận Đường đi hoặc Khoảng cách | Tham số API Tuyến đường | Ghi chú |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Chỉ có sẵn ở 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 điện toán. |
mode |
travelMode |
Thêm tính năng hỗ trợ cho |
region |
regionCode |
|
traffic_model |
trafficModel |
Tìm hiểu thêm |
transit_mode |
"travelMode": "TRANSIT" |
Trong API chỉ đường, trong một tuyến đường bằng phương tiện công cộng, mỗi chặng của chuyến đi có cùng phương thức đi lại (ví dụ: Đi bộ hoặc Phương tiện công cộng) được coi là một bước và chỉ đường riêng cho phương tiện đó được xem là các bước phụ. Ngược lại, trong API Tuyến đường, các bước đều bao gồm một hướng dẫn điều hướng nhất quán cho mọi hình thức 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 chế độ đi lại, API Tuyến đường sẽ cung cấp siêu dữ liệu chứa bản tóm tắt các bước cho phương tiện đó, trong "StepOverview" (Tổng quan về các bước). Để yêu cầu siêu dữ liệu này, hãy sử dụng mặt nạ trường "routes.legs.stepOverview". Tìm hiểu thêm. |
transit_routing_preference |
transitRoutingPreference |
Tìm hiểu thêm |
units |
Không có sẵn cho ma trận tuyến đường. | |
waypoints |
intermediates |
Xoá tính năng hỗ trợ đối với hình nhiều đường được mã hoá. |
optimize=true cho điểm tham chiếu |
"optimizeWaypointOrder": "true" |
Tìm hiểu thêm |
Lượt chuyển đổi thông số phản hồi
Tham số ma trận Đường đi hoặc Khoảng cách | Tham số API Tuyến đường | Ghi chú |
---|---|---|
copyrights |
Không có trong câu trả lời. Bạn phải thêm câu lệnh sau khi hiển thị kết quả cho người dùng:
Ví dụ:
|
|
distance |
distanceMeters |
Khoảng cách chỉ đượ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ó. Hãy sử dụng mã phản hồi HTTP cho các lỗi mà API báo cáo. Hãy xem bài viết 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 điện toán. Chỉ chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu được chỉ định làm đị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 |