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 những ứ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 phần tổng quan về sản phẩm.

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 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 định 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 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 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. Để biết ví dụ, hãy xem:

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

Bạn có thể chỉ định điểm đánh dấu dưới dạng nhiều đường thẳng được mã hoá trong Directions API (cũ) để phù hợp với số lượng lớn điểm đánh dấ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 điểm tham chiếu trong 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.

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ỳ 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ó 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ũ), trên 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 phương thức 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ỉ đường riêng cho phương thức 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 phương tiện đi lại, 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 tiện đi lại đó 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 đánh dấ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. 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ó thể đo bằng mét.
duration_in_traffic duration Đã bị 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ó.

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ột 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 một 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