Hướng dẫn này mô tả cách di chuyển các ứng dụng sử dụng API hướng dẫn hoặc API ma trận khoảng cách để sử dụng API Tuyến đường. Để biết chi tiết về API tuyến đường, hãy xem sản phẩm tổng quan.
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 mới của Routes API
Từ API hướng dẫn
API Chỉ đường | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
API Tuyến đường | https://routes.googleapis.com/directions/v2:computeRoutes |
Từ 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 Tuyến đường | 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 hướng dẫn và API ma trận từ xa, 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
. Cho
ví dụ: đối với API hướng dẫn:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Với API Tuyến đường, bạn truyền tham số vào 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 thêm ví dụ, hãy tham khảo:
Chuyển đổi các đ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 làm hình nhiều đường được mã hoá có sẵn trong Chỉ đường API để điều chỉnh kích thước số điểm tham chiếu trong giới hạn URL là 16.384 ký tự. Tính năng này không cần thiết trong API tuyến vì các đ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 vĩ độ/kinh độ. Ví dụ: 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.
Chuyển đổi thông số
Các bảng sau đây liệt kê các tham số trong API hướng dẫn và API ma trận khoảng cách có đã được đổi tên hay sửa đổi hoặc các thông số không được hỗ trợ trong GA bản phát hành. 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.
Yêu cầu chuyển đổi thông số
Tham số ma trận chỉ đường hoặc khoảng cách | Tham số API Tuyến đường | Ghi chú |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Chỉ có ở chế độ TRANSIT , không hoạt động cùng lúc
thời gian là departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Không thể sử dụng cùng lúc với arrivalTime . |
language |
languageCode |
Chỉ được hỗ trợ cho tuyến tính toán. |
mode |
travelMode |
Bổ sung 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, trên tuyến đường chuyển tuyến, mỗi một đoạn của chuyến đi có cùng phương tiện đi lại (ví dụ: Đi bộ hoặc Phương tiện) được coi là một bước và chỉ đường riêng lẻ cho phương tiện đi lại đang ở các bước phụ. Ngược lại, trong API tuyến đường, các bước nhất quán là một hướng dẫn điều hướng cho mọi loại hình du lịch. 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 tiện đi lại, API tuyến đường 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 đi lại đó, theo `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 |
Không có cho ma trận tuyến đường. | |
waypoints |
intermediates |
Đã ngừng hỗ trợ hình nhiều đường được mã hoá. |
optimize=true cho điểm tham chiếu |
"optimizeWaypointOrder": "true" |
Tìm hiểu thêm |
Số lượt chuyển đổi thông số phản hồi
Tham số ma trận chỉ đường hoặc khoảng cách | Tham số API Tuyến đường | Ghi chú |
---|---|---|
copyrights |
Không được đưa vào câu trả lời này. Bạn phải cung cấp các thông tin sau: khi hiển thị kết quả cho người dùng:
Ví dụ:
|
|
distance |
distanceMeters |
Bạn chỉ có thể xem khoảng cách theo mét. |
duration_in_traffic |
duration |
Đã xoá trong API Tuyến đường, hãy dùng duration . |
status |
Không có. Sử dụng mã phản hồi HTTP cho các lỗi được API báo cáo. 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ỉ được hỗ trợ cho tuyến tính 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 |