Tài liệu tham khảo nhanh về Dịch vụ Fleet Engine

Fleet Engine là một dịch vụ phụ trợ giúp lập mô hình đội xe thực tế của bạn, đồng thời cung cấp thông tin cập nhật về tuyến đường, thời gian đến dự kiến, tình hình giao thông và trạng thái cho các chuyến đi theo yêu cầu và nhiệm vụ theo lịch trình. Dịch vụ này sử dụng dữ liệu vị trí và tuyến đường từ SDK Tài xế, đồng thời hoạt động với SDK Người tiêu dùng và các API khác của Google Maps Platform.

Dịch vụ Fleet Engine: thông tin chính

  • Sản phẩm: Dịch vụ Fleet Engine
  • Còn được gọi là: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • Danh mục: Tuyến đường
  • Nền tảng: Dịch vụ web (REST)
  • Chạy trên: Máy chủ (mã phụ trợ)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về dịch vụ Fleet Engine

Dịch vụ Fleet Engine: trường hợp sử dụng

Sử dụng dịch vụ Fleet Engine khi:

  • Bạn cần có một phần phụ trợ để lập mô hình cho các phương tiện và chuyến đi theo yêu cầu (điểm đón, điểm tham chiếu, điểm trả khách), bao gồm cả chuyến đi có nhiều điểm đến, chuyến đi liên tiếp hoặc chuyến đi chung.
  • Bạn cần lập mô hình cho các nhiệm vụ giao hàng hoặc dịch vụ theo lịch được giao cho các xe, đồng thời theo dõi các điểm dừng, kết quả và thời gian đến dự kiến (ETA) của các xe đó.
  • Bạn cần tìm kiếm hoặc liệt kê các xe trong một khu vực để so khớp với các chuyến đi được yêu cầu.
  • Bạn cần theo dõi chuyến đi hoặc lô hàng của người tiêu dùng và theo dõi nhà điều hành đội xe dựa trên thông báo cập nhật vị trí của SDK Trình điều khiển.

Không sử dụng Dịch vụ Fleet Engine khi:

  • Bạn cần hiển thị điểm đánh dấu GPS hoặc đường đi của tài sản theo thời gian thực trên bản đồ web từ cơ sở dữ liệu hoặc luồng của riêng bạn mà không cần sử dụng tính năng điều phối chuyến đi hoặc nhiệm vụ của Fleet Engine. Thay vào đó, hãy sử dụng Maps JavaScript API.
  • Bạn cần hiển thị điểm đánh dấu hoặc đường đi trực tiếp từ dữ liệu của riêng mình trong một ứng dụng Android mà không cần có hoạt động điều phối chuyến đi hoặc nhiệm vụ của Fleet Engine. Hãy sử dụng Maps SDK cho Android.
  • Bạn cần hiển thị điểm đánh dấu hoặc đường đi trực tiếp từ dữ liệu của riêng mình trong một ứng dụng iOS mà không cần có hoạt động điều phối chuyến đi hoặc nhiệm vụ của Công cụ quản lý đội xe. Hãy sử dụng SDK bản đồ dành cho iOS.
  • Bạn cần tính toán kế hoạch tuyến đường tối ưu cho toàn đội xe; Fleet Engine chỉ lấy kế hoạch tuyến đường từ một trình giải mà bạn cung cấp. Thay vào đó, hãy sử dụng Route Optimization API.

Dịch vụ Fleet Engine: thiết lập

Các gói dịch vụ chính thức của Fleet Engine:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Dịch vụ Fleet Engine: các lỗi thường gặp

  • Vấn đề: Đôi khi, các yêu cầu gửi đến Fleet Engine có thể không thành công và sau khi không thành công, các thực thể như xe có thể không còn tồn tại (NOT_FOUND khi cập nhật). Cách khắc phục: Triển khai cơ chế thử lại có thời gian đợi (thư viện ứng dụng thử lại theo mặc định) và tạo lại các xe hoặc nhiệm vụ bị thiếu ở trạng thái hiện tại. Hãy xem /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Vấn đề: Lỗi DEADLINE_EXCEEDED xảy ra khi một yêu cầu mất nhiều thời gian hơn thời gian chờ mặc định của thư viện ứng dụng. Cách khắc phục: Điều chỉnh chế độ cài đặt thử lại RPC (ví dụ: setTotalTimeout trên VehicleServiceSettings trong ứng dụng Java). Hãy xem /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Vấn đề: PERMISSION_DENIED (HTTP 403) khi JWT thiếu các thông báo xác nhận quyền sở hữu chính xác hoặc tài khoản dịch vụ ký thiếu vai trò IAM bắt buộc của Fleet Engine (ví dụ: "JWT không chứa phạm vi phù hợp cho chuyến đi được yêu cầu"). Cách khắc phục: Kiểm tra vai trò của tài khoản dịch vụ và đảm bảo các thông báo xác nhận quyền sở hữu JWT bao gồm phạm vi cho xe, chuyến đi hoặc nhiệm vụ đang được truy cập. Hãy xem /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Vấn đề: Khi di chuyển từ dịch vụ Chuyến đi và giao hàng theo yêu cầu sang bất kỳ gói Mobility nào, hoặc từ Giải pháp đội xe chặng cuối sang Mobility Activate hoặc Optimize, các yêu cầu API thanh toán của Mobility sẽ trả về HTTP 202 cho đến khi quá trình di chuyển hoàn tất và không tính phí. Cách khắc phục: Gọi cả Fleet Engine ReportBillableTrip và Mobility Billing API từ vài ngày trước cho đến vài ngày sau khi di chuyển, so sánh số lượng yêu cầu trong Cloud Logging, sau đó xoá các lệnh gọi ReportBillableTrip. Hãy xem /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Dịch vụ Fleet Engine: các tính năng cũ và không còn được dùng nữa

  • Phương thức UpdateVehicleLocation: Ngừng hoạt động kể từ ngày 1 tháng 5 năm 2024. Thay thế: UpdateVehicle trong VehicleService. Triệu chứng: Ngừng hoạt động từ ngày 1 tháng 2 năm 2024; ngừng hoạt động từ tháng 5 năm 2024.
  • Phương thức SearchFuzzedVehicles: Ngừng hoạt động kể từ ngày 1 tháng 5 năm 2024. Thay thế: SearchVehicles trong VehicleService. Triệu chứng: Ngừng hoạt động từ ngày 1 tháng 2 năm 2024; ngừng hoạt động từ tháng 5 năm 2024.
  • Phương thức SearchTasks: Ngừng hoạt động kể từ ngày 1 tháng 5 năm 2024. Thay thế: GetTaskTrackingInfo trong DeliveryService. Triệu chứng: Ngừng hoạt động từ ngày 1 tháng 2 năm 2024; ngừng hoạt động từ tháng 5 năm 2024.
  • ReportBillableTrip sau khi di chuyển sang một gói Di chuyển (Chuyến đi và giao hàng theo yêu cầu sang bất kỳ gói nào, hoặc Giải pháp quản lý đội xe chặng cuối sang gói Kích hoạt hoặc Tối ưu hoá): Cũ. API thay thế: Mobility Billing API reportBillableEvent. Triệu chứng: Tuỳ theo hợp đồng, không phải do ngừng sử dụng API. Sau khi di chuyển, các lệnh gọi có thể trả về thông báo "Hợp đồng không hợp lệ: Dự án này [...] không được phép sử dụng FleetEngine". Xem hướng dẫn di chuyển.

Những việc bạn có thể làm với Dịch vụ Fleet Engine

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.