VehicleJourneySegment

Représente le segment de trajet d'un véhicule, entre son arrêt précédent et l'arrêt actuel. S'il s'agit du premier arrêt actif, il s'agit de la distance entre l'emplacement actuel du véhicule et cet arrêt.

Représentation JSON
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Champs
stop

object (VehicleStop)

Spécifie l'emplacement de l'arrêt, ainsi que les Task associés à l'arrêt. Il est possible que certains champs du champ VehicleStop ne soient pas présents si ce segment de trajet fait partie de JourneySharingInfo.

drivingDistanceMeters

integer

Uniquement en sortie. Distance parcourue entre l'arrêt précédent et cet arrêt. Si l'arrêt actuel est le premier arrêt de la liste des segments du trajet, le point de départ correspond à la position du véhicule enregistrée au moment où cet arrêt a été ajouté à la liste. Ce champ peut ne pas être présent si ce segment de trajet fait partie de JourneySharingInfo.

drivingDuration

string (Duration format)

Uniquement en sortie. Durée du trajet entre l'arrêt précédent et cet arrêt. Si l'arrêt actuel est le premier de la liste des segments de trajet, le point de départ correspond à l'emplacement du véhicule enregistré au moment où cet arrêt a été ajouté à la liste.

Si ce champ est défini dans le chemin Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST), il peut être renseigné avec la valeur de DeliveryVehicle.remaining_duration (gRPC) ou DeliveryVehicle.remainingDuration (REST). Cela indique la durée de conduite restante à partir de la dernière position connue de l'application conducteur, plutôt que le temps de trajet à partir de l'arrêt précédent.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

path[]

object (LatLng)

Uniquement en sortie. Trajet entre l'arrêt précédent et cet arrêt. Si l'arrêt actuel est le premier de la liste des segments de trajet, il s'agit du trajet entre l'emplacement actuel du véhicule et cet arrêt au moment où l'arrêt a été ajouté à la liste. Ce champ peut ne pas être présent si ce segment de parcours fait partie de JourneySharingInfo.

Si ce champ est défini dans le chemin Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), il peut être renseigné avec les LatLng décodées à partir de DeliveryVehicle.current_route_segment (gRPC) ou DeliveryVehicle.currentRouteSegment (REST). Vous obtenez ainsi le trajet en voiture à partir de la dernière position connue de l'application du conducteur, plutôt qu'à partir de l'arrêt précédent.

VehicleStop

Décrit un point où un véhicule s'arrête pour effectuer un ou plusieurs Task.

Représentation JSON
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Champs
plannedLocation

object (LocationInfo)

Obligatoire. Emplacement de l'arrêt. Notez que les emplacements des Task ne correspondent pas nécessairement exactement à cet emplacement, mais se trouvent à une courte distance de celui-ci. Ce champ ne sera pas renseigné dans la réponse à un appel tasks.get.

tasks[]

object (TaskInfo)

Liste des Task à effectuer à cet arrêt. Ce champ ne sera pas renseigné dans la réponse à un appel tasks.get.

state

enum (State)

État de l'VehicleStop. Ce champ ne sera pas renseigné dans la réponse d'un appel tasks.get.

TaskInfo

Informations supplémentaires sur la tâche effectuée à cet arrêt.

Représentation JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Champs
taskId

string

ID de la tâche. Ce champ ne sera pas renseigné dans la réponse à un appel tasks.get. Les ID de tâche sont soumis aux restrictions suivantes :

  • Doit être une chaîne de caractères Unicode valide.
  • Ne doit pas dépasser 64 caractères.
  • Normalisée selon le formulaire C de normalisation Unicode.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ou "#".
taskDuration

string (Duration format)

Uniquement en sortie. Temps nécessaire à l'exécution de la tâche.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

targetTimeWindow

object (TimeWindow)

Uniquement en sortie. La période pendant laquelle la tâche doit être terminée. Il n'est défini que dans la réponse à deliveryVehicles.get.

État

État actuel d'un VehicleStop.

Enums
STATE_UNSPECIFIED Inconnu.
NEW Créé, mais pas le routage actif.
ENROUTE Attribué et en cours de routage.
ARRIVED Arrivé à l'arrêt. Part du principe que lorsque le véhicule emprunte les itinéraires vers le prochain arrêt, tous les arrêts précédents sont terminés.