Guide de référence rapide du service Fleet Engine

Fleet Engine est un service de backend qui modélise votre parc de véhicules réel et fournit des informations sur l'itinéraire, l'heure d'arrivée prévue, le trafic et l'état des trajets à la demande et des tâches planifiées. Il utilise les données de localisation et d'itinéraire du SDK Driver, et fonctionne avec le SDK Consumer et d'autres API Google Maps Platform.

Service Fleet Engine : informations clés

  • Produit : service Fleet Engine
  • Également appelée : Fleet Engine, API Fleet Engine, API Local Rides and Deliveries
  • Catégorie : Routes
  • Plate-forme : service Web (REST)
  • S'exécute sur : le serveur (code backend)
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation du service Fleet Engine

Service Fleet Engine : quand l'utiliser ?

Utilisez le service Fleet Engine lorsque :

  • Vous avez besoin d'un backend qui modélise les véhicules et les trajets à la demande (prise en charge, points de cheminement, dépose), y compris les trajets multidestinations, consécutifs ou partagés.
  • Vous devez modéliser les tâches de livraison ou de service planifiées attribuées aux véhicules, et suivre leurs arrêts, leurs résultats et leurs heures d'arrivée prévues.
  • Vous devez rechercher ou lister des véhicules dans une région pour les faire correspondre aux trajets demandés.
  • Vous avez besoin d'un suivi des trajets ou des expéditions des clients, ainsi que d'un suivi des opérateurs de flotte, alimentés par les notifications de position du SDK Driver.

N'utilisez pas le service Fleet Engine dans les cas suivants :

  • Vous devez afficher des repères GPS ou des trajets d'éléments en temps réel sur une carte Web à partir de votre propre base de données ou flux, sans l'orchestration des trajets ou des tâches de Fleet Engine. Utilisez plutôt l'API Maps JavaScript.
  • Vous devez afficher des repères ou des trajets en temps réel à partir de vos propres données dans une application Android, sans orchestration de trajets ou de tâches Fleet Engine. Utilisez plutôt le SDK Maps pour Android.
  • Vous devez afficher des repères ou des trajets en temps réel à partir de vos propres données dans une application iOS, sans l'orchestration des trajets ou des tâches de Fleet Engine. Utilisez plutôt le SDK Maps pour iOS.
  • Vous devez calculer des plans de tournée optimisés pour l'ensemble de votre flotte. Fleet Engine n'accepte que les plans de tournée provenant d'un résolveur que vous fournissez. Utilisez plutôt l'API Route Optimization.

Service Fleet Engine : configuration

Packages de service Fleet Engine officiels :

  • 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

Service Fleet Engine : erreurs courantes

  • Problème : Les requêtes envoyées à Fleet Engine peuvent échouer occasionnellement. Après un échec, il est possible que des entités telles que des véhicules n'existent plus (NOT_FOUND lors de la mise à jour). Solution : Implémentez de nouvelles tentatives avec intervalle exponentiel entre les tentatives (les bibliothèques clientes effectuent de nouvelles tentatives par défaut) et recréez les véhicules ou les tâches manquants dans leur état actuel. Consultez /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problème : Des erreurs DEADLINE_EXCEEDED se produisent lorsqu'une requête prend plus de temps que le délai avant expiration par défaut de la bibliothèque cliente. Solution : Ajustez les paramètres de nouvelle tentative RPC (par exemple, setTotalTimeout sur VehicleServiceSettings dans le client Java). Consultez /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problème : PERMISSION_DENIED (HTTP 403) lorsque le jeton JWT ne contient pas les revendications appropriées ou que le compte de service de signature ne dispose pas du rôle IAM Fleet Engine requis (par exemple, "Le jeton JWT ne contient pas de champ d'application correspondant au trajet demandé"). Solution : Vérifiez les rôles du compte de service et assurez-vous que les revendications JWT incluent des champs d'application pour le véhicule, le trajet ou la tâche auxquels vous accédez. Consultez /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problème : Lors de la migration de On-Demand Rides and Deliveries vers un package Mobility, ou de Last Mile Fleet Solution vers Mobility Activate ou Optimize, les requêtes de l'API Mobility Billing renvoient le code HTTP 202 jusqu'à ce que la migration soit terminée et n'entraînent pas de facturation. Solution : Appelez Fleet Engine ReportBillableTrip et l'API Mobility Billing quelques jours avant et après la migration, comparez le nombre de requêtes dans Cloud Logging, puis supprimez les appels ReportBillableTrip. Consultez /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Service Fleet Engine : anciennes fonctionnalités et fonctionnalités obsolètes

  • Méthode UpdateVehicleLocation : abandonnée depuis le 01/05/2024. Remplacement : UpdateVehicle dans VehicleService. Symptom : obsolète depuis le 01/02/2024 ; mis hors service en mai 2024.
  • Méthode SearchFuzzedVehicles : abandonnée depuis le 01/05/2024. Remplacement : SearchVehicles dans VehicleService. Symptom : obsolète depuis le 01/02/2024 ; mis hors service en mai 2024.
  • Méthode SearchTasks : abandonnée depuis le 01/05/2024. Remplacement : GetTaskTrackingInfo dans DeliveryService. Symptom : obsolète depuis le 01/02/2024 ; mis hors service en mai 2024.
  • ReportBillableTrip après la migration vers un package Mobility (Courses et livraisons à la demande vers n'importe quel package, ou Solution du parc du dernier kilomètre vers Activate ou Optimize) : Ancien. Remplacement : API Mobility Billing reportBillableEvent. Symptôme : spécifique au contrat, et non à l'abandon d'une API. Après la migration, les appels peuvent renvoyer l'erreur "Invalid Contract: This project [...] is not authorized to use FleetEngine" (Contrat non valide : ce projet [...] n'est pas autorisé à utiliser Fleet Engine). Consultez le guide de migration.

Ce que vous pouvez faire avec le service Fleet Engine

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.