Pour obtenir des informations générales sur le fonctionnement des véhicules dans Fleet Engine, consultez la les guides suivants de la section essentielle 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 de serveurs Fleet Engine refléter les véhicules réels dans vos opérations réelles. Votre Fleet Engine les véhicules doivent également correspondre à ceux utilisés dans votre système backend pour l'attribution des véhicules et l'itinéraire à suivre.
Pour créer une ressource de véhicule, vous allez utiliser une méthode de création, à l'aide de gRPC ou REST. Pour plus de simplicité, les noms de champs présentés dans 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 tâches à la demande et planifiées, vous créez et mettez à jour un véhicule en émettant un message de demande avec des champs résumés comme suit:
- Parent: une chaîne associée à l'ID de votre projet Google Cloud, utilisée pour remplir le champ de nom de l'instance de véhicule.
Identifiant du véhicule: chaîne unique permettant de renseigner le champ
name
. du véhicule.Une instance de véhicule avec ses champs obligatoires. Ces champs dépendent la capacité Fleet Engine que vous utilisez.
Les informations contenues dans le corps de la requête varient en fonction de la nature de celle-ci. Voir ces détails dans leurs guides respectifs.
Jetons d'authentification et d'autorisation
Les requêtes envoyées à Fleet Engine doivent également fournir les identifiants d'accès corrects. Les exemples de ce guide reposent sur les hypothèses suivantes:
- Les exemples gRPC supposent l'utilisation de la bibliothèque Authorization pour Java.
- Les exemples REST illustrent un en-tête de requête HTTP, qui doit contenir le paramètre
champ
Authorization
ayant la valeurBearer <token>
, où<token>
est un Jeton Web JSON que vous générez.
Pour en savoir plus, consultez les guides Configurer Fleet Engine.
Champs de ressources de véhicule
Une ressource "Véhicule" présente les types de champs suivants:
- Champs de sortie uniquement : Les champs définis par le service en tant que sortie de
une autre méthode et ne peuvent pas être définis directement. Un domaine important de cette
le type est le champ
name
. Fleet Engine ignore toute valeur fournie pour le champ Champname
du véhicule conformément aux instructions de l'AIP de Google pour spécifié par l'utilisateur ID. Si vous fournissez des valeurs pour ces champs, Fleet Engine renvoie une erreur. - Champs obligatoires : Les véhicules créés dans le service de trajet à la demande doivent que certains champs sont définis lors de la création. Véhicules créés à la période des tâches n'ont pas de champ de ressource de véhicule requis.
- Champs facultatifs : Les deux services disposent de champs que vous pouvez définir lors de la création ou après. Vous les trouverez dans le guide de référence correspondant que vous utilisez.
Nom du véhicule (sortie uniquement)
Le champ name
est exactement le même pour les trajets à la demande et les tâches planifiées.
services. Fleet Engine définit le champ lorsque vous créez le véhicule, en fonction
deux champs que vous définissez lors de la création du véhicule:
Parent: une chaîne associée à l'ID de votre projet Google Cloud au format
providers/{provider}
, où{provider}
est l'ID de votre projet. 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 le fichier Fleet Engine des rôles de compte de service pour le service que vous utilisez. Consultez la section Comptes de service pour connaître les une liste de ces comptes de service. L'accès depuis Fleet Engine n'est pas possible plusieurs projets Google Cloud.
L'identifiant du véhicule, qui doit être unique pour tous les véhicules de votre un parc et une chaîne Unicode valide. Il s'agit de l'ID de ressource de véhicule. Les trajets à la demande et les arrêts planifiés l'utilisent pour associer un trajet ou une tâche avec le 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 la section Dénomination des ressources dans Fleet Engine.
Identifiants d'entité uniques
Le format et la valeur des identifiants d'entité uniques utilisés dans les appels de ressource sont les suivants : opaque pour Fleet Engine. Assurez-vous que l'identifiant ne contient Informations permettant d'identifier personnellement l'utilisateur, telles que le numéro de téléphone du conducteur
Réutilisation de véhicules
Une fois qu'un véhicule a terminé tous les arrêts d'un itinéraire donné, il reste disponible pour réutiliser un véhicule dans Fleet Engine pendant sept jours, ce qui signifie que vous pouvez réutiliser un véhicule sur jours ouvrables suivants sans avoir à en créer un autre. Chaque fois que vous réinitialise le véhicule, Fleet Engine réinitialise sa disponibilité, et l'état Le compte à rebours de sept jours recommence.
Pour qu'un véhicule reste disponible dans Fleet Engine, il est recommandé de procéder comme suit :
mettre à jour sa position à intervalles réguliers. Mises à jour de la plupart des autres champs du
L'entité Vehicle
prolonge également sa durée de vie, à condition que la nouvelle valeur du champ soit
différente de celle existante.
REMARQUE: Certains champs de l'entité Vehicle
, comme device_settings
, ne sont utilisés qu'à des fins de débogage
des informations qui ne sont pas conservées par Fleet Engine. Leur mise à jour n'entraîne
prolonger la durée de vie de l'entité Vehicle
.
Pour améliorer l'analyse système, il est préférable de réutiliser le même ID de véhicule à conducteur leur association de jour en jour. Pour ce faire, utilisez le même identifiant de véhicule que le chauffeur pour les arrêts programmés précédents ou les trajets à la demande.