Краткий справочник по Fleet Engine Service

Fleet Engine – это бэкенд-сервис, который моделирует ваш реальный парк транспортных средств и предоставляет информацию о маршрутах, расчетном времени прибытия, дорожном движении и статусе поездок по запросу и запланированных задач. Он использует данные о местоположении и маршруте из Driver SDK и работает с Consumer SDK и другими API платформы Google Карт.

Fleet Engine Service: основные сведения

  • Продукт: Fleet Engine Service.
  • Другие названия: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API.
  • Категория: маршруты.
  • Платформа: веб-сервис (REST).
  • Где выполняется: на сервере (код бэкенда).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Fleet Engine Service

Когда использовать Fleet Engine Service

Используйте Fleet Engine Service, если:

  • Вам нужен бэкенд, который моделирует транспортные средства и поездки по запросу (посадка, путевые точки, высадка), включая поездки с несколькими пунктами назначения, последовательные и совместные поездки.
  • Вам нужно смоделировать запланированные задачи по доставке или обслуживанию, назначенные транспортным средствам, и отслеживать их остановки, результаты и расчетное время прибытия.
  • Чтобы сопоставить транспортные средства с запрошенными поездками, вам нужно выполнить поиск или получить список транспортных средств в регионе.
  • Вам нужно отслеживать поездки клиентов или доставку грузов, а также работу операторов автопарка, используя данные о местоположении, которые передает Driver SDK.

Не используйте Fleet Engine Service, если:

  • Вам нужно показывать на веб-карте маркеры GPS или маршруты объектов из собственной базы данных или потока, не используя Fleet Engine для управления поездками или задачами. Используйте Maps JavaScript API.
  • Вам нужно показывать маркеры или маршруты в реальном времени на основе собственных данных в приложении для Android без использования Fleet Engine для поездок или задач. Используйте Maps SDK для Android.
  • Вам нужно показывать маркеры или маршруты в реальном времени на основе собственных данных в приложении для iOS, не используя Fleet Engine для управления поездками или задачами. Используйте Maps SDK для iOS.
  • Вам нужно рассчитать оптимизированные планы маршрутов для всего автопарка. Fleet Engine принимает планы маршрутов только от предоставленного вами решателя. Используйте Route Optimization API.

Сервис Fleet Engine: настройка

  • Сервис, который нужно включить: fleetengine.googleapis.com.
  • Аутентификация: сервисный аккаунт, веб-токен JSON (JWT), OAuth 2.0.
  • Атрибуция использования. Необязательная бета-функция: задайте для HTTP-заголовка X-Goog-Maps-Experience-ID идентификатор транзакции Mobility (или связанный идентификатор, например идентификатор сеанса) при вызовах сервисов пакета Mobility. Если идентификаторов несколько, разделите их запятыми. При регистрации транзакции передавайте все связанные идентификаторы в related_ids.
  • Начало работы: настройка Fleet Engine Service
  • Справочные материалы: справочные материалы по Fleet Engine Service.
  • Правила: правила сервиса Fleet Engine.
  • Примечания к выпуску: Примечания к выпуску Fleet Engine Service

Официальные пакеты Fleet Engine Service:

  • 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

Сервис Fleet Engine: распространенные ошибки

  • Проблема. Запросы к Fleet Engine могут иногда завершаться ошибкой, после чего объекты, например транспортные средства, могут перестать существовать (NOT_FOUND при обновлении). Решение. Повторите попытку с экспоненциальной задержкой (клиентские библиотеки делают это по умолчанию) и заново создайте отсутствующие транспортные средства или задачи в их текущем состоянии. Подробнее: /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Проблема. Ошибки DEADLINE_EXCEEDED возникают, когда запрос выполняется дольше, чем задано в настройках времени ожидания клиентской библиотеки. Решение. Измените настройки повторных попыток RPC (например, setTotalTimeout в VehicleServiceSettings в клиенте Java). Подробнее: /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Проблема. PERMISSION_DENIED (HTTP 403), если в JWT отсутствуют правильные утверждения или у сервисного аккаунта подписи нет необходимой роли IAM Fleet Engine (например, "JWT does not contain a matching scope for requested trip"). Решение. Проверьте роли сервисного аккаунта и убедитесь, что утверждения JWT включают области действия для транспортного средства, поездки или задачи, к которым осуществляется доступ. Подробнее: /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Проблема. При переходе с On-Demand Rides and Deliveries на любой пакет Mobility или с Last Mile Fleet Solution на Mobility Activate или Optimize запросы к Mobility Billing API возвращают код HTTP 202, пока переход не будет завершен, и не приводят к списанию средств. Решение. Вызывайте Fleet Engine ReportBillableTrip и Mobility Billing API в течение нескольких дней до и после переноса, сравните количество запросов в Cloud Logging, а затем удалите вызовы ReportBillableTrip. Подробнее: /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Сервис Fleet Engine: устаревшие и неподдерживаемые функции

  • Метод UpdateVehicleLocation выведен из эксплуатации 1 мая 2024 г. Замена: UpdateVehicle в VehicleService. Symptom. Поддержка прекращена 1 февраля 2024 г. Вывод из эксплуатации – май 2024 г.
  • Метод SearchFuzzedVehicles выведен из эксплуатации 1 мая 2024 г. Замена: SearchVehicles в VehicleService. Symptom. Поддержка прекращена 1 февраля 2024 г. Вывод из эксплуатации – май 2024 г.
  • Метод SearchTasks выведен из эксплуатации 1 мая 2024 г. Замена: GetTaskTrackingInfo в DeliveryService. Symptom. Поддержка прекращена 1 февраля 2024 г. Вывод из эксплуатации – май 2024 г.
  • ReportBillableTrip после перехода на пакет Mobility (с On-Demand Rides and Deliveries по запросу на любой пакет или с Last Mile Fleet Solution на Activate или Optimize): Legacy. Замена: Mobility Billing API reportBillableEvent. Признак. Ошибка связана с контрактом, а не с прекращением поддержки API. После переноса вызовы могут возвращать ошибку "Invalid Contract: This project [...] is not authorized to use FleetEngine" (Недействительный контракт: у проекта [...] нет разрешения на использование FleetEngine). Ознакомьтесь с руководством по переносу.

Что можно делать с помощью Fleet Engine Service

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.