Tại sao bạn nên chuyển sang dùng API Tuyến đường?

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Routes API giúp cải thiện hiệu suất khi tính toán chỉ đường, khoảng cách và thời gian di chuyển, do đó, bạn nên thay thế các ứng dụng sử dụng Directions API và Distance Matrix API. Hầu hết chức năng của Routes API đều tương thích ngược với cả Directions API và Distance Matrix API.

Hãy tham khảo hướng dẫn này để hiểu rõ những điểm khác biệt chính trong Routes API so với các sản phẩm mà API này thay thế, cùng với cách xử lý những thay đổi cần thiết. Để biết thêm thông tin về các tính năng khác của Routes API, hãy xem tổng quan về sản phẩm.

Các điểm cải tiến chính

Phần này trình bày một số điểm cải tiến mà bạn có thể thấy khi sử dụng Routes API trong các ứng dụng của mình.

Tăng giới hạn yêu cầu

Routes API Compute Route Matrix
  • Tối đa 625 phần tử, trừ phi bạn chỉ định TRAFFIC_AWARE_OPTIMAL.
  • Tối đa 100 phần tử có TRAFFIC_AWARE_OPTIMAL. Xem phần Lựa chọn ưu tiên về đường đi nâng cao.
  • Tối đa 50 điểm đánh dấu (điểm xuất phát + điểm đến) bằng mã địa điểm.
Distance Matrix API
  • Tối đa 25 điểm xuất phát hoặc 25 điểm đến cho mỗi yêu cầu.
  • Tối đa 100 phần tử (số lượng điểm xuất phát × số lượng điểm đến) cho mỗi yêu cầu phía máy chủ.

Phản hồi yêu cầu nhanh hơn

Tính năng Compute Route Matrix (Tính toán ma trận tuyến đường) giúp cải thiện độ trễ như sau:

  • Nhận các phần tử truyền trực tuyến của phản hồi trước khi toàn bộ ma trận được tính toán.
  • Sử dụng mặt nạ trường để tuỳ chỉnh thông tin chi tiết về phản hồi, chỉ yêu cầu dữ liệu bạn cần, đây cũng là một phương pháp hay giúp giảm chi phí.
  • Tính năng tính toán tuyến đường nâng cao cho lưu lượng truy cập, nhờ đó bạn có thể đánh đổi giữa chất lượng dữ liệu và thời gian phản hồi.

Các điểm cải tiến về định tuyến

Tính năng tuyến đường điện toán cung cấp những điểm cải tiến sau đây về định tuyến:

  • Thông tin về phí cầu đường ngoài khoảng cách và thời gian đến dự kiến.
  • Đường đi cho xe 2 bánh.
  • Đánh giá các điểm dừng chân để đảm bảo an toàn.
  • Tăng độ chính xác của ETA bằng cách đặt hướng di chuyển và bên đường cho các điểm tham chiếu.

Chỉ yêu cầu dữ liệu mà bạn cần

Giờ đây, bạn có thể chỉ định những trường cần trả về, giúp giảm thời gian xử lý và phí thanh toán.

Routes API
Compute Routes
Compute Route Matrix 		Yêu cầu của bạn phải sử dụng một mặt nạ trường để chỉ định những trường mà bạn muốn trả về trong phản hồi. Tính năng che phủ trường đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, nhờ đó tránh được thời gian xử lý và phí thanh toán không cần thiết.
Để biết thêm thông tin, hãy xem phần Chọn các trường để trả về.
Directions API
Distance Matrix API 		Trả về danh sách các trường mặc định, ngay cả khi ứng dụng của bạn không thực sự cần đến các trường này. Điều này có thể dẫn đến thời gian xử lý không cần thiết và các khoản phí thanh toán.

Tính năng tính toán tuyến đường nâng cao cho thông tin giao thông

Routes API hỗ trợ 3 lựa chọn ưu tiên về định tuyến mà bạn có thể dùng để cân bằng giữa độ trễ phản hồi và chất lượng dữ liệu khi yêu cầu thông tin giao thông.

Để biết thêm thông tin, hãy xem phần Định cấu hình chất lượng so với độ trễ.

TRAFFIC_UNAWARE
(mặc định)		 Sử dụng dữ liệu lưu lượng truy cập trung bình độc lập với thời gian, chứ không phải dữ liệu lưu lượng truy cập trực tiếp, để tính toán tuyến đường, dẫn đến độ trễ phản hồi thấp nhất. Chế độ cài đặt này tương đương với trường hợp không sử dụng thông tin giao thông trong Directions API và Distance Matrix API.
TRAFFIC_AWARE
(mới)		 Chất lượng lưu lượng truy cập trực tiếp được tối ưu hoá hiệu suất để giảm độ trễ. Khác với TRAFFIC_AWARE_OPTIMAL, chế độ cài đặt này sẽ áp dụng các chế độ tối ưu hoá để giảm đáng kể độ trễ. Chế độ cài đặt này cũng là chế độ mới cho Routes API và không có chế độ tương đương trong Directions API hoặc Distance Matrix API.
TRAFFIC_AWARE_OPTIMAL Dữ liệu giao thông toàn diện, chất lượng cao. Chế độ cài đặt này tạo ra độ trễ cao nhất và tương đương với chế độ cài đặt departure_time trong Directions API và Distance Matrix API.
Lựa chọn ưu tiên này tương đương với chế độ mà maps.google.com và ứng dụng di động Google Maps sử dụng.

So sánh việc tính toán tuyến đường

Bảng sau đây so sánh các lựa chọn định tuyến giữa Routes API và các dịch vụ Directions API và Distance Matrix API.

Lựa chọn về lưu lượng truy cập Routes API Directions API
Distance Matrix API		 Độ trễ
Không có thông tin giao thông theo thời gian thực TRAFFIC_UNAWARE Chưa đặt departure_time cơ sở lưu trú Độ trễ thấp nhất trong 3 chế độ.
Đã áp dụng tình trạng giao thông trực tiếp TRAFFIC_AWARE Không có phiên bản mới

Chế độ mới do Routes API thêm vào. TRAFFIC_UNAWARE cung cấp độ trễ cao hơn một chút với chi phí nhỏ về chất lượng ETA.

Độ trễ của thấp hơn nhiều so với TRAFFIC_AWARE_OPTIMAL.
Áp dụng dữ liệu giao thông trực tiếp toàn diện, chất lượng cao TRAFFIC_AWARE_OPTIMAL departure_time bộ thuộc tính

Tương đương với chế độ mà maps.google.com và ứng dụng di động Google Maps sử dụng.

Đối với Compute Route Matrix, số lượng phần tử trong một yêu cầu (số lượng điểm xuất phát × số lượng điểm đến) không được vượt quá 100.

Những điểm khác biệt chính

Phần này trình bày những điểm khác biệt chính giữa Routes API và các dịch vụ mà API này thay thế, cùng với những cách bạn có thể giải quyết những điểm khác biệt này khi di chuyển từ các dịch vụ này trong các ứng dụng hiện có.

Gọi một dịch vụ thay vì hai

Routes API Chỉ bật một dịch vụ trong API Console để ứng dụng của bạn sử dụng Compute Routes và Compute Route Matrix.
Để biết thêm thông tin, hãy xem phần Thiết lập trong Bảng điều khiển API của Google.
Directions API
Distance Matrix API 		Bật 2 dịch vụ: Directions API và Distance Matrix API dưới dạng các dịch vụ riêng biệt trong API Console.

Sử dụng HTTPS POST yêu cầu

Routes API 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.
Để xem ví dụ, hãy xem:
– Tính toán tuyến đường
– Tính toán ma trận tuyến đường
Directions API
Distance Matrix API 		Truyền các tham số URL bằng yêu cầu HTTP GET.

Sự khác biệt về phản hồi ETA

Routes API trả về thời gian đến dự kiến và sử dụng thuộc tính phản hồi duration theo cách khác với các dịch vụ Directions API và Distance Matrix API như trong bảng bên dưới.

Loại ETA Routes API Directions API
Distance Matrix API
Không có thông tin giao thông, giờ đến dự kiến không phụ thuộc vào thời gian.

Thiết lập bằng TRAFFIC_UNAWARE.

  • ETA có trong thuộc tính phản hồi duration.
  • Các thuộc tính phản hồi duration và staticDuration có cùng giá trị.

Tương ứng với việc departure_time không được đặt trong yêu cầu.

  • ETA có trong thuộc tính phản hồi duration.
  • Thuộc tính phản hồi duration_in_traffic không được trả về.
Giờ đến dự kiến có tính đến tình hình giao thông theo thời gian thực.

Thiết lập bằng cách dùng TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL.

  • ETA có tính đến tình trạng giao thông theo thời gian thực có trong thuộc tính phản hồi duration.
  • Thuộc tính phản hồi staticDuration chứa thời lượng di chuyển theo tuyến đường mà không tính đến tình trạng giao thông.
  • Thuộc tính duration_in_traffic không còn được trả về nữa.

Đặt bằng cách sử dụng departure_time trong yêu cầu.

  • ETA có tính đến tình trạng giao thông theo thời gian thực có trong thuộc tính phản hồi duration_in_traffic.

Điểm tham chiếu của hình nhiều đường

Bạn không cần chuyển đổi toạ độ vĩ độ/kinh độ thành các điểm tham chiếu đường đa tuyến bằng dịch vụ này nữa. Dịch vụ này hỗ trợ nội dung yêu cầu POST và do đó không còn bị ảnh hưởng bởi giới hạn chuỗi URL. Một số người dùng Distance Matrix API đã giải quyết vấn đề về giới hạn yêu cầu bằng cách chuyển đổi các điểm vĩ độ/kinh độ thành các điểm tham chiếu của đường đa tuyến.

Địa chỉ được định dạng (mã hoá địa lý ngược)

Routes API không cung cấp địa chỉ được định dạng trong phản hồi. Để lấy địa chỉ được định dạng, hãy sử dụng Geocoding API được xây dựng cho trường hợp sử dụng này và cung cấp kết quả có chất lượng cao hơn.

Các chế độ di chuyển hiện có

Tương tự như Directions API, Routes API sử dụng DRIVE làm chế độ mặc định khi một yêu cầu về tuyến đường không chỉ định chế độ di chuyển. Tuy nhiên, khi một yêu cầu chỉ định chế độ di chuyển cho một tuyến đường, Routes API sẽ không trả về một mảng các chế độ di chuyển có sẵn làm lựa chọn thay thế cho yêu cầu. Nếu trường hợp sử dụng của bạn phụ thuộc vào tính năng này, hãy báo cáo vấn đề và mô tả cách bạn sử dụng tính năng này để chúng tôi có thể theo dõi.

XML làm định dạng phản hồi

Routes API không cung cấp XML làm định dạng phản hồi. Bạn có thể tìm thấy một số trình chuyển đổi JSON sang XML trực tuyến phù hợp với mục đích của mình.