Package maps.fleetengine.delivery.v1

Index

DeliveryService

Le service de livraison du dernier kilomètre.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Crée et renvoie un lot d'objets Task.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Crée et renvoie un DeliveryVehicle.
CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Crée et renvoie un objet Task.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Supprime un DeliveryVehicle de Fleet Engine.

Renvoie FAILED_PRECONDITION si des tâches OPEN sont attribuées au DeliveryVehicle.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Supprime une seule tâche.

Renvoie FAILED_PRECONDITION si la tâche est OUVERTE et attribuée à un DeliveryVehicle.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Renvoie l'instance DeliveryVehicle spécifiée.
GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Obtient des informations sur un Task.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Renvoie l'instance TaskTrackingInfo spécifiée.
ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Récupère tous les DeliveryVehicle qui répondent aux critères de filtrage spécifiés.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Récupère tous les Task qui répondent aux critères de filtrage spécifiés.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Écrit les données DeliveryVehicle mises à jour dans Fleet Engine et attribue Tasks à DeliveryVehicle. Vous ne pouvez pas modifier le nom de DeliveryVehicle. Vous pouvez mettre à jour remaining_vehicle_journey_segments, mais il doit contenir tous les VehicleJourneySegment pour être conservé sur DeliveryVehicle. Les task_id sont récupérés à partir de remaining_vehicle_journey_segments, et leurs Tasks correspondants sont attribués aux DeliveryVehicle s'ils ne l'ont pas encore été.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Met à jour les données Task.

BatchCreateTasksRequest

Message de requête BatchCreateTask.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery. Remarque : Si vous définissez ce champ, le champ d'en-tête des messages CreateTaskRequest doit être vide ou correspondre à ce champ.
parent

string

Obligatoire. Ressource parente partagée par toutes les tâches. Cette valeur doit être au format providers/{provider}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project. Le champ parent des messages CreateTaskRequest doit être vide ou correspondre à ce champ.
requests[]

CreateTaskRequest

Obligatoire. Message de requête spécifiant les ressources à créer. Remarque : Vous pouvez créer jusqu'à 500 tâches dans un lot.

BatchCreateTasksResponse

Message de réponse BatchCreateTask.

Champs
tasks[]

Task

Tâches créées

CreateDeliveryVehicleRequest

Message de requête CreateDeliveryVehicle.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
parent

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud. Exemple :sample-cloud-project
delivery_vehicle_id

string

Obligatoire. L'ID du véhicule de livraison doit être unique et soumis aux restrictions suivantes :

  • Doit être une chaîne Unicode valide.
  • La longueur maximale est de 64 caractères.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ni "#".
delivery_vehicle

DeliveryVehicle

Obligatoire. Entité DeliveryVehicle à créer. Lorsque vous créez un véhicule de livraison, vous pouvez définir les champs facultatifs suivants :

  • type
  • last_location
  • attributs

Remarque : Le champ name de DeliveryVehicle est ignoré. Tous les autres champs DeliveryVehicle ne doivent pas être définis. Sinon, une erreur est renvoyée.

CreateTaskRequest

Message de requête CreateTask.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
parent

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.
task_id

string

Obligatoire. L'ID de la tâche doit être unique, mais il ne doit pas s'agir d'un ID de suivi de colis. Pour stocker un ID de suivi d'expédition, utilisez le champ tracking_id. Notez que plusieurs tâches peuvent avoir le même tracking_id. Les ID de tâches sont soumis aux restrictions suivantes :

  • Doit être une chaîne Unicode valide.
  • La longueur maximale est de 64 caractères.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ni "#".
task

Task

Obligatoire. Entité Task à créer. Lorsque vous créez une tâche, les champs suivants sont obligatoires :

  • type
  • state (doit être défini sur OPEN)
  • tracking_id (ne doit pas être défini pour les tâches UNAVAILABLE ou SCHEDULED_STOP, mais est obligatoire pour tous les autres types de tâches)
  • planned_location (facultatif pour les tâches UNAVAILABLE)
  • task_duration

Les champs suivants peuvent être définis de manière facultative :

  • target_time_window
  • task_tracking_view_config
  • attributes

Remarque : Le champ name de la tâche est ignoré. Tous les autres champs de la tâche ne doivent pas être définis, sinon une erreur est renvoyée.

DeleteDeliveryVehicleRequest

Message de requête DeleteDeliveryVehicle.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.

DeleteTaskRequest

Message de requête DeleteTask.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/tasks/{task}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.

DeliveryRequestHeader

Un RequestHeader contient des champs communs à toutes les requêtes RPC de diffusion.

Champs
language_code

string

Code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si aucune langue n'est spécifiée, la réponse peut être dans n'importe quelle langue, avec une préférence pour l'anglais si un tel nom existe. Exemple de valeur de champ : en-US.
region_code

string

Obligatoire. Code CLDR de la région d'origine de la requête. Exemple de valeur de champ : US.
sdk_version

string

Version du SDK d'appel, le cas échéant. Le format de la version est "major.minor.patch", par exemple 1.1.2.
os_version

string

Version du système d'exploitation sur lequel le SDK d'appel s'exécute. Exemples de valeurs de champ : 4.4.1, 12.1.
device_model

string

Modèle de l'appareil sur lequel le SDK d'appel s'exécute. Exemples de valeurs de champ : iPhone12,1, SM-G920F.
sdk_type

SdkType

Type de SDK qui envoie la requête.
maps_sdk_version

string

Version du SDK Maps dont dépend le SDK appelant, le cas échéant. Le format de la version est "major.minor.patch", par exemple 5.2.1.
nav_sdk_version

string

Version du NavSDK dont dépend le SDK appelant, le cas échéant. Le format de la version est "major.minor.patch", par exemple 2.1.0.
platform

Platform

Plate-forme du SDK appelant.
manufacturer

string

Fabricant de l'appareil Android à partir du SDK appelant. Ne s'applique qu'aux SDK Android. Exemple de valeur de champ : Samsung.
android_api_level

int32

Niveau d'API Android du SDK appelant. Ne s'applique qu'aux SDK Android. Exemple de valeur de champ : 23.
trace_id

string

ID facultatif pouvant être fourni à des fins de journalisation afin d'identifier la requête.

Plate-forme

Plate-forme du SDK appelant.

Enums
PLATFORM_UNSPECIFIED Valeur par défaut. Cette valeur est utilisée si la plate-forme est omise.
ANDROID La demande provient d'Android.
IOS La demande provient d'iOS.
WEB La demande provient du Web.

SdkType

Types de SDK possibles.

Enums
SDK_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur est utilisée si sdk_type est omis.
CONSUMER Le SDK d'appel est Consumer.
DRIVER Le SDK appelant est Driver.
JAVASCRIPT Le SDK d'appel est JavaScript.

DeliveryVehicle

Le message DeliveryVehicle. Un véhicule de livraison transporte des colis d'un dépôt vers un lieu de livraison, et d'un lieu de retrait vers le dépôt. Dans certains cas, les véhicules de livraison transportent également les colis directement du lieu de collecte au lieu de livraison.

Remarque : Les API gRPC et REST utilisent des conventions de dénomination de champs différentes. Par exemple, le champ DeliveryVehicle.current_route_segment de l'API gRPC et le champ DeliveryVehicle.currentRouteSegment de l'API REST font référence au même champ.

Champs
name

string

Nom unique de ce véhicule de livraison. Il a le format suivant : providers/{provider}/deliveryVehicles/{vehicle}.
last_location

DeliveryVehicleLocation

Dernière position signalée du véhicule de livraison.
past_locations[]

DeliveryVehicleLocation

Uniquement en entrée. Lieux où ce véhicule de livraison s'est trouvé dans le passé et qui n'ont pas encore été signalés à Fleet Engine. Cette option est utilisée dans UpdateDeliveryVehicleRequest pour enregistrer les positions qui n'ont pas pu être envoyées au serveur. Cela se produit généralement lorsque le véhicule de livraison n'est pas connecté à Internet.
navigation_status

DeliveryVehicleNavigationStatus

État de navigation du véhicule de livraison.
current_route_segment

bytes

Polyligne encodée spécifiant l'itinéraire que la navigation recommande d'emprunter pour atteindre le prochain point de repère. Votre application chauffeur met à jour cette information lorsqu'un arrêt est atteint ou dépassé, et lorsque la navigation est redirigée. Ces LatLng sont renvoyés dans Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) pour toutes les tâches actives attribuées au véhicule.

Dans certains cas, ce champ peut ne pas être utilisé pour renseigner Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) :

  • Le point de terminaison de current_route_segment ne correspond pas à DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) ni à DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • L'application chauffeur n'a pas mis à jour sa position récemment. La dernière valeur mise à jour pour ce champ peut donc être obsolète.

  • L'application du chauffeur a récemment mis à jour sa position, mais la current_route_segment est obsolète et pointe vers un arrêt précédent du véhicule.

Dans ce cas, Fleet Engine renseigne ce champ avec un itinéraire allant du VehicleStop le plus récemment passé au VehicleStop à venir. L'objectif est de s'assurer que le consommateur de ce champ dispose des meilleures informations disponibles sur le trajet actuel du véhicule de livraison.
current_route_segment_end_point

LatLng

Emplacement où se termine current_route_segment. Cette information n'est pas renseignée actuellement par l'application chauffeur, mais vous pouvez la fournir lors des appels UpdateDeliveryVehicle. Il s'agit soit du LatLng du prochain arrêt du véhicule, soit du dernier LatLng du current_route_segment. Fleet Engine fera ensuite de son mieux pour interpoler un VehicleStop réel.

Ce champ est ignoré dans les appels UpdateDeliveryVehicle si le champ current_route_segment est vide.
remaining_distance_meters

Int32Value

Distance de conduite restante pour current_route_segment. L'application Driver fournit généralement ce champ, mais dans certains cas, Fleet Engine remplace la valeur envoyée par l'application. Pour en savoir plus, consultez DeliveryVehicle.current_route_segment. Ce champ est renvoyé dans Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) pour tous les Task actifs attribués au véhicule de livraison.

Fleet Engine ignore ce champ dans UpdateDeliveryVehicleRequest si le champ current_route_segment est vide.
remaining_duration

Duration

Temps de conduite restant pour current_route_segment. L'application Driver fournit généralement ce champ, mais dans certains cas, Fleet Engine remplace la valeur envoyée par l'application. Pour en savoir plus, consultez DeliveryVehicle.current_route_segment. Ce champ est renvoyé dans Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST) pour toutes les tâches actives attribuées au véhicule de livraison.

Fleet Engine ignore ce champ dans UpdateDeliveryVehicleRequest si le champ current_route_segment est vide.
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Segments du trajet attribués à ce véhicule de livraison, en commençant par la dernière position signalée du véhicule. Ce champ ne sera pas renseigné dans la réponse de ListDeliveryVehicles.
attributes[]

DeliveryVehicleAttribute

Liste des attributs personnalisés du véhicule de livraison. Un véhicule de livraison peut comporter au maximum 100 attributs, et chacun d'eux doit avoir une clé unique.
type

DeliveryVehicleType

Type de véhicule de livraison. Si cette valeur n'est pas définie, la valeur par défaut est AUTO.

DeliveryVehicleType

Type de véhicule de livraison.

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Cette valeur n'est pas utilisée.
AUTO Une automobile.
TWO_WHEELER Une moto, une mobylette ou tout autre véhicule à deux roues
BICYCLE Transport à propulsion humaine.
PEDESTRIAN Un transporteur humain, généralement à pied ou en courant, se déplaçant sur des chemins piétonniers.

DeliveryVehicleAttribute

Décrit un attribut de véhicule sous forme de paire clé/valeur. La longueur de la chaîne "clé:valeur" ne peut pas dépasser 256 caractères.

Champs
key

string

Clé de l'attribut.
value

string

Valeur de l'attribut.
Champ d'union delivery_vehicle_attribute_value. La valeur de l'attribut peut être de type chaîne, booléen ou double. delivery_vehicle_attribute_value ne peut être qu'un des éléments suivants :
string_value

string

Valeur d'attribut de type chaîne.

Remarque : Ce champ est identique au champ value, qui sera à terme obsolète. Pour les méthodes de création ou de mise à jour, vous pouvez utiliser l'un ou l'autre champ, mais il est vivement recommandé d'utiliser string_value. Si string_value et value sont tous les deux définis, ils doivent être identiques, sinon une erreur sera générée. Les deux champs sont renseignés dans les réponses.
bool_value

bool

Valeur d'attribut de type booléen.
number_value

double

Valeur d'attribut de type double.

DeliveryVehicleLocation

Emplacement, vitesse et direction d'un véhicule à un moment donné.

Champs
location

LatLng

Emplacement du véhicule. Lorsqu'elle est envoyée à Fleet Engine, la position du véhicule est une position GPS. Lorsque vous recevez la position du véhicule dans une réponse, il peut s'agir d'une position GPS, d'une position supplémentaire ou d'une autre position estimée. La source est spécifiée dans location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Obsolète : utilisez plutôt latlng_accuracy.
latlng_accuracy

DoubleValue

Précision de location en mètres sous forme de rayon.
heading

Int32Value

Direction dans laquelle le véhicule se déplace, en degrés. 0 représente le nord. La plage valide est [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Obsolète : utilisez plutôt heading_accuracy.
heading_accuracy

DoubleValue

Précision de heading en degrés.
altitude

DoubleValue

Altitude en mètres au-dessus de WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Obsolète : utilisez plutôt altitude_accuracy.
altitude_accuracy

DoubleValue

Précision de altitude en mètres.
speed_kmph
(deprecated)

Int32Value

Vitesse du véhicule en kilomètres par heure. Obsolète : utilisez plutôt speed.
speed

DoubleValue

Vitesse du véhicule en mètres/seconde
speed_accuracy

DoubleValue

Précision de speed en mètres/seconde.
update_time

Timestamp

Heure à laquelle location a été signalé par le capteur, selon l'horloge du capteur.
server_time

Timestamp

Uniquement en sortie. Heure à laquelle le serveur a reçu les informations de localisation.
location_sensor

DeliveryVehicleLocationSensor

Fournisseur de données de localisation (par exemple, GPS).
is_road_snapped

BoolValue

Indique si location est ancré à une route.
is_gps_sensor_enabled

BoolValue

Uniquement en entrée. Indique si le capteur GPS est activé sur l'appareil mobile.
time_since_update

Int32Value

Uniquement en entrée. Temps (en secondes) écoulé depuis que cet emplacement a été envoyé au serveur pour la première fois. Cette valeur sera nulle pour la première mise à jour. Si l'heure est inconnue (par exemple, lorsque l'application redémarre), cette valeur est réinitialisée sur zéro.
num_stale_updates
(deprecated)

Int32Value

Uniquement en entrée. Obsolète : d'autres signaux sont désormais utilisés pour déterminer si un emplacement est obsolète.
raw_location

LatLng

Position brute du véhicule (non traitée par Road-Snapper).
raw_location_time

Timestamp

Code temporel associé à la position brute.
raw_location_sensor

DeliveryVehicleLocationSensor

Source de l'emplacement brut. La valeur par défaut est GPS.
raw_location_accuracy

DoubleValue

Précision de raw_location en tant que rayon, en mètres.
flp_location

LatLng

Localisation fournie par l'API Fused Location Provider d'Android.
flp_update_time

Timestamp

Code temporel de mise à jour de flp_location
flp_latlng_accuracy_meters

DoubleValue

Précision de flp_location en mètres sous forme de rayon.
flp_heading_degrees

Int32Value

Direction dans laquelle le véhicule se déplace en degrés, telle que déterminée par le Fused Location Provider. 0 représente le nord. La plage valide est [0,360).
supplemental_location

LatLng

Emplacement supplémentaire fourni par l'application d'intégration.
supplemental_location_time

Timestamp

Code temporel associé au lieu supplémentaire.
supplemental_location_sensor

DeliveryVehicleLocationSensor

Source de l'emplacement supplémentaire. La valeur par défaut est CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy

DoubleValue

Précision de supplemental_location en tant que rayon, en mètres.
road_snapped
(deprecated)

bool

Obsolète : utilisez plutôt is_road_snapped.

DeliveryVehicleLocationSensor

Capteur ou méthodologie utilisés pour déterminer la position.

Enums
UNKNOWN_SENSOR Le capteur n'est pas spécifié ou est inconnu.
GPS GPS ou GPS assisté.
NETWORK GPS assisté, identifiant d'antenne-relais ou point d'accès Wi-Fi.
PASSIVE ID d'antenne-relais ou point d'accès Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Position de route la plus probable déterminée par l'appareil mobile.
CUSTOMER_SUPPLIED_LOCATION Emplacement fourni par un client à partir d'une source indépendante. En règle générale, cette valeur est utilisée pour un emplacement fourni par des sources autres que l'appareil mobile exécutant le Driver SDK. Si la source d'origine est décrite par l'une des autres valeurs d'énumération, utilisez cette valeur. Les emplacements marqués CUSTOMER_SUPPLIED_LOCATION sont généralement fournis via le last_location.supplemental_location_sensor d'un DeliveryVehicle.
FLEET_ENGINE_LOCATION Emplacement calculé par Fleet Engine en fonction des signaux dont il dispose. Uniquement en sortie. Cette valeur sera rejetée si elle est reçue dans une requête.
FUSED_LOCATION_PROVIDER Fused Location Provider d'Android.
CORE_LOCATION Fournisseur de localisation sur les systèmes d'exploitation Apple.

DeliveryVehicleNavigationStatus

État de la navigation du véhicule.

Enums
UNKNOWN_NAVIGATION_STATUS État de navigation non spécifié.
NO_GUIDANCE La navigation de l'application Driver est en mode FREE_NAV.
ENROUTE_TO_DESTINATION La navigation détaillée est disponible et la navigation de l'application Chauffeur est passée en mode GUIDED_NAV.
OFF_ROUTE Le véhicule a quitté l'itinéraire suggéré.
ARRIVED_AT_DESTINATION Le véhicule se trouve à environ 50 m de la destination.

GetDeliveryVehicleRequest

Message de requête GetDeliveryVehicle.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.

GetTaskRequest

Message de requête GetTask.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/tasks/{task}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.

GetTaskTrackingInfoRequest

Message de requête GetTaskTrackingInfoRequest.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/taskTrackingInfo/{tracking_id}. provider doit correspondre à l'ID du projet Google Cloud, et tracking_id à l'ID de suivi associé à la tâche. Par exemple, vous pouvez l'appeler providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Message de requête ListDeliveryVehicles.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
parent

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.
page_size

int32

Facultatif. Nombre maximal de véhicules à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si vous ne spécifiez pas ce nombre, le serveur détermine le nombre de résultats à renvoyer.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListDeliveryVehicles précédent. Vous devez le fournir pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListDeliveryVehicles doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

Facultatif. Requête de filtre à appliquer lors de la liste des véhicules de livraison. Pour obtenir des exemples de syntaxe de filtre, consultez http://aip.dev/160. Si vous ne spécifiez pas de valeur ou si vous spécifiez une chaîne vide pour le filtre, tous les véhicules de livraison sont renvoyés.

Notez que les seules requêtes acceptées pour ListDeliveryVehicles concernent les attributs du véhicule (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). De plus, tous les attributs sont stockés sous forme de chaînes. Par conséquent, les seules comparaisons acceptées pour les attributs sont les comparaisons de chaînes. Pour effectuer une comparaison avec des valeurs numériques ou booléennes, les valeurs doivent être explicitement mises entre guillemets pour être traitées comme des chaînes (par exemple, attributes.<key> = "10" ou attributes.<key> = "true").

Le nombre maximal de restrictions autorisées dans une requête de filtre est de 50. Une restriction est une partie de la requête de la forme attribute.<KEY> <COMPARATOR> <VALUE>. Par exemple, attributes.foo = bar est une restriction.
viewport

Viewport

Facultatif. Filtre qui limite les véhicules renvoyés à ceux dont la dernière position connue se trouvait dans la zone rectangulaire définie par la fenêtre d'affichage.

ListDeliveryVehiclesResponse

Message de réponse ListDeliveryVehicles.

Champs
delivery_vehicles[]

DeliveryVehicle

Ensemble de véhicules de livraison qui répondent aux critères de filtrage demandés. Si aucun filtre n'est spécifié, la requête renvoie tous les véhicules de livraison. Une réponse réussie peut également être vide. Une réponse vide indique qu'aucun véhicule de livraison ne correspond aux critères de filtrage demandés.
next_page_token

string

Vous pouvez transmettre ce jeton dans ListDeliveryVehiclesRequest pour continuer à lister les résultats. Lorsque tous les résultats sont renvoyés, ce champ n'est pas inclus dans la réponse ou est une chaîne vide.
total_size

int64

Nombre total de véhicules de livraison correspondant aux critères de la demande, sur toutes les pages.

ListTasksRequest

Message de requête ListTasks.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
parent

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. provider doit correspondre à l'ID du projet Google Cloud. Par exemple, sample-cloud-project.
page_size

int32

Facultatif. Nombre maximal de tâches à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si vous ne spécifiez pas cette valeur, le serveur détermine le nombre de résultats à renvoyer.
page_token

string

Facultatif. Jeton de page reçu d'un appel ListTasks précédent. Vous pouvez le fournir pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListTasks doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

Facultatif. Requête de filtre à appliquer lors de la liste des tâches. Pour obtenir des exemples de syntaxe de filtre, consultez http://aip.dev/160. Si vous ne spécifiez pas de valeur ou si vous filtrez sur une chaîne vide, toutes les tâches sont renvoyées. Pour en savoir plus sur les propriétés de tâches sur lesquelles vous pouvez appliquer des filtres, consultez Lister les tâches.

ListTasksResponse

La réponse ListTasks contenant l'ensemble des tâches qui répondent aux critères de filtre dans ListTasksRequest.

Champs
tasks[]

Task

Ensemble de tâches qui répondent aux critères de filtrage demandés. Si aucun filtre n'est spécifié, la requête renvoie toutes les tâches. Une réponse réussie peut également être vide. Une réponse vide indique qu'aucune tâche ne correspond aux critères de filtrage demandés.
next_page_token

string

Transmettez ce jeton dans ListTasksRequest pour continuer à lister les résultats. Si tous les résultats ont été renvoyés, ce champ est une chaîne vide ou n'apparaît pas dans la réponse.
total_size

int64

Nombre total de tâches correspondant aux critères de la requête, sur toutes les pages.

LocationInfo

Emplacement avec des identifiants supplémentaires.

Champs
point

LatLng

Coordonnées du lieu. Vous devez spécifier point ou place comme entrée. Si les deux sont spécifiés, point sera utilisé pour le routage et place pour les métadonnées. Si seule place est spécifiée en entrée, point sera calculée à partir de place et incluse dans la sortie.
place

string

Nom de ressource du lieu représentant cet emplacement. Il a le format suivant : places/{place_id}. Vous devez spécifier point ou place comme entrée. Si les deux sont spécifiés, point sera utilisé pour le routage et place pour les métadonnées. place n'est inclus dans le résultat que s'il l'était dans l'entrée, ce qui signifie qu'aucune recherche place n'est effectuée à partir de LatLng.

Cette fonctionnalité est expérimentale.
point_location_source

PointSource

Uniquement en sortie. Source du champ latlng point. Cela fait partie d'une fonctionnalité expérimentale.

PointSource

Indique la source d'un LatLng.

Enums
POINT_SOURCE_UNSPECIFIED Source ponctuelle non spécifiée.
POINT_SOURCE_DEVELOPER_PROVIDED Le LatLng a été explicitement fourni par le développeur.
POINT_SOURCE_CALCULATED_FROM_PLACE Le LatLng a été calculé à partir du lieu fourni.

Tâche

Dans l'API Delivery, une tâche représente une action unique à suivre. En général, il existe une distinction entre les tâches liées aux expéditions et les tâches de pause. Une expédition peut être associée à plusieurs tâches. Par exemple, il peut y avoir une tâche pour la prise en charge et une autre pour la dépose ou le transfert. De plus, différentes tâches pour un même envoi peuvent être traitées par différents véhicules. Par exemple, un véhicule peut prendre en charge la collecte et transporter le colis jusqu'au hub, tandis qu'un autre véhicule transporte le même colis du hub au lieu de dépôt.

Remarque : Les API gRPC et REST utilisent des conventions de dénomination de champs différentes. Par exemple, le champ Task.journey_sharing_info de l'API gRPC et le champ Task.journeySharingInfo de l'API REST font référence au même champ.

Champs
name

string

Doit se présenter sous la forme providers/{provider}/tasks/{task}.
type

Type

Obligatoire. Immuable. Définit le type de tâche. (par exemple, une pause ou une expédition).
state

State

Obligatoire. État actuel de l'exécution de la tâche.
task_outcome

TaskOutcome

Résultat de la tâche.
task_outcome_time

Timestamp

Code temporel indiquant quand le fournisseur a défini le résultat de Task.
task_outcome_location

LocationInfo

Emplacement où le résultat de Task a été défini. Cette valeur est mise à jour dans UpdateTask. Si cette valeur n'est pas explicitement mise à jour par le fournisseur, Fleet Engine la renseigne par défaut avec la dernière position connue du véhicule (la position brute).
task_outcome_location_source

TaskOutcomeLocationSource

Indique l'origine de la valeur de task_outcome_location.
tracking_id

string

Immuable. Ce champ facilite le stockage d'un ID afin d'éviter d'utiliser un mappage complexe. Vous ne pouvez pas définir tracking_id pour les tâches de type UNAVAILABLE et SCHEDULED_STOP. Ces identifiants sont soumis aux restrictions suivantes :

  • Doit être une chaîne Unicode valide.
  • La longueur maximale est de 64 caractères.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ni "#".
delivery_vehicle_id

string

Uniquement en sortie. ID du véhicule qui exécute cette tâche. Les ID de véhicules de livraison sont soumis aux restrictions suivantes :

  • Doit être une chaîne Unicode valide.
  • La longueur maximale est de 64 caractères.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ni "#".
planned_location

LocationInfo

Immuable. Lieu où la tâche sera effectuée. Facultatif pour les tâches UNAVAILABLE, mais obligatoire pour toutes les autres tâches.
task_duration

Duration

Obligatoire. Immuable. Temps nécessaire pour exécuter une tâche à cet emplacement.
target_time_window

TimeWindow

Période pendant laquelle la tâche doit être effectuée.
journey_sharing_info

JourneySharingInfo

Uniquement en sortie. Champs spécifiques au partage de trajet. Non renseigné lorsque l'état est CLOSED.
task_tracking_view_config

TaskTrackingViewConfig

Configuration du suivi des tâches qui spécifie les éléments de données visibles par les utilisateurs finaux et les circonstances dans lesquelles ils le sont.
attributes[]

TaskAttribute

Liste des attributs de tâche personnalisés. Chaque attribut doit avoir une clé unique.

JourneySharingInfo

Champs spécifiques au partage de trajet.

Champs
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Informations de suivi des arrêts que le véhicule attribué effectuera avant de terminer cette tâche. Notez que cette liste peut contenir des arrêts provenant d'autres tâches.

Le premier segment, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), contient des informations sur l'itinéraire depuis la dernière position connue du conducteur jusqu'au VehicleStop à venir. Les informations sur l'itinéraire actuel proviennent généralement de l'application du chauffeur, à l'exception de certains cas mentionnés dans la documentation de DeliveryVehicle.current_route_segment. Les autres segments de Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments (REST) sont renseignés par Fleet Engine. Elles fournissent des informations sur l'itinéraire entre les VehicleStops restants.
last_location

DeliveryVehicleLocation

Indique la dernière position signalée du véhicule attribué.
last_location_snappable

bool

Indique si la dernière position du véhicule peut être ancrée à current_route_segment. Cette valeur est "False" si last_location ou current_route_segment n'existent pas. Cette valeur est calculée par Fleet Engine. Les modifications apportées par les clients sont ignorées.

État

État d'une tâche. Indique la progression de la tâche.

Enums
STATE_UNSPECIFIED Par défaut. Utilisé pour un état de tâche non spécifié ou non reconnu.
OPEN Soit la tâche n'a pas encore été attribuée à un véhicule de livraison, soit le véhicule de livraison n'est pas encore passé par l'arrêt qui lui a été attribué (Task).
CLOSED Lorsque le véhicule dépasse l'arrêt pour cette tâche.

TaskOutcome

Résultat de la tentative d'exécution d'une tâche. Lorsque TaskState est fermé, TaskOutcome indique s'il a été exécuté correctement.

Enums
TASK_OUTCOME_UNSPECIFIED Résultat de la tâche avant que sa valeur ne soit définie.
SUCCEEDED La tâche a été exécutée.
FAILED La tâche n'a pas pu être effectuée ou a été annulée.

TaskOutcomeLocationSource

Identité de la source qui a rempli task_outcome_location.

Enums
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Résultat de la tâche avant sa définition.
PROVIDER Le fournisseur a spécifié task_outcome_location.
LAST_VEHICLE_LOCATION Le fournisseur n'a pas spécifié de task_outcome_location. Fleet Engine a donc utilisé la dernière position connue du véhicule.

Type

Type de tâche.

Enums
TYPE_UNSPECIFIED Par défaut, le type de tâche est inconnu.
PICKUP Une tâche de retrait correspond à l'action de récupérer un colis auprès d'un client. Les collectes de véhicules de dépôt ou de véhicules de liaison doivent utiliser le type SCHEDULED_STOP.
DELIVERY Une tâche de livraison est l'action effectuée pour livrer un colis à un client final. Les dépôts ou les véhicules de collecte doivent utiliser le type SCHEDULED_STOP.
SCHEDULED_STOP Une tâche d'arrêt planifié est utilisée à des fins de planification. Par exemple, il peut s'agir de l'enlèvement ou de la dépose d'envois à partir de véhicules ou d'entrepôts de collecte. Elle ne doit pas être utilisée pour les colis récupérés ou déposés par un client final.
UNAVAILABLE Tâche indiquant que le véhicule n'est pas disponible pour l'entretien. Par exemple, cela peut se produire lorsque le conducteur fait une pause ou lorsque le véhicule est ravitaillé en carburant.

TaskAttribute

Décrit un attribut de tâche sous forme de paire clé/valeur. La longueur de la chaîne "clé:valeur" ne peut pas dépasser 256 caractères.

Champs
key

string

Clé de l'attribut. Les clés ne peuvent pas contenir le caractère deux-points (:).
Champ d'union task_attribute_value. La valeur de l'attribut peut être de type chaîne, booléen ou double. Si aucune n'est définie, la valeur string_value de TaskAttribute sera stockée sous forme de chaîne vide "". task_attribute_value ne peut être que l'une des valeurs suivantes :
string_value

string

Valeur d'attribut de type chaîne.
bool_value

bool

Valeur d'attribut de type booléen.
number_value

double

Valeur d'attribut de type double.

TaskTrackingInfo

Le message TaskTrackingInfo. Le message contient des informations de suivi des tâches qui seront utilisées pour l'affichage. Si un ID de suivi est associé à plusieurs tâches, Fleet Engine utilise une heuristique pour déterminer les TaskTrackingInfo à sélectionner.

Champs
name

string

Doit être au format providers/{provider}/taskTrackingInfo/{tracking}, où tracking représente l'ID de suivi.
tracking_id

string

Immuable. ID de suivi d'une tâche. * Doit être une chaîne Unicode valide. * La longueur maximale est de 64 caractères. * Normalisé selon la forme de normalisation Unicode C. * Ne doit contenir aucun des caractères ASCII suivants : "/", ":", "?", "," ou "#".
vehicle_location

DeliveryVehicleLocation

Dernière position du véhicule.
route_polyline_points[]

LatLng

Liste de points qui, une fois connectés, forment une polyligne de l'itinéraire prévu du véhicule jusqu'au lieu de cette tâche.
remaining_stop_count

Int32Value

Indique le nombre d'arrêts restants du véhicule jusqu'à ce qu'il atteigne l'arrêt de la tâche, y compris l'arrêt de la tâche. Par exemple, si le prochain arrêt du véhicule est l'arrêt de la tâche, la valeur sera 1.
remaining_driving_distance_meters

Int32Value

Distance totale restante en mètres jusqu'au VehicleStop d'intérêt.
estimated_arrival_time

Timestamp

Code temporel indiquant l'heure d'arrivée estimée à l'arrêt.
estimated_task_completion_time

Timestamp

Code temporel indiquant l'heure de fin estimée d'une tâche.
state

State

État actuel de l'exécution de la tâche.
task_outcome

TaskOutcome

Résultat de la tentative d'exécution d'une tâche.
task_outcome_time

Timestamp

Code temporel indiquant quand le fournisseur a défini le résultat de la tâche.
planned_location

LocationInfo

Immuable. Lieu où la tâche sera effectuée.
target_time_window

TimeWindow

Période pendant laquelle la tâche doit être effectuée.
attributes[]

TaskAttribute

Attributs personnalisés définis pour la tâche.

TaskTrackingViewConfig

Message de configuration qui définit quand un élément de données d'une tâche doit être visible par les utilisateurs finaux.

Champs
route_polyline_points_visibility

VisibilityOption

Champ qui spécifie quand les points de la polyligne de l'itinéraire peuvent être visibles. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.
estimated_arrival_time_visibility

VisibilityOption

Champ qui indique quand l'heure d'arrivée estimée peut être visible. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.
estimated_task_completion_time_visibility

VisibilityOption

Champ qui indique quand le temps d'exécution estimé d'une tâche peut être visible. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.
remaining_driving_distance_visibility

VisibilityOption

Champ qui indique quand la distance de conduite restante peut être visible. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.
remaining_stop_count_visibility

VisibilityOption

Champ qui indique quand le nombre d'arrêts restants peut être visible. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.
vehicle_location_visibility

VisibilityOption

Champ qui indique quand la position du véhicule peut être visible. Si ce champ n'est pas spécifié, la configuration de visibilité par défaut au niveau du projet pour ces données sera utilisée.

VisibilityOption

Message d'option qui définit quand un élément de données doit être visible par les utilisateurs finaux.

Champs
Champ d'union visibility_option. Option de visibilité spécifique choisie. visibility_option ne peut être qu'un des éléments suivants :
remaining_stop_count_threshold

int32

Cet élément de données est visible par les utilisateurs finaux si le nombre d'arrêts restants est inférieur ou égal à remaining_stop_count_threshold.
duration_until_estimated_arrival_time_threshold

Duration

Cet élément de données est visible par les utilisateurs finaux si l'heure d'arrivée estimée à l'arrêt est inférieure ou égale à duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold

int32

Cet élément de données est visible par les utilisateurs finaux si la distance de conduite restante en mètres est inférieure ou égale à remaining_driving_distance_meters_threshold.
always

bool

Si la valeur est définie sur "true", cet élément de données est toujours visible par les utilisateurs finaux, sans seuil. Ce champ ne peut pas être défini sur "false".
never

bool

Si la valeur est définie sur "true", cet élément de données est toujours masqué pour les utilisateurs finaux, sans seuil. Ce champ ne peut pas être défini sur "false".

TimeWindow

Une période.

Champs
start_time

Timestamp

Obligatoire. Heure de début de la période (incluse).
end_time

Timestamp

Obligatoire. Heure de fin de la période (incluse).

UpdateDeliveryVehicleRequest

Message de requête UpdateDeliveryVehicle.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
delivery_vehicle

DeliveryVehicle

Obligatoire. Mise à jour de l'entité DeliveryVehicle à appliquer. Remarque : Vous ne pouvez pas modifier le nom de DeliveryVehicle.
update_mask

FieldMask

Obligatoire. Masque de champ indiquant les champs DeliveryVehicle à mettre à jour. Notez que le masque de mise à jour doit contenir au moins un champ.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "remaining_vehicle_journey_segments".

UpdateTaskRequest

Message de requête UpdateTask.

Champs
header

DeliveryRequestHeader

Facultatif. En-tête de requête standard de l'API Delivery.
task

Task

Obligatoire. Tâche associée à la mise à jour. Les champs suivants sont gérés par Fleet Engine. Ne les mettez pas à jour à l'aide de Task.update.

  • last_location.
  • last_location_snappable
  • name
  • remaining_vehicle_journey_segments
  • task_outcome_location_source.

Remarque : Une fois que vous avez défini la valeur de task_outcome, vous ne pouvez plus la modifier.

Si la tâche a été attribuée à un véhicule de livraison, ne définissez pas son état sur CLOSED à l'aide de Task.update. Supprimez plutôt le VehicleStop contenant la tâche du véhicule de livraison, ce qui définit automatiquement l'état de la tâche sur "TERMINÉE".
update_mask

FieldMask

Obligatoire. Masque de champ indiquant les champs de la tâche à mettre à jour. Remarque : L'élément update_mask doit contenir au moins un champ.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Représente le segment de trajet d'un véhicule, de son arrêt précédent à l'arrêt actuel. S'il s'agit du premier arrêt actif, le trajet part de la position actuelle du véhicule et se termine à cet arrêt.

Champs
stop

VehicleStop

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

Int32Value

Uniquement en sortie. Distance parcourue entre l'arrêt précédent et celui-ci. Si l'arrêt actuel est le premier de la liste des segments de 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.
driving_duration

Duration

Uniquement en sortie. Temps de trajet entre l'arrêt précédent et celui-ci. Si l'arrêt actuel est le premier de la liste des segments de 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.

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 chauffeur, et non le temps de trajet depuis l'arrêt précédent.
path[]

LatLng

Uniquement en sortie. Chemin de l'arrêt précédent à cet arrêt. Si l'arrêt actuel est le premier de la liste des segments du trajet, il s'agit du chemin allant de la position actuelle du véhicule à cet arrêt au moment où il a été ajouté à la liste. Ce champ peut ne pas être présent si ce segment de trajet 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és à partir de DeliveryVehicle.current_route_segment (gRPC) ou DeliveryVehicle.currentRouteSegment (REST). L'itinéraire est alors calculé à partir de la dernière position connue de l'application chauffeur, et non à partir de l'arrêt précédent.

VehicleStop

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

Champs
planned_location

LocationInfo

Obligatoire. Emplacement de l'arrêt. Notez que les lieux indiqués dans les Task ne correspondent pas forcément à cet emplacement, mais se trouvent à proximité. Ce champ ne sera pas renseigné dans la réponse d'un appel GetTask.
tasks[]

TaskInfo

Liste des Task à effectuer à cet arrêt. Ce champ ne sera pas renseigné dans la réponse d'un appel GetTask.
state

State

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

État

État actuel d'un VehicleStop.

Enums
STATE_UNSPECIFIED Inconnu.
NEW Créé, mais pas en cours de routage actif.
ENROUTE Attribué et en cours de routage.
ARRIVED Arrivé à l'arrêt. Suppose que lorsque le véhicule est en route vers le prochain arrêt, tous les arrêts précédents ont été effectués.

TaskInfo

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

Champs
task_id

string

ID de la tâche. Ce champ ne sera pas renseigné dans la réponse d'un appel GetTask. Les ID de tâches sont soumis aux restrictions suivantes :

  • Doit être une chaîne Unicode valide.
  • La longueur maximale est de 64 caractères.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ni "#".
task_duration

Duration

Uniquement en sortie. Le temps nécessaire pour effectuer la tâche.
target_time_window

TimeWindow

Uniquement en sortie. Période pendant laquelle la tâche doit être effectuée. Cette valeur n'est définie que dans la réponse à GetDeliveryVehicle.