Routes API cải thiện hiệu suất tính toán đường đi, khoảng cách và thời gian di chuyển, giúp bạn thay thế các ứng dụng hiện đang sử dụng API Đường đi và API Ma trận khoảng cách. Hầu hết chức năng của API Lộ trình đều tương thích ngược với cả API Chỉ đường và API Ma trận khoảng cách.
Hãy tham khảo hướng dẫn này để hiểu được 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ý các thay đổi cần thiết. Để biết thêm thông tin chi tiết về các tính năng khác của API Lượt đi, 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ể mong đợi khi sử dụng Route API trong ứng dụng.
Tăng hạn mức yêu cầu
| Routes API |
|
| Distance Matrix API |
|
Trả lời yêu cầu nhanh hơn
Tính năng ma trận tuyến tính điện toán mang lại những điểm cải tiến về độ trễ 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ề câu trả lời, chỉ yêu cầu dữ liệu bạn cần. Đây là phương pháp hay nhất giúp giảm chi phí.
- Cải thiện tính toán tuyến đường cho lưu lượng truy cập để 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 tính năng nâng cao về định tuyến
Tính năng định tuyến điện toán cung cấp các tính năng nâng cao về định tuyến sau:
- Thông tin về phí cầu đường ngoài khoảng cách và thời gian đến dự kiến.
- Tuyến đường dành cho xe 2 bánh.
- Xác định đ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 trung gian.
Chỉ yêu cầu dữ liệu mà bạn cần
Giờ đây, bạn chỉ định các trường cần trả về, giúp giảm thời gian xử lý và các khoản phí thanh toán.
| Routes API | Yêu cầu của bạn phải sử dụng mặt nạ trường để chỉ định những trường mà bạn muốn được trả về trong phản hồi. Tính năng che 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 trường để trả về. |
| API chỉ đường 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 các trường đó. Điều này có thể dẫn đến thời gian xử lý và các khoản phí không cần thiết. |
Tính toán tuyến đường nâng cao cho lưu lượng truy cập
Routes API hỗ trợ 3 lựa chọn ưu tiên định tuyến mà bạn có thể sử 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 về lưu lượng truy cập.
Để 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 không phụ thuộc vào 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 khi không sử dụng lưu lượng truy cập trong API Chỉ đường và API Ma trận khoảng cách. |
TRAFFIC_AWARE (mới) |
Chất lượng lưu lượng truy cập trực tiếp được tối ưu hoá về hiệu suất để giảm độ trễ. Ngược lại với TRAFFIC_AWARE_OPTIMAL, chế độ cài đặt này áp dụng các biện pháp tối ưu hoá để giảm đáng kể độ trễ.
Chế độ cài đặt này cũng mới đối với API Routes (Tuyến đường) và không có chế độ tương đương trong API Directions (Hướng dẫn) hoặc API Distance Matrix (Mảng khoảng cách).
|
TRAFFIC_AWARE_OPTIMAL |
Dữ liệu lưu lượng truy cập 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 API Chỉ đường và API Ma trận khoảng cách. Lựa chọn ưu tiên này tương đương với chế độ mà maps.google.com và ứng dụng Google Maps dành cho thiết bị di động sử dụng. |
So sánh tính toán tuyến đường
Bảng sau đây so sánh các tuỳ chọn định tuyến giữa Routes API (API Lộ trình) và các dịch vụ Directions API (API Chỉ đường) và Distance Matrix API (API Ma trận khoảng cách).
| Lựa chọn về lưu lượng truy cập | Routes API | API chỉ đường Distance Matrix API |
Độ trễ |
|---|---|---|---|
| Không có tình hình giao thông theo thời gian thực | TRAFFIC_UNAWARE |
Chưa thiết lập thuộc tính departure_time |
Độ trễ nhanh nhất trong số 3 chế độ. |
| Áp dụng điều kiện 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. Phương thức này cung cấp độ trễ lớn hơn một chút so với Phương thức này có độ trễ thấp hơn nhiều so với |
| Á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 |
Tập hợp thuộc tính departure_time |
Tương đương với chế độ mà maps.google.com và ứng dụng Google Maps dành cho thiết bị di động sử dụng. Đối với tính năng Tính toán ma trận tuyến đường, 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. |
Đ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 ứng dụng hiện có.
Gọi một dịch vụ thay vì hai dịch vụ
| Routes API | Chỉ bật một dịch vụ trong API Console để ứng dụng của bạn sử dụng tính năng Tính toán tuyến đường và Tính toán ma trận tuyến đường.
Để biết thêm thông tin, hãy xem phần Thiết lập trong Google API Console. |
| API chỉ đường Distance Matrix API |
Bật hai dịch vụ: API chỉ đường và API ma trận khoảng cách dưới dạng các dịch vụ riêng biệt trong API Console. |
Sử dụng các yêu cầu HTTPS POST
| 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. Hãy xem ví dụ tại: - Tính toán tuyến đường - Tính toán ma trận tuyến đường |
| API chỉ đường 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ề ETA và sử dụng thuộc tính phản hồi duration khác với các dịch vụ Directions API và Distance Matrix API như trong bảng dưới đây.
| Loại ETA | Routes API | API chỉ đường Distance Matrix API |
|---|---|---|
| Không biết tình hình giao thông, giờ đến dự kiến không phụ thuộc vào thời gian. | Thiết lập bằng
|
Tương ứng với việc
|
| Giờ đến dự kiến có tính đến tình hình giao thông theo thời gian thực. | Đặt bằng
|
Đặt bằng
|
Điểm trung gian của đường nhiều đường
Bạn không cần chuyển đổi toạ độ vĩ độ/kinh độ thành điểm trung gian đường đa tuyến bằng dịch vụ này nữa. Dịch vụ này hỗ trợ phần nội dung yêu cầu POST và do đó không còn chịu ảnh hưởng của các giới hạn chuỗi URL. Một số người dùng API Distance Matrix đã giải quyết vấn đề về giới hạn yêu cầu bằng cách chuyển đổi điểm vĩ độ/kinh độ thành điểm trung gian của đường đa tuyến.
Địa chỉ được định dạng (mã đị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 API Mã hoá địa lý được tạo cho trường hợp sử dụng này và cung cấp kết quả chất lượng cao hơn.
Các phương tiện di chuyển có sẵn
Cũng như trường hợp của API Chỉ đường, Routes API sử dụng chế độ ĐI LẠI làm chế độ mặc định khi yêu cầu tuyến đường không chỉ định chế độ đi lại. Tuy nhiên, khi một yêu cầu chỉ định một phương thức di chuyển cho một tuyến đường, Routes API sẽ không trả về một mảng các phương thức 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 gửi vấn đề mô tả cách bạn sử dụng tính năng đó để chúng tôi có thể tiếp tục xử lý.
XML dưới dạng định dạng phản hồi
Routes API không cung cấp XML dưới dạng đị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ên mạng phù hợp với mục đích của mình.