Package maps.fleetengine.v1

BatteryStatus

État de la batterie (pleine ou en charge, etc.)

PowerSource

État de la source d'alimentation de la batterie.

float

Pourcentage actuel de la batterie [0-100].

SpeedReadingInterval

Vitesse de circulation sur le trajet entre le point de cheminement précédent et le point de cheminement actuel.

string

Trajet emprunté par le conducteur entre le point de cheminement précédent et le point de cheminement actuel. Ce trajet contient des points de repère permettant aux clients d'afficher des repères de signalisation le long du trajet (voir speed_reading_interval). Le décodage n'est pas encore disponible.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

string

Obligatoire. ID de trajet unique. Sous réserve des 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 "#".

Trip

Obligatoire. Entité de voyage à créer.

Lorsque vous créez un trajet, les champs suivants sont obligatoires :

• trip_type
• pickup_point

Si vous les renseignez, les champs suivants sont utilisés:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Tous les autres champs "Trip" sont ignorés. Par exemple, tous les trajets commencent par un trip_status de NEW, même si vous transmettez un trip_status de CANCELED dans la requête de création.

Seuls les trajets EXCLUSIVE sont compatibles avec intermediate_destinations.

Lorsque vehicle_id est défini pour un trajet partagé, vous devez fournir la liste des Trip.vehicle_waypoints pour spécifier l'ordre des points de cheminement restants pour le véhicule. Sinon, l'ordre des points de cheminement sera indéterminé.

Lorsque vous spécifiez Trip.vehicle_waypoints, la liste doit contenir tous les points de cheminement restants des trajets du véhicule, sans points de cheminement supplémentaires. Vous devez classer ces points de cheminement de sorte que, pour un trajet donné, le point de prise en charge se trouve avant les destinations intermédiaires, et toutes les destinations intermédiaires avant le point de dépose. Les points de cheminement d'un trajet EXCLUSIVE ne doivent pas entrelacer les autres trajets.

Les champs trip_id, waypoint_type et location sont utilisés, et tous les autres champs TripWaypoint de vehicle_waypoints sont ignorés.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

string

Obligatoire. ID de véhicule unique. Sous réserve des 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 "#".

Vehicle

Obligatoire. Entité de véhicule à créer. Lorsque vous créez un véhicule, les champs suivants sont obligatoires :

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Lors de la création d'un véhicule, les champs suivants sont ignorés:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Tous les autres champs sont facultatifs et utilisés s'ils sont renseignés.

LocationPowerSaveMode

Mode de fonctionnement des fonctionnalités de localisation sur l'appareil lorsque l'économiseur de batterie est activé.

bool

Indique si l'appareil est actuellement en mode Économie d'énergie.

bool

Indique si l'appareil est en mode interactif.

BatteryInfo

Informations sur l'état de la batterie.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/trips/{trip}. Le fournisseur doit être l'ID de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

TripView

Sous-ensemble des champs "Trip" (Voyage) à renvoyer et leur interprétation.

Timestamp

Indique le code temporel minimal (exclusif) pour lequel les données Trip.route ou Trip.current_route_segment sont récupérées. Si les données de l'itinéraire ne sont pas modifiées depuis cet horodatage, le champ d'itinéraire n'est pas défini dans la réponse. Si une valeur minimale n'est pas spécifiée, les données de route sont toujours récupérées.

Timestamp

Indique le code temporel minimal (exclusif) pour lequel les Trip.remaining_waypoints sont récupérés. Si elles n'ont pas changé depuis ce code temporel, les remaining_waypoints ne sont pas définies dans la réponse. Si ce champ n'est pas spécifié, remaining_waypoints est toujours récupéré.

PolylineFormatType

Format d'itinéraire actuel renvoyé : LAT_LNG_LIST_TYPE (dans Trip.route) ou ENCODED_POLYLINE_TYPE (dans Trip.current_route_segment). La valeur par défaut est LAT_LNG_LIST_TYPE.

Timestamp

Indique le code temporel minimal (exclu) pour lequel la valeur Trip.current_route_segment_traffic est récupérée. Si les données de trafic ne sont pas modifiées depuis cet horodatage, le champ current_route_segment_traffic n'est pas défini dans la réponse. Si aucun nombre minimal n'est spécifié, les données sur le trafic sont toujours récupérées. Notez que le trafic n'est disponible que pour les clients de la solution On-Demand Rides and Deliveries.

Timestamp

Indique le code temporel minimal (exclusif) pour lequel les données Trip.remaining_waypoints.traffic_to_waypoint et Trip.remaining_waypoints.path_to_waypoint sont récupérées. Si les données n'ont pas changé depuis ce code temporel, les champs ci-dessus ne sont pas définis dans la réponse. Si remaining_waypoints_route_version n'est pas spécifié, le trafic et le chemin sont toujours récupérés.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/vehicles/{vehicle}. Le fournisseur doit être l'ID de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

Timestamp

Indique le code temporel minimal (exclusif) pour lequel Vehicle.current_route_segment est récupéré. Si l'itinéraire n'a pas changé depuis ce code temporel, le champ current_route_segment n'est pas défini dans la réponse. Si une valeur minimale n'est pas spécifiée, la valeur current_route_segment est toujours récupérée.

Timestamp

Indique l'horodatage minimal (exclusif) pour lequel les données Vehicle.waypoints sont récupérées. Si les points de cheminement ne sont pas modifiés depuis cet horodatage, les données vehicle.waypoints ne sont pas définies dans la réponse. Si ce champ n'est pas spécifié, vehicle.waypoints est toujours récupéré.

string

Obligatoire. Code pays/région CLDR. Par exemple, US pour les États-Unis ou IN pour l'Inde.

string

Elle contient le dernier chiffre de la plaque d'immatriculation ou "-1" (pour indiquer qu'il n'y a pas de valeur numérique).

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

int32

Nombre maximal de véhicules à renvoyer. La valeur par défaut est 100.

string

Valeur de l'next_page_token fournie par un appel précédent à ListVehicles afin de pouvoir paginer des groupes de véhicules. La valeur n'est pas définie si les critères de filtrage de la demande ne sont pas identiques à ceux de l'appel précédent à ListVehicles.

Int32Value

Spécifie la capacité minimale requise du véhicule. Tous les véhicules renvoyés auront un maximum_capacity supérieur ou égal à cette valeur. Si défini, doit être supérieur ou égal à 0.

TripType

Limite la réponse aux véhicules compatibles avec au moins l'un des types de trajets spécifiés.

Duration

Limite la réponse aux véhicules qui ont envoyé des mises à jour de position à Fleet Engine au cours de la durée spécifiée. Les véhicules à l'arrêt qui continuent de transmettre leur position ne sont pas considérés comme obsolètes. Si présent, doit être une durée positive valide.

Category

Obligatoire. Limite la réponse aux véhicules appartenant à l'une des catégories de types spécifiées. UNKNOWN : non autorisé.

string

Les appelants peuvent former des opérations logiques complexes à l'aide de n'importe quelle combinaison des champs required_attributes, required_one_of_attributes et required_one_of_attribute_sets.

required_attributes est une liste. required_one_of_attributes utilise un message qui autorise une liste de listes. Ensemble, les deux champs permettent de composer cette expression :

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Limite la réponse aux véhicules présentant les attributs spécifiés. Ce champ est une opération de conjonction/opération AND. Un maximum de 50 attributs obligatoires est autorisé. Ce nombre correspond au nombre maximal d'attributs autorisé pour un véhicule. Chaque chaîne répétée doit être au format "clé:valeur".

string

Limite la réponse aux véhicules présentant au moins l'un des attributs spécifiés dans chaque VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à au moins un des attributs. Ce champ est une opération de disjonction/OU inclusive dans chaque VehicleAttributeList et une opération de conjonction/ET sur la collection de VehicleAttributeList. Chaque chaîne répétée doit être au format "clé1:valeur1|clé2:valeur2|clé3:valeur3".

string

required_one_of_attribute_sets fournit des fonctionnalités supplémentaires.

Comme pour required_one_of_attributes, required_one_of_attribute_sets utilise un message qui autorise une liste de listes, ce qui permet d'utiliser des expressions comme celle-ci:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Limite la réponse aux véhicules qui correspondent à tous les attributs d'un VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à tous les attributs. Ce champ est une opération de conjonction/AND dans chaque VehicleAttributeList et une opération de disjonction/OR inclusive dans l'ensemble des VehicleAttributeList. Chaque chaîne répétée doit être au format "clé1:valeur1|clé2:valeur2|clé3:valeur3".

VehicleState

Limite la réponse aux véhicules dont l'état est défini.

bool

Ne renvoyez que les véhicules avec le ou les trajets actuels.

string

Facultatif. Requête de filtre à appliquer lors de la liste des véhicules. Pour obtenir des exemples de syntaxe de filtre, consultez http://aip.dev/160.

Ce champ est conçu pour remplacer les champs required_attributes, required_one_of_attributes et required_one_of_attributes_sets. Si une valeur non vide est spécifiée ici, les champs suivants doivent être vides : required_attributes, required_one_of_attributes et required_one_of_attributes_sets.

Ce filtre fonctionne comme une clause ET avec d'autres contraintes, telles que vehicle_state ou on_trip_only.

Notez que les seules requêtes acceptées concernent les attributs du véhicule (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Le nombre maximal de restrictions autorisé dans une requête de filtre est de 50.

De plus, tous les attributs sont stockés sous forme de chaînes. Par conséquent, les seules comparaisons acceptées par rapport aux attributs sont les comparaisons de chaînes. Pour effectuer une comparaison avec des valeurs numériques ou booléennes, les valeurs doivent être explicitement placées entre guillemets pour être traitées comme des chaînes (par exemple, attributes.<key> = "10" ou attributes.<key> = "true").

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.

Vehicle

Véhicules correspondant aux critères de la demande. Le nombre maximal de véhicules renvoyés est déterminé par le champ page_size de la requête.

string

Jeton permettant de récupérer la page de véhicules suivante ou vide si aucun autre véhicule ne correspond aux critères de la demande.

int64

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

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/billableTrips/{billable_trip}. Le fournisseur doit être l'ID de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

string

Obligatoire. Code pays à deux lettres correspondant au pays du voyage. Le prix est défini en fonction du code pays.

BillingPlatformIdentifier

Plate-forme sur laquelle la requête a été émise.

string

Identifiants directement liés au trajet signalé. Il s'agit généralement d'ID (par exemple, des ID de session) d'opérations de préréservation effectuées avant que l'ID du trajet ne soit disponible. Le nombre de related_ids est limité à 50.

SolutionType

Type de solution produit GMP (par exemple, ON_DEMAND_RIDESHARING_AND_DELIVERIES) utilisé pour le trajet signalé.

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 aucun nom n'est spécifié, la réponse peut être rédigée dans n'importe quelle langue, la langue de préférence étant l'anglais, le cas échéant. Exemple de valeur de champ: en-US.

string

Obligatoire. Code CLDR de la région d'où provient la requête. Exemple de valeur de champ: US.

string

Version du SDK appelant, le cas échéant. La version est au format "major.minor.patch". Exemple: 1.1.2.

string

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

string

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

SdkType

Type de SDK qui envoie la requête.

string

Version du MapSDK dont dépend le SDK appelant, le cas échéant. La version est au format "major.minor.patch". Exemple: 5.2.1.

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

Plate-forme du SDK appelant.

string

Fabricant de l'appareil Android à partir du SDK appelant, uniquement applicable aux SDK Android. Exemple de valeur de champ: Samsung.

int32

Niveau d'API Android du SDK appelant, uniquement applicable aux SDK Android. Exemple de valeur de champ : 23.

string

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

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

string

Véhicule associé aux trajets de la requête. Si ce paramètre n'est pas spécifié, les trajets renvoyés ne contiennent pas les éléments suivants :

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Si elle est définie sur "true", la réponse inclut les trajets qui influent sur l'itinéraire d'un conducteur.

int32

Si ce paramètre n'est pas défini, le serveur décide du nombre de résultats à renvoyer.

string

Définissez cette valeur sur une valeur précédemment renvoyée dans SearchTripsResponse pour continuer à partir des résultats précédents.

Duration

Si une valeur est spécifiée, renvoie les trajets qui n'ont pas été mis à jour après l'heure (current - minimum_staleness).

Trip

Liste des trajets pour le véhicule demandé.

string

Transmettez ce jeton dans SearchTripsRequest pour parcourir les résultats de la liste. L'API renvoie une liste de trajets à chaque appel. Lorsque plus aucun résultat n'est disponible, la liste est vide.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

TerminalLocation

Obligatoire. Lieu de prise en charge à proximité duquel la recherche doit être effectuée.

TerminalLocation

Lieu de dépôt prévu par le client. Ce champ est obligatoire si trip_types contient TripType.SHARED.

int32

Obligatoire. Définit le rayon de recherche de véhicules autour du point de prise en charge. Seuls les véhicules situés dans le rayon de recherche seront affichés. La valeur doit être comprise entre 400 et 10 000 mètres (inclus).

int32

Obligatoire. Spécifie le nombre maximal de véhicules à renvoyer. La valeur doit être comprise entre 1 et 50 (inclus).

int32

Obligatoire. Spécifie le nombre de passagers envisagés pour un trajet. La valeur doit être supérieure ou égale à un. Le pilote n'est pas pris en compte dans la valeur de la capacité.

TripType

Obligatoire. Indique le type de trajet proposé. Doit inclure exactement un type. UNKNOWN_TRIP_TYPE : non autorisé. Limite la recherche aux véhicules compatibles avec ce type de trajet.

Duration

Limite la recherche aux véhicules qui ont envoyé des informations de localisation à Fleet Engine au cours de la durée spécifiée. Les véhicules à l'arrêt qui continuent de transmettre leur position ne sont pas considérés comme obsolètes. Si ce champ n'est pas défini, le serveur utilise cinq minutes comme valeur par défaut.

VehicleType

Obligatoire. Limite la recherche aux véhicules de l'un des types spécifiés. Vous devez indiquer au moins un type de véhicule. Les VehicleTypes d'une catégorie de UNKNOWN ne sont pas autorisés.

VehicleAttribute

Les appelants peuvent former des opérations logiques complexes en utilisant n'importe quelle combinaison des champs required_attributes, required_one_of_attributes et required_one_of_attribute_sets.

required_attributes est une liste. required_one_of_attributes utilise un message qui permet une liste de listes. Ensemble, les deux champs permettent de composer cette expression :

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Limite la recherche aux véhicules présentant les attributs spécifiés. Ce champ correspond à une opération de conjonction/AND. Un maximum de 50 attributs obligatoires est autorisé. Il correspond au nombre maximal d'attributs autorisés pour un véhicule.

VehicleAttributeList

Limite la recherche aux véhicules présentant au moins l'un des attributs spécifiés dans chaque VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à au moins un des attributs. Ce champ est une opération de disjonction/OR inclusive dans chaque VehicleAttributeList et une opération de conjonction/AND pour l'ensemble des VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets fournit des fonctionnalités supplémentaires.

Tout comme required_one_of_attributes, required_one_of_attribute_sets utilise un message qui permet une liste de listes, ce qui permet des expressions telles que celle-ci :

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Limite la recherche aux véhicules qui présentent tous les attributs d'un VehicleAttributeList. Dans chaque liste, un véhicule doit correspondre à tous les attributs. Ce champ est une opération de conjonction/ET dans chaque VehicleAttributeList et une opération de disjonction inclusive/OU dans la collection de VehicleAttributeList.

VehicleMatchOrder

Obligatoire. Spécifie le critère de tri souhaité pour les résultats.

bool

Indique si les véhicules avec un seul trajet actif sont éligibles pour cette recherche. Ce champ n'est utilisé que lorsque current_trips_present n'est pas spécifié. Lorsque current_trips_present n'est pas spécifié et que ce champ est défini sur false, les véhicules auxquels des trajets sont attribués sont exclus des résultats de recherche. Lorsque current_trips_present n'est pas spécifié et que ce champ est défini sur true, les résultats de recherche peuvent inclure les véhicules avec un trajet actif dont l'état est ENROUTE_TO_DROPOFF. Lorsque current_trips_present est spécifié, ce champ ne peut pas être défini sur "true".

La valeur par défaut est false.

string

Indique le trajet associé à ce SearchVehicleRequest.

CurrentTripsPresent

Indique si les véhicules avec des trajets actifs sont éligibles à cette recherche. Cette valeur doit être différente de CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type inclut SHARED.

string

Facultatif. Requête de filtre à appliquer lors de la recherche de véhicules. Consultez la page http://aip.dev/160 pour obtenir des exemples de syntaxe de filtre.

Ce champ est conçu pour remplacer les champs required_attributes, required_one_of_attributes et required_one_of_attributes_sets. Si une valeur non vide est spécifiée ici, les champs suivants doivent être vides : required_attributes, required_one_of_attributes et required_one_of_attributes_sets.

Ce filtre fonctionne comme une clause AND avec d'autres contraintes, telles que minimum_capacity ou vehicle_types.

Notez que les seules requêtes acceptées concernent les attributs du véhicule (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Le nombre maximal de restrictions autorisé dans une requête de filtre est de 50.

De plus, tous les attributs sont stockés sous forme de chaînes. Par conséquent, les seules comparaisons acceptées par rapport aux attributs sont les comparaisons de chaînes. Pour effectuer une comparaison avec des valeurs numériques ou booléennes, les valeurs doivent être explicitement placées entre guillemets pour être traitées comme des chaînes (par exemple, attributes.<key> = "10" ou attributes.<key> = "true").

VehicleMatch

Liste des véhicules correspondant aux critères SearchVehiclesRequest, triés en fonction du champ SearchVehiclesRequest.order_by.

int32

Index de début de cet intervalle dans le chemin d'accès. Au format JSON, lorsque l'index est égal à 0, le champ semble vide.

int32

Index de fin de cet intervalle dans le chemin. Dans le format JSON, lorsque l'index est égal à 0, le champ semble ne pas être renseigné.

Speed

Vitesse du trafic pour cet intervalle.

LatLng

Obligatoire. Indique l'emplacement réel.

Timestamp

Indique quand l'arrêt s'est produit.

Timestamp

Uniquement en entrée. Obsolète. Utilisez le champ d'horodatage.

LatLng

Obligatoire. Indique l'emplacement d'un point de cheminement de trajet.

TerminalPointId

Obsolète: spécifiez plutôt le champ point.

string

Obsolète: spécifiez plutôt le champ point.

string

Obsolète.

WaypointType

Obsolète : Vehicle.waypoint contiendra ces données.

string

Obsolète.

string

Obsolète.

string

Obsolète.

VisualTrafficReportPolylineRendering

Affichage d'une polyligne représentant la vitesse du trafic pour toutes les régions sur un tronçon du trajet d'un client.

string

Uniquement en sortie. Au format "providers/{provider}/trips/{trip}"

string

Identifiant du véhicule effectuant ce trajet.

TripStatus

État actuel du trajet.

TripType

Type de trajet.

TerminalLocation

Lieu où le client indique qu'il sera retiré.

StopLocation

Uniquement en entrée. Emplacement exact et heure de prise en charge du client Ce champ permet au fournisseur de fournir des commentaires sur les informations de prise en charge réelles.

StopLocation

Uniquement en entrée. L'heure et le lieu réels d'arrivée du chauffeur au lieu de prise en charge. Ce champ permet au fournisseur de fournir des informations sur l'arrivée réelle au point de prise en charge.

Timestamp

Uniquement en sortie. Soit l'heure de départ estimée du ou les passagers, soit l'heure réelle à laquelle ils ont été pris en charge.

TerminalLocation

Arrêts intermédiaires dans l'ordre indiqué dans la demande de trajet (en plus des points de départ et d'arrivée). Cette fonctionnalité ne sera pas disponible pour les trajets partagés dans un premier temps.

Timestamp

Indique la dernière fois que l'intermediate_destinations a été modifié. Votre serveur doit mettre en cache cette valeur et la transmettre dans UpdateTripRequest lors de la mise à jour de intermediate_destination_index pour s'assurer que intermediate_destinations n'est pas modifié.

int32

Lorsque TripStatus est défini sur ENROUTE_TO_INTERMEDIATE_DESTINATION, un nombre compris entre [0..N-1] indiquant la destination intermédiaire que le véhicule traverse ensuite. Lorsque TripStatus est ARRIVED_AT_INTERMEDIATE_DESTINATION, nombre compris entre [0..N-1] indiquant la destination intermédiaire du véhicule. Cette valeur est définie par le fournisseur. Si aucun intermediate_destinations n'est défini, ce champ est ignoré.

StopLocation

Uniquement en entrée. Heure et lieu réels d'arrivée du chauffeur à une destination intermédiaire. Ce champ permet au fournisseur de fournir des commentaires sur les informations d'arrivée réelles aux destinations intermédiaires.

StopLocation

Uniquement en entrée. L'heure et le lieu réels de prise en charge du client à une destination intermédiaire, ainsi que le lieu de prise en charge Ce champ permet au fournisseur de fournir des commentaires sur les informations de retrait réelles aux destinations intermédiaires.

TerminalLocation

Lieu où le client indique qu'il souhaite être déposé.

StopLocation

Uniquement en entrée. L'heure et le lieu réels de dépôt du client, ainsi que l'heure à laquelle il a été déposé. Ce champ permet au fournisseur de fournir des commentaires sur les informations de dépôt réelles.

Timestamp

Uniquement en sortie. Heure estimée à laquelle le ou les passagers seront déposés à la destination finale, ou heure réelle à laquelle ils ont été déposés.

TripWaypoint

Uniquement en sortie. Chemin complet (inclus) entre la position actuelle et le point de dépôt. Ce chemin peut inclure des points de cheminement d'autres trajets.

TripWaypoint

Ce champ permet de trier manuellement les points de cheminement pour le trajet. Il contient tous les points de cheminement restants pour le véhicule attribué, ainsi que les points de cheminement de prise en charge et de dépose de ce trajet. Si le trajet n'a pas été attribué à un véhicule, Fleet Engine ignore ce champ. Pour des raisons de confidentialité, ce champ n'est renseigné que par le serveur pour les appels UpdateTrip et CreateTrip, et NON pour les appels GetTrip.

LatLng

Uniquement en sortie. Itinéraire anticipé de ce trajet vers la première entrée dans "restants_waypoints". Notez que le premier point de cheminement peut appartenir à un autre trajet.

string

Uniquement en sortie. Chemin d'accès au prochain point de cheminement encodé.

Remarque : Ce champ n'est destiné qu'à être utilisé par le SDK Driver et le SDK Consumer. Le décodage n'est pas encore disponible.

Timestamp

Uniquement en sortie. Indique la dernière fois que l'itinéraire a été modifié.

Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver et le SDK Consumer.

ConsumableTrafficPolyline

Uniquement en sortie. Indique les conditions de circulation le long du current_route_segment, le cas échéant.

Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver et le SDK Consumer.

Timestamp

Uniquement en sortie. Indique la dernière fois que le current_route_segment_traffic a été modifié.

Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver et le SDK Consumer.

TripWaypoint

Uniquement en sortie. Point de cheminement où se termine current_route_segment.

Int32Value

Uniquement en sortie. Distance restante à parcourir dans le champ current_route_segment. La valeur n'est pas spécifiée si le trajet n'est pas attribué à un véhicule, ou s'il est terminé ou annulé.

Timestamp

Uniquement en sortie. Heure d'arrivée estimée au prochain point de cheminement (première entrée du champ remaining_waypoints). La valeur n'est pas spécifiée si le trajet n'est pas attribué à un véhicule ou s'il est inactif (terminé ou annulé).

Duration

Uniquement en sortie. Durée entre le retour des données de trajet et l'heure dans Trip.eta_to_first_waypoint. La valeur n'est pas spécifiée si le trajet n'est pas attribué à un véhicule ou s'il est inactif (terminé ou annulé).

Timestamp

Uniquement en sortie. Indique la dernière fois que remaining_waypoints a été modifié (un point de cheminement a été ajouté, supprimé ou modifié).

Timestamp

Uniquement en sortie. Indique la dernière fois que les éléments remaining_waypoints.path_to_waypoint et remaining_waypoints.traffic_to_waypoint ont été modifiés. Votre application cliente doit mettre en cache cette valeur et la transmettre dans GetTripRequest pour s'assurer que les chemins et le trafic de remaining_waypoints ne sont renvoyés que s'ils sont mis à jour.

int32

Immuable. Indique le nombre de passagers de ce trajet, sans inclure le conducteur. Un véhicule doit avoir une capacité disponible pour être renvoyé dans une réponse SearchVehicles.

VehicleLocation

Uniquement en sortie. Indique la dernière position signalée du véhicule sur l'itinéraire.

bool

Uniquement en sortie. Indique si le last_location du véhicule peut être ancré au segment current_route_segment. "False" si last_location ou current_route_segment n'existe pas. Il est calculé par Fleet Engine. Toute mise à jour effectuée par les clients sera ignorée.

TripView

Sous-ensemble des champs de trajet renseignés et mode d'interprétation

TerminalLocation

Emplacement de ce point de cheminement.

string

Trajet associé à ce point de repère.

WaypointType

Rôle de ce point de repère dans le trajet, par exemple "Ramassage" ou "Dépose".

LatLng

Chemin d'accès du point de cheminement précédent au point de cheminement actuel. Non défini pour le premier point de cheminement d'une liste. Ce champ n'est renseigné que sur demande.

string

Trajet encodé entre le point de cheminement précédent et le point de cheminement actuel.

Remarque : Ce champ n'est destiné qu'à être utilisé par le SDK Driver et le SDK Consumer. Le décodage n'est pas encore disponible.

ConsumableTrafficPolyline

Conditions de circulation du trajet menant à ce point de cheminement. Notez que le trafic n'est disponible que pour les clients de la solution Rides and Deliveries de Google Maps Platform.

Int32Value

Distance du chemin entre le point de cheminement précédent et le point de cheminement actuel. Non défini pour le premier point de cheminement d'une liste.

Timestamp

Heure d'arrivée estimée à ce point de repère. Non défini pour le premier point de cheminement d'une liste.

Duration

Temps de trajet entre le point de cheminement précédent et ce point. Non défini pour le premier point de cheminement d'une liste.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/trips/{trip}. Le fournisseur doit être l'ID de projet (par exemple, sample-consumer-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

Trip

Obligatoire. Le trajet associé à la mise à jour.

Les champs suivants sont gérés par Fleet Engine. Ne les mettez pas à jour à l'aide de Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Lorsque vous mettez à jour le Trip.vehicle_id d'un trajet partagé, vous devez fournir la liste des Trip.vehicle_waypoints pour spécifier l'ordre des points de cheminement restants. Sinon, cet ordre sera indéterminé.

Lorsque vous spécifiez Trip.vehicle_waypoints, la liste doit contenir tous les points de cheminement restants des trajets du véhicule, sans aucun point de cheminement supplémentaire. Vous devez organiser ces points de repère de sorte que, pour un trajet donné, le point de prise en charge soit placé avant les destinations intermédiaires, et que toutes les destinations intermédiaires soient placées avant le point de dépose. Les points de cheminement d'un trajet EXCLUSIVE ne doivent pas se chevaucher avec d'autres trajets. Les champs trip_id, waypoint_type et location sont utilisés, et tous les autres champs TripWaypoint de vehicle_waypoints sont ignorés.

Pour éviter une condition de concurrence pour les trajets avec plusieurs destinations, vous devez fournir Trip.intermediate_destinations_version lorsque vous définissez l'état du trajet sur ENROUTE_TO_INTERMEDIATE_DESTINATION. La valeur Trip.intermediate_destinations_version transmise doit correspondre à la version de Fleet Engine. Si ce n'est pas le cas, la requête échoue.

FieldMask

Obligatoire. Masque de champ indiquant les champs du trajet à mettre à jour. L'update_mask doit contenir au moins un champ.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/vehicles/{vehicle}. Le fournisseur doit être l'ID de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

VehicleAttribute

Obligatoire. Attributs du véhicule à mettre à jour. Les attributs non mentionnés ne sont pas modifiés ni supprimés.

VehicleAttribute

Obligatoire. Liste complète mise à jour des attributs du véhicule, y compris les attributs nouveaux, modifiés et inchangés.

RequestHeader

En-tête de requête Fleet Engine standard.

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/vehicles/{vehicle}. {provider} doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

Vehicle

Obligatoire. Valeurs de l'entité Vehicle à appliquer. Lors de la mise à jour d'un Vehicle, il est possible que les champs suivants ne soient pas mis à jour, car ils sont gérés par le serveur.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Si le champ attributes est modifié, tous les attributs du véhicule sont remplacés par ceux fournis dans la requête. Si vous ne souhaitez mettre à jour que certains attributs, consultez la méthode UpdateVehicleAttributes.

De même, le champ waypoints peut être mis à jour, mais doit contenir tous les points de cheminement actuellement sur le véhicule et aucun autre.

FieldMask

Obligatoire. Masque de champ indiquant les champs du Vehicle à mettre à jour. Vous devez indiquer au moins un nom de champ.

string

Uniquement en sortie. Nom unique de ce véhicule. Il a le format suivant : providers/{provider}/vehicles/{vehicle}.

VehicleState

État du véhicule.

TripType

Types de trajets acceptés par ce véhicule.

string

Uniquement en sortie. Liste des trip_id pour les trajets actuellement attribués à ce véhicule.

VehicleLocation

Dernière position signalée du véhicule.

int32

Nombre total d'usagers pouvant être transportés par ce véhicule. Le pilote n'est pas pris en compte dans cette valeur. Cette valeur doit être supérieure ou égale à 1.

VehicleAttribute

Liste des attributs du véhicule. Un véhicule peut avoir 100 attributs au maximum, et chaque attribut doit avoir une clé unique.

VehicleType

Obligatoire. Type de ce véhicule. Peut être utilisé pour filtrer les véhicules dans les résultats SearchVehicles. Elle a également une incidence sur l'heure d'arrivée prévue et les calculs d'itinéraire.

LicensePlate

Informations sur la plaque d'immatriculation du véhicule.

TerminalLocation

Obsolète: utilisez plutôt Vehicle.waypoints.

string

Polyligne spécifiant l'itinéraire que l'application du conducteur prévoit d'emprunter pour atteindre le point de cheminement suivant. Cette liste est également renvoyée dans Trip.current_route_segment pour tous les trajets actifs attribués au véhicule.

Remarque : Ce champ n'est destiné qu'à être utilisé par le SDK du pilote. Le décodage n'est pas encore disponible.

TrafficPolylineData

Uniquement en entrée. Fleet Engine utilise ces informations pour améliorer le partage de trajets. Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver.

Timestamp

Uniquement en sortie. Heure à laquelle current_route_segment a été défini. Il peut être stocké par le client et transmis dans les futures requêtes GetVehicle pour éviter de renvoyer des itinéraires qui n'ont pas changé.

TripWaypoint

Point de repère où current_route_segment se termine. Ces informations peuvent être fournies par les conducteurs lors d'appels UpdateVehicle, soit en tant que point de cheminement complet pour le trajet, en tant que point de cheminement LatLng, soit en tant que dernier LatLng du current_route_segment. Fleet Engine fera ensuite de son mieux pour interpoler un point de cheminement réel s'il n'est pas entièrement spécifié. Ce champ est ignoré dans les appels UpdateVehicle, sauf si current_route_segment est également spécifié.

Int32Value

Distance en voiture restante pour le current_route_segment. Cette valeur est également renvoyée dans Trip.remaining_distance_meters pour tous les trajets actifs attribués au véhicule. La valeur n'est pas spécifiée si le champ current_route_segment est vide.

Timestamp

Heure d'arrivée estimée à la première entrée du champ waypoints. La valeur n'est pas spécifiée si le champ waypoints est vide ou si le champ Vehicle.current_route_segment est vide.

Lors de la mise à jour d'un véhicule, remaining_time_seconds est prioritaire sur eta_to_first_waypoint dans la même requête.

Int32Value

Uniquement en entrée. Temps de trajet restant pour le current_route_segment. La valeur n'est pas spécifiée si le champ waypoints ou Vehicle.current_route_segment est vide. Cette valeur doit correspondre à eta_to_first_waypoint - current_time si toutes les parties utilisent la même horloge.

Lors de la mise à jour d'un véhicule, remaining_time_seconds est prioritaire sur eta_to_first_waypoint dans la même requête.

TripWaypoint

Les points de cheminement restants attribués à ce véhicule.

Timestamp

Uniquement en sortie. Heure de la dernière mise à jour du champ waypoints. Les clients doivent mettre en cache cette valeur et la transmettre dans GetVehicleRequest pour s'assurer que le champ waypoints n'est renvoyé que s'il est mis à jour.

bool

Indique si le conducteur accepte des trajets intervenus. Si true, SearchVehicles peut inclure le véhicule même s'il est actuellement attribué à un trajet. La valeur par défaut est false.

NavigationStatus

État de navigation du véhicule.

DeviceSettings

Uniquement en entrée. Informations sur les paramètres de l'appareil mobile utilisé par le pilote.

Category

Catégorie de type de véhicule

string

Clé de l'attribut. Les clés ne doivent pas contenir le caractère deux-points (:).

string

Valeur de l'attribut.

string

Valeur d'attribut de type chaîne.

Remarque: Ce champ est identique au champ value, qui sera à terme abandonné. Pour les méthodes de création ou de mise à jour, vous pouvez utiliser l'un ou l'autre des champs, mais nous vous recommandons vivement d'utiliser string_value. Si string_value et value sont tous 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

Valeur d'attribut de type booléen.

double

Valeur d'attribut à double type.

VehicleAttribute

Liste des attributs de cette collection.

LatLng

Emplacement du véhicule. Lorsqu'il est envoyé à Fleet Engine, la position du véhicule correspond à une position GPS. Lorsque vous la recevez dans une réponse, la position du véhicule peut être une position GPS, une position supplémentaire ou une autre position estimée. La source est spécifiée dans location_sensor.

DoubleValue

Obsolète : utilisez latlng_accuracy à la place.

DoubleValue

Précision de location en mètres sous la forme d'un rayon.

Int32Value

Direction du véhicule en degrés 0 représente le nord. La plage valide est [0,360].

DoubleValue

Obsolète: utilisez plutôt heading_accuracy.

DoubleValue

Précision de heading en degrés.

DoubleValue

Altitude en mètres au-dessus de WGS84.

DoubleValue

Obsolète : utilisez altitude_accuracy à la place.

DoubleValue

Précision de altitude en mètres.

Int32Value

Vitesse du véhicule en kilomètres par heure. Obsolète : utilisez speed à la place.

DoubleValue

Vitesse du véhicule en mètres/seconde

DoubleValue

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

Timestamp

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

Timestamp

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

LocationSensor

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

BoolValue

Indique si location est associé à une route.

BoolValue

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

Int32Value

Uniquement en entrée. Durée (en secondes) depuis l'envoi de cet emplacement au serveur pour la première fois. Il sera nul pour la première mise à jour. Si l'heure n'est pas connue (lorsque l'application redémarre, par exemple), cette valeur est réinitialisée.

Int32Value

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

LatLng

Localisation brute du véhicule (non traitée par la capture de route).

Timestamp

Horodatage associé à l'emplacement brut.

LocationSensor

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

DoubleValue

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

LatLng

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

Timestamp

Code temporel associé à l'emplacement supplémentaire.

LocationSensor

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

DoubleValue

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

bool

Obsolète: utilisez plutôt is_road_snapped.

Vehicle

Obligatoire. Un véhicule correspondant à la requête

Timestamp

Heure d'arrivée estimée du véhicule au point de ramassage spécifié dans la requête. Une valeur vide indique un échec de calcul de l'heure d'arrivée prévue pour le véhicule. Si SearchVehiclesRequest.include_back_to_back était true et que ce véhicule a un trajet actif, vehicle_pickup_eta inclut le temps nécessaire pour terminer le trajet actif en cours.

Int32Value

Distance entre l'emplacement actuel du véhicule et le point de prise en charge spécifié dans la demande, y compris les points de prise en charge ou de dépose intermédiaires pour les trajets existants. Cette distance comprend la distance calculée en voiture (itinéraire), ainsi que la distance en ligne droite entre le point d'arrivée de la navigation et le point de prise en charge demandé. (La distance entre le point d'arrivée pour la navigation et le lieu de prise en charge demandé est généralement faible.) Une valeur vide indique une erreur de calcul de la distance.

Int32Value

Obligatoire. Distance en ligne droite entre le véhicule et le point de prise en charge spécifié dans la demande.

Timestamp

Heure d'arrivée estimée du véhicule complet au point de dépose spécifié dans la demande. L'heure d'arrivée prévue inclut les arrêts aux points de cheminement avant l'dropoff_point spécifié dans la requête. La valeur n'est renseignée que lorsqu'un point de dépôt est spécifié dans la requête. Une valeur vide indique une erreur lors du calcul de l'heure d'arrivée estimée.

Int32Value

Distance parcourue (en mètres) du véhicule entre le lieu de prise en charge et le lieu de dépôt spécifié dans la demande. La distance est uniquement entre les deux points et n'inclut pas l'emplacement du véhicule ni tout autre point à visiter avant que le véhicule ne se rende au lieu de prise en charge ou de dépôt. La valeur n'est renseignée que lorsqu'un dropoff_point est spécifié dans la requête. Une valeur vide indique un échec de calcul de la distance entre la prise en charge et le lieu de dépose spécifié dans la requête.

TripType

Obligatoire. Type de trajet de la requête utilisée pour calculer l'heure d'arrivée estimée au point de prise en charge.

Waypoint

Liste triée des points de cheminement utilisés pour calculer l'heure d'arrivée prévue. La liste comprend la localisation du véhicule, les points de retrait des trajets actifs pour le véhicule et les points de retrait indiqués dans la demande. Une liste vide indique un échec lors du calcul de l'heure d'arrivée estimée du véhicule.

VehicleMatchType

Le type du véhicule correspond.

VehicleMatchOrder

Ordre demandé pour trier les correspondances de véhicules.

VehicleMatchOrder

Commande réelle utilisée pour ce véhicule. Normalement, il correspond au champ "order_by" de la requête. Toutefois, dans certaines circonstances, comme en cas d'erreur interne du serveur, une autre méthode peut être utilisée (par exemple, PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

Facultatif. Segments de route à afficher le long de la polyligne. Les tronçons ne se chevauchent pas nécessairement et ne couvrent pas nécessairement l'intégralité de l'itinéraire.

En l'absence de tronçon de route à styliser, le client doit appliquer le style par défaut pour l'itinéraire.

Style

Obligatoire. Style à appliquer.

int32

Obligatoire. Le style doit être appliqué entre [offset_meters, offset_meters + length_meters).

int32

Obligatoire. Longueur du tracé où appliquer le style.

LatLng

Emplacement de ce point de cheminement.

Timestamp

Heure estimée à laquelle le véhicule arrivera à ce point de repère.