Tính năng định tuyến cho xe lớn của Routes API tính toán tuyến đường và thời gian đến dự kiến (ETA) cho xe lớn. API này trả về các tuyến đường tối ưu, tránh các quy định hạn chế dựa trên chiều cao, trọng lượng, chiều dài và phân loại vật liệu nguy hiểm của xe. Dịch vụ này cũng tạo một mã thông báo tuyến đường có thể được truyền đến SDK điều hướng để cung cấp thông tin chỉ đường từng chặng.
Lý do nên sử dụng tính năng định tuyến cho xe lớn
Sử dụng tính năng định tuyến cho xe lớn để xây dựng các ứng dụng giải quyết những thách thức về hậu cần cho đội xe lớn.
| Lợi ích | Nội dung mô tả |
|---|---|
| Cải thiện độ chính xác của việc đặt giá và lập kế hoạch | Tạo thời gian đến dự kiến cụ thể, dựa trên thông tin giao thông, giúp đưa ra thông tin báo giá và thời gian giao hàng chính xác hơn cho các phương tiện lớn như xe tải và xe buýt. |
| Nâng cao độ an toàn và hiệu quả cho tài xế | Hướng dẫn tài xế đi theo những tuyến đường tránh cầu thấp, đường hạn chế trọng tải và các mối nguy hiểm khác. |
| Đơn giản hoá hoạt động của toàn bộ đội xe | Sử dụng tính năng Tối ưu hoá tuyến đường cùng với tính năng định tuyến cho xe lớn để tối ưu hoá việc phân công tải trọng và thứ tự điểm dừng cho toàn bộ đội xe. Sử dụng Fleet Engine để xem thông tin về nhiệm vụ và vị trí của xe theo thời gian thực. |
| Giảm thiểu thời gian đào tạo và tăng tỷ lệ áp dụng | Cung cấp cho người lái xe tải hoặc xe lớn trải nghiệm đi theo chỉ dẫn của Google Maps quen thuộc ngay trong ứng dụng của bạn |
Những việc bạn có thể làm với tính năng định tuyến cho xe lớn
Với tính năng định tuyến cho xe lớn, bạn có thể thực hiện các thao tác chính sau:
- Chỉ định các thuộc tính chi tiết của xe, bao gồm chiều cao, trọng lượng, chiều dài, chiều rộng, số trục và thông tin phân loại hàng hoá nguy hiểm.
- Nhận tuyến đường, thời gian di chuyển và quãng đường di chuyển được tính toán cụ thể cho các thuộc tính của xe.
- Tạo tuyến đường được tối ưu hoá để dễ di chuyển bằng cách tự động tránh quay đầu xe và ưu tiên các tuyến đường liên bang và đường cao tốc. Điều này giúp các xe lớn đi đúng tuyến đường phù hợp với nhu cầu và mong đợi của tài xế.
- Tính toán thời gian đến dự kiến chính xác hơn bằng cách sử dụng mô hình thời gian đến dự kiến dành riêng cho xe tải. Mô hình này kết hợp tốc độ di chuyển quan sát được của xe tải với dữ liệu giao thông theo thời gian thực và dữ liệu giao thông dự đoán để đưa ra thông tin ước tính chính xác hơn cho các xe lớn.
- Bật tính năng điều hướng từng chặng trong Navigation SDK bằng mã thông báo tuyến đường để chuyển tuyến đường an toàn cho xe tải từ Routes API.
- Tính toán ma trận tuyến đường để xác định thời gian di chuyển và khoảng cách giữa nhiều điểm xuất phát và điểm đến cho việc lập kế hoạch trên toàn đội xe.
- Tối ưu hoá kế hoạch lộ trình cho đội xe tải để đạt được hiệu quả hoạt động tổng thể, có tính đến tính khả thi và an toàn.
Cách hoạt động của tính năng định tuyến cho xe lớn
Tính năng định tuyến cho xe lớn hoạt động thông qua các dịch vụ sau:
| Điểm cuối | Hoạt động | Đầu ra |
|---|---|---|
| Routes API | Yêu cầu HTTPS đến một điểm cuối của Routes API (computeRoutes hoặc computeRouteMatrix) có nội dung yêu cầu bao gồm điểm xuất phát và điểm đến. travelMode phải được đặt thành TRUCK và đối tượng routeModifiers phải bao gồm vehicleInfo.
|
Một hình nhiều đường của tuyến đường, danh sách các chặng và bước của tuyến đường, thời gian di chuyển ước tính và mã thông báo tuyến đường. |
| Route Optimization API | Yêu cầu HTTPS đến điểm cuối của Route Optimization API. travelMode phải được đặt thành TRUCK và đối tượng routeModifiers phải bao gồm vehicleInfo.
|
Kế hoạch tuyến đường được tối ưu hoá cho đội xe, được thiết kế cho từng loại xe cụ thể và mã thông báo tuyến đường cho mỗi chuyến đi. |
| Navigation SDK (Android, iOS) | Thêm mã thông báo tuyến đường (được tạo từ Routes API hoặc Route Optimization API có tính năng Lên lộ trình cho xe lớn) khi đặt điểm đến trong trình điều hướng. | Trải nghiệm điều hướng từng chặng được tuỳ chỉnh cho xe tải và đi theo tuyến đường tuân thủ thông tin về xe được chỉ định trong Yêu cầu API ban đầu của Routes API hoặc Route Optimization API. |
Ví dụ
Ví dụ sau đây tập trung vào việc sử dụng tính năng định tuyến cho xe lớn bằng Routes API.
Ví dụ: nội dung yêu cầu computeRoutes cơ bản sẽ có dạng như sau:
{
"origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
"destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
"travelMode": "TRUCK",
"routeModifiers": {
"vehicleInfo": {
"totalHeightMm": 4114,
"totalLengthMm": 21945,
"totalWeightKg": 32658,
... // other vehicle attributes
}
}
}
Bắt buộc: Yêu cầu của bạn phải đặt travelMode thành TRUCK và điền các kích thước cũng như thuộc tính cụ thể của xe vào đối tượng vehicleInfo.
Routes API trả về một tuyến đường có xem xét thông tin về xe đã chỉ định. Phản hồi có thể bao gồm hình nhiều đường của tuyến đường, thời gian đến dự kiến dành riêng cho xe tải, quãng đường di chuyển và mã thông báo tuyến đường để sử dụng với SDK Điều hướng, tuỳ thuộc vào mặt nạ trường được chỉ định. Phản hồi cũng cho biết liệu có tìm thấy tuyến đường hoàn toàn tuân thủ hay không.
Nội dung yêu cầu và phản hồi
Bảng sau đây liệt kê dữ liệu bạn gửi và nhận khi đưa ra yêu cầu định tuyến cho xe lớn bằng phương thức computeRoutes của Routes API.
| Nội dung yêu cầu | Nội dung phản hồi | Định dạng trả về |
|---|---|---|
|
|
JSON |
Các điểm hạn chế
Trước khi bắt đầu, bạn phải nắm được các yêu cầu và hạn chế sau đây.
- Phạm vi cung cấp theo khu vực địa lý: Tính năng định tuyến cho xe lớn được cung cấp ở 48 tiểu bang liền kề của Hoa Kỳ (Giai đoạn phát hành rộng rãi) và Nhật Bản (Thử nghiệm). Dịch vụ này không được cung cấp ở Alaska, Hawaii hoặc các lãnh thổ thuộc Hoa Kỳ.
- Thông tin tư vấn và an toàn cho tài xế. Tài xế không được chỉ dựa vào các tuyến đường do API này trả về để đảm bảo an toàn hoặc hợp pháp. Các tuyến đường không được đảm bảo là phù hợp với xe và việc đi theo các tuyến đường đó có thể khiến người lái xe gặp phải các mối nguy hiểm như cầu thấp hoặc đường cấm xe lớn.
- Tuyến đường tốt nhất có thể. Trong một số trường hợp, API không thể tìm thấy tuyến đường tuân thủ đầy đủ các quy định hạn chế về việc đi lại. Thay vào đó, API này sẽ trả về tuyến đường "tốt nhất có thể" và tuyến đường này vẫn có thể đi qua các khu vực bị hạn chế. Phản hồi của Routes API
gắn cờ rõ ràng các tuyến đường này trong trường
routeRestrictionsPartiallyIgnored. Hãy lên kế hoạch kỹ lưỡng cho tuyến đường của bạn trong những trường hợp này, tốt nhất là sử dụng dữ liệu nguồn khác. Đừng sử dụng tuyến đường bị gắn cờ làm nguồn đáng tin cậy duy nhất để lập kế hoạch hoặc đi theo chỉ dẫn. - Tính năng không được hỗ trợ: Tính năng định tuyến cho xe lớn không hỗ trợ những tính năng sau:
- Phí cầu đường cho xe tải
- Giới hạn tốc độ
- Tuyến đường cho vật liệu nguy hiểm có tính phóng xạ
- Hạn mức sử dụng: Tất cả yêu cầu đều phải tuân theo hạn mức số truy vấn mỗi giây (QPS) tiêu chuẩn.
Cách sử dụng tính năng định tuyến cho xe lớn
Hãy làm theo các bước sau để sử dụng tính năng định tuyến cho xe lớn bằng Routes API:
- Thiết lập dự án trên đám mây: Đảm bảo bạn đã tạo dự án trên đám mây Google Cloud và bật Routes API cho dự án đó.
- Cung cấp tính năng định tuyến cho xe lớn: Tính năng định tuyến cho xe lớn chỉ dành cho một số khách hàng nhất định. Hãy liên hệ với chúng tôi để yêu cầu quyền truy cập và yêu cầu cung cấp tính năng này cho dự án của bạn.
- Tạo yêu cầu: Gọi điểm cuối
computeRouteshoặccomputeRouteMatrixbằng cách đặttravelModethànhTRUCK, đặtroutingPreferencethànhTRAFFIC_AWARE_OPTIMALvà chỉ định các thuộc tính của xe bằng đối tượngvehicleInfo. - Cung cấp đường đi từng chặng (không bắt buộc): Nếu bạn đã gọi
computeRoutes, hãy truyềnrouteTokentừ phản hồi đến SDK Điều hướng để bắt đầu một phiên điều hướng.
Bước tiếp theo
- Bắt đầu: Tạo tuyến đường và thời gian đến dự kiến cho xe tải bằng Routes API
- Thêm tính năng chỉ đường: Cung cấp tính năng chỉ đường từng chặng với các tuyến đường dành riêng cho xe tải trong SDK chỉ đường cho Android hoặc iOS