Pour obtenir des informations générales sur le fonctionnement des véhicules dans Fleet Engine, consultez les guides suivants dans la section "Principes de base 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 opération. Vos véhicules Fleet Engine doivent également correspondre à ceux utilisés dans votre système backend pour l'attribution et le routage des véhicules.
Vous utilisez une méthode de création pour créer une ressource de véhicule, soit à l'aide de gRPC, soit à l'aide de REST. Pour plus de simplicité, les noms de champs de ce guide utilisent la notation gRPC.
Trajets à 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âches à la demande et planifiées, 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 à l'ID de votre projet Google Cloud, utilisée pour remplir le champ "name" de l'instance de véhicule.
ID du véhicule : chaîne unique utilisée pour remplir 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 contenues dans le 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 adressées à Fleet Engine doivent également fournir les identifiants d'accès appropriés. Les exemples de ce guide reposent sur les 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 la valeurBearer <token>, où<token>est un jeton Web JSON que vous émettez.
Pour en savoir plus, consultez les guides Configurer Fleet Engine.
Champs de ressources de véhicule
Une ressource de véhicule comporte les types de champs suivants :
- Champs en sortie uniquement : Champs définis par le service en tant que résultat d'une autre méthode et qui ne peuvent pas être définis directement. Un champ important de ce type est le champ
name. Fleet Engine ignore toute valeur fournie pour le champnamedu véhicule, conformément aux consignes de Google AIP pour les ID spécifiés par l'utilisateur. Si vous fournissez des valeurs pour ces champs, Fleet Engine renvoie une erreur. - Champs obligatoires Pour les véhicules créés dans le service de trajets à la demande, certains champs doivent être définis lors de la 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 comportent des champs que vous pouvez définir lors de la création ou ultérieurement. 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 à l'ID de votre 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 depuis plusieurs projets Google Cloud.
ID 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 utilisent cette propriété 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 Nommage des ressources dans Fleet Engine.
Identifiants uniques des entités
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 (PII), 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. Cela signifie que vous pouvez réutiliser un véhicule les jours ouvrés suivants sans avoir à en créer un nouveau. Chaque fois que vous réutilisez un véhicule, Fleet Engine réinitialise sa disponibilité, et le compte à rebours de sept jours recommence.
L'approche recommandée pour qu'un véhicule reste disponible dans Fleet Engine consiste à mettre à jour sa position à intervalles réguliers. La durée de vie de l'entité Vehicle sera également prolongée si la valeur de la plupart des autres champs est modifiée, à condition que la nouvelle valeur soit différente de celle existante.
REMARQUE : Certains champs de l'entité Vehicle, comme device_settings, sont des informations de débogage qui ne sont pas conservées par Fleet Engine. Leur mise à jour ne prolonge pas la durée de vie de l'entité Vehicle.
Pour améliorer les analyses système, il est préférable de réutiliser la même association ID conducteur-véhicule d'un jour à l'autre. Pour ce faire, utilisez le même ID de véhicule associé au chauffeur pour les arrêts planifiés ou les trajets à la demande précédents.