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)

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.

Các phương pháp hay nhất về 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 API mới hơn, bạn cũng sẽ được 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 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 rằng bạn đạt được các bậc giá hằng 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 giá và Câu hỏi thường gặp về giá.

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

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 tham số URL để sử dụng nội dung yêu cầu HTTPS

Với Directions API và Distance Matrix API, bạn truyền các thuộc tính cấu hình dưới dạng tham số URL đến 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 truyền các tham số trong phần nội dung yêu cầu hoặc trong tiêu đề dưới dạng một phần của yêu cầu HTTP POST. Để xem ví dụ, hãy tham khảo:

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

Bạn có thể chỉ định điểm tham chiếu dưới dạng hình nhiều đường được mã hoá trong Directions API (Phiên bản cũ) để chứa một số lượng lớn đ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 Routes API vì các điểm tham chiếu 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 độ. Để xem 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.

Chuyển đổi tham số

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. Hãy cập nhật mã nếu bạn đang sử dụng bất kỳ tham số nào trong số này.

Lượt chuyển đổi tham số yêu cầu

Tham số của Directions API hoặc Distance Matrix API Tham số Routes API Ghi chú
alternatives computeAlternativeRoutes
arrival_time arrivalTime Chỉ có ở 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ỉ được hỗ trợ cho Compute Routes.
mode travelMode

Được truyền trong nội dung yêu cầu JSON POST HTTP computeRoutes hoặc computeRouteMatrix bằng cách sử dụng các giá trị RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK hoặc BICYCLE cho computeRoutes) thay vì tham số truy vấn URL GET. Thêm tính năng hỗ trợ cho TWO_WHEELER, TRANSIT và TRUCK.
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 đi phương tiện 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 Đi phương tiện công cộng) được coi là một bước và chỉ dẫn riêng lẻ 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 Đã xóa tính năng hỗ trợ cho hình nhiều đường đượ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ố của Directions API hoặc Distance Matrix API Tham số Routes API Ghi chú
copyrights

Không được đưa vào câu trả lời này. Bạn phải đưa ra tuyên bố sau 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 tính 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àm địa chỉ.
bounds viewport
legs.end_address Không có.

Sử dụng mã địa điểm thay vì toạ độ để định tuyến có độ chính xác cao. Mã địa điểm chứa dữ liệu giúp điều chỉnh tuyến đường đến các điểm truy cập chính xác.

  • Nếu bạn bắt đầu bằng một địa chỉ: Hãy sử dụng Place Autocomplete hoặc Geocoding API để phân giải địa chỉ đó thành mã địa điểm.
  • Nếu bạn bắt đầu bằng toạ độ: Hãy cân nhắc sử dụng tính năng Tìm điểm đến để cung cấp vị trí có ý nghĩa hơn. Việc chỉ lấy địa chỉ từ toạ độ có thể phức tạp và dẫn đến việc ghim không chính xác. Routes API không mã hoá địa lý ngược toạ độ thành địa chỉ.
legs.start_address Không có.
overview_polyline polyline
summary description
waypoint_order optimizedIntermediateWaypointIndex