Pour en savoir plus sur le fonctionnement des véhicules dans Fleet Engine, consultez les guides suivants dans la section "Éléments essentiels de Fleet Engine" :
La documentation de cette section explique comment créer et gérer des véhicules dans Fleet Engine. Vous créez des véhicules dans l'environnement serveur Fleet Engine pour refléter les véhicules réels de votre activité. Les véhicules de Fleet Engine doivent également correspondre à ceux utilisés dans votre système backend que vous utilisez pour l'attribution et l'itinéraire des véhicules.
Vous utilisez une méthode de création pour créer une ressource de véhicule, à l'aide de gRPC ou de REST. Pour des raisons de simplicité, les noms de champs de ce guide utilisent la notation gRPC.
Voyages à la demande
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)- Ressource
Vehicle(REST, gRPC)
Tâches planifiées
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
Demandes de véhicules
Pour les fonctionnalités de tâche à la demande et planifiée, vous créez et mettez à jour un véhicule en envoyant un message de requête avec des champs, résumés comme suit:
- Parent: chaîne associée à votre ID de projet Google Cloud, utilisée pour renseigner le champ de nom de l'instance de véhicule.
ID du véhicule: chaîne unique utilisée pour renseigner le champ
namedu véhicule.Instance de véhicule avec ses champs obligatoires. Ces champs dépendent de la fonctionnalité Fleet Engine que vous utilisez.
Les informations du corps de la requête varient en fonction de la nature de la requête. Pour en savoir plus, consultez les guides correspondants.
Jetons d'authentification et d'autorisation
Les requêtes envoyées à Fleet Engine doivent également fournir les identifiants d'accès appropriés. Les exemples de ce guide partent des hypothèses suivantes:
- Les exemples gRPC supposent l'utilisation de la bibliothèque d'autorisation pour Java.
- Les exemples REST illustrent un en-tête de requête HTTP, qui doit contenir le champ
Authorizationavec une valeur deBearer <token>, où<token>est un jeton Web JSON que vous émettez.
Pour en savoir plus, consultez les guides Configurer Fleet Engine.
Champs des ressources de véhicule
Une ressource de véhicule comporte les types de champs suivants:
- Champs de sortie uniquement Champs définis par le service en tant que sortie d'une autre méthode et ne pouvant pas être définis directement. Le champ
nameest un champ important de ce type. Fleet Engine ignore toute valeur fournie pour le champnamedu véhicule, conformément aux instructions de Google AIP pour les identifiants spécifiés par l'utilisateur. Si vous fournissez des valeurs pour ces champs, Fleet Engine renvoie une erreur. - Champs obligatoires Les véhicules créés dans le service de trajets à la demande nécessitent que certains champs soient définis lors de leur création. Les véhicules créés dans le service de tâches planifiées ne comportent aucun champ de ressource de véhicule obligatoire.
- Champs facultatifs Les deux services disposent de champs que vous pouvez définir lors de la création ou par la suite. Vous les trouverez dans le guide de référence correspondant au service que vous utilisez.
Nom du véhicule (sortie uniquement)
Le champ name est exactement le même pour les trajets à la demande et les services de tâches planifiées. Fleet Engine définit le champ lorsque vous créez le véhicule, en fonction de deux champs que vous définissez lors de la création du véhicule:
Parent: chaîne associée à votre ID de projet Google Cloud au format
providers/{provider}, où{provider}correspond à l'ID de votre projet Cloud. Chaque véhicule que vous créez pour un projet donné aura le même chemin parent.Le projet Cloud auquel vous faites référence ici doit également contenir les rôles de compte de service Fleet Engine pour le service que vous utilisez. Pour obtenir la liste de ces comptes de service, consultez Comptes de service. Fleet Engine n'est pas compatible avec l'accès à partir de plusieurs projets Google Cloud.
Identifiant du véhicule, qui doit être unique pour tous les véhicules de votre flotte et être une chaîne Unicode valide. Il s'agit de l'ID de ressource du véhicule. Les trajets à la demande et les arrêts planifiés l'utilisent pour associer un trajet ou une tâche au véhicule qui l'effectue.
Dans les services basés sur Google Cloud, toutes les API doivent représenter les ressources sous forme de chaînes. Pour en savoir plus, consultez Nommer des ressources dans Fleet Engine.
Identifiants d'entités uniques
Le format et la valeur des identifiants d'entité uniques utilisés dans les appels de ressources sont opaques pour Fleet Engine. Assurez-vous que l'identifiant ne contient aucune information permettant d'identifier personnellement l'utilisateur, comme le numéro de téléphone du conducteur.
Réutilisation de véhicules
Une fois qu'un véhicule a effectué tous les arrêts d'un itinéraire donné, il reste disponible pour être réutilisé dans Fleet Engine pendant sept jours. Vous pouvez donc réutiliser un véhicule les jours ouvrés suivants sans avoir à en créer un autre. Chaque fois que vous réutilisez un véhicule, Fleet Engine réinitialise sa disponibilité, à partir de quoi le compte à rebours de sept jours recommence.
Pour que votre véhicule reste disponible dans Fleet Engine, nous vous recommandons de mettre à jour sa position à intervalles réguliers. Les mises à jour de la plupart des autres champs de l'entité Vehicle prolongent également sa durée de vie, à condition que la nouvelle valeur du champ soit différente de l'ancienne.
REMARQUE: Certains champs de l'entité Vehicle, comme device_settings, sont des informations de débogage pures qui ne sont pas conservées par Fleet Engine. Leur mise à jour n'étend pas la durée de vie de l'entité Vehicle.
Pour améliorer les analyses du système, il est préférable de réutiliser le même appariement conducteur-ID de véhicule au fil du temps. Pour ce faire, utilisez le même ID de véhicule associé au conducteur pour les arrêts planifiés ou les trajets à la demande précédents.