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 Service: сопутствующие товары
- Часто используется с: Driver SDK для Android, Driver SDK для iOS, Consumer SDK для Android, Consumer SDK для iOS, JavaScript Consumer SDK, Route Optimization API.
Сервис 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 APIreportBillableEvent. Признак. Ошибка связана с контрактом, а не с прекращением поддержки API. После переноса вызовы могут возвращать ошибку "Invalid Contract: This project [...] is not authorized to use FleetEngine" (Недействительный контракт: у проекта [...] нет разрешения на использование FleetEngine). Ознакомьтесь с руководством по переносу.
Что можно делать с помощью Fleet Engine Service
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Отчет об использовании поездок Fleet Engine, подлежащих оплате
- Создание и возврат новой поездки Fleet Engine.
- Возвращает информацию о поездке Fleet Engine.
- Возвращает список всех поездок Fleet Engine для указанного транспортного средства.
- Обновление данных о поездке в Fleet Engine.
- Создайте экземпляр нового транспортного средства в Fleet Engine, связанный с поставщиком услуг по совместным поездкам или доставке по запросу.
- Возврат транспортного средства из сервиса Fleet Engine.
- Возвращает разбитый на страницы список транспортных средств в Fleet Engine, связанных с поставщиком, которые соответствуют указанным критериям.
- Возвращает список транспортных средств в Fleet Engine, соответствующих заданным критериям.
- Обновление данных о транспортном средстве в Fleet Engine.
- Обновление атрибутов транспортного средства в Fleet Engine.
- Как получить информацию о рейсе транспортного средства из сервиса Fleet Engine