Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

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

float

Pourcentage actuel de la batterie [0-100].

SpeedReadingInterval

Vitesse du trafic sur le trajet entre le point de repère précédent et le point de repère actuel.

string

Chemin emprunté par le chauffeur entre le point de repère précédent et le point de repère actuel. Ce chemin comporte des points de repère afin que les clients puissent afficher des indicateurs de trafic le long du chemin (voir speed_reading_interval). Le décodage n'est pas encore pris en charge.

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 qui effectue cet appel est membre.

string

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

Trip

Obligatoire. Entité de voyage à créer.

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

• trip_type
• pickup_point

Les champs suivants sont utilisés si vous les fournissez :

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Tous les autres champs de Trip sont ignorés. Par exemple, tous les trajets commencent avec 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 repère restants pour le véhicule. Sinon, l'ordre des points de repère ne sera pas déterminé.

Lorsque vous spécifiez Trip.vehicle_waypoints, la liste doit contenir tous les points de cheminement restants des trajets du véhicule, sans point de cheminement supplémentaire. Vous devez organiser ces waypoints de sorte que, pour un trajet donné, le point de prise en charge se trouve avant les destinations intermédiaires, et que toutes les destinations intermédiaires se trouvent avant le point de dépose. Les waypoints d'un trajet EXCLUSIVE ne doivent pas être entrelacés avec ceux 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.

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 qui effectue cet appel est membre.

string

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

Vehicle

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

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Lorsque vous créez 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 fournis.

RequestHeader

Facultatif. 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 qui effectue cet appel est membre.

RequestHeader

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

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/vehicles/{vehicle}. {provider} doit correspondre à 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.

LocationPowerSaveMode

Comportement 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 dans un état 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 qui effectue cet appel est membre.

TripView

Sous-ensemble des champs de trajet à 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 route n'ont pas changé depuis cet horodatage, le champ "route" n'est pas défini dans la réponse. Si un minimum n'est pas spécifié, les données de route sont toujours récupérées.

Timestamp

Obsolète : les Trip.remaining_waypoints sont toujours récupérés. Utilisez remaining_waypoints_route_version pour contrôler le moment où les données Trip.remaining_waypoints.traffic_to_waypoint et Trip.remaining_waypoints.path_to_waypoint sont récupérées.

PolylineFormatType

Format de l'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 (exclusif) pour lequel Trip.current_route_segment_traffic est récupéré. Si les données de trafic n'ont pas changé depuis cet horodatage, le champ current_route_segment_traffic n'est pas défini dans la réponse. Si un minimum n'est pas spécifié, les données de trafic sont toujours récupérées. Notez que le trafic n'est disponible que pour les clients de la solution Courses et livraisons à la demande.

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 d'accès 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 qui effectue cet appel est membre.

Timestamp

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

Timestamp

Indique le code temporel minimal (exclusif) pour lequel les données Vehicle.waypoints sont récupérées. Si les waypoints n'ont pas changé depuis ce code temporel, 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

Dernier chiffre de la plaque d'immatriculation ou "-1" pour indiquer qu'aucun chiffre n'est présent sur la plaque d'immatriculation.

• "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 de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service qui effectue cet appel est membre.

int32

Nombre maximal de véhicules à renvoyer. Valeur par défaut : 100.

string

Valeur de next_page_token fournie par un appel précédent à ListVehicles pour vous permettre de paginer les groupes de véhicules. La valeur est indéfinie si les critères de filtrage de la requête ne sont pas les mêmes que ceux de l'appel précédent à ListVehicles.

Int32Value

Indique la capacité minimale requise du véhicule. Tous les véhicules renvoyés auront une valeur maximum_capacity supérieure ou égale à cette valeur. Si elle est définie, elle doit être supérieure ou égale à 0.

TripType

Limite la réponse aux véhicules qui acceptent 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 leur position à Fleet Engine au cours de la période spécifiée. Les véhicules à l'arrêt qui transmettent toujours leur position ne sont pas considérés comme non actualisés. Si elle est présente, elle 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 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, tandis que required_one_of_attributes utilise un message qui autorise une liste de listes. Combinés, 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/ET. Vous ne pouvez pas inclure plus de 50 attributs required_attributes. Cela correspond au nombre maximal d'attributs autorisés pour un véhicule. Chaque chaîne répétée doit être au format "clé:valeur".

string

Restreint 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 inclusive/OR dans chaque VehicleAttributeList et une opération de conjonction/AND dans 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 offre des fonctionnalités supplémentaires.

Comme 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 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
  ...)
)

Restreint 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 inclusive/OR dans la collection de 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 qui présentent cet état.

bool

Ne renvoyez que les véhicules avec des trajets en cours.

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 AND avec d'autres contraintes, telles que vehicle_state ou on_trip_only.

Notez que seules les requêtes sur les attributs du véhicule sont acceptées (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Le nombre maximal de restrictions autorisées 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 d'attributs acceptées 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").

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 suivante de véhicules. La valeur est nulle si la liste ne contient plus de véhicules correspondant 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 qui effectue cet appel est membre.

string

Obligatoire. Code pays à deux lettres du pays où se déroule le voyage. Le prix est défini en fonction du code pays.

BillingPlatformIdentifier

Plate-forme sur laquelle la demande 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ée 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 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.

string

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

string

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

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.

string

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

SdkType

Type de SDK qui envoie la requête.

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.

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. Ne s'applique qu'aux SDK Android. Exemple de valeur de champ : Samsung.

int32

Niveau d'API Android du SDK appelant. Ne s'applique qu'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 qui effectue cet appel est membre.

string

Véhicule associé aux trajets de la requête. Si rien n'est 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 la valeur est "true", la réponse inclut les trajets qui influencent l'itinéraire d'un conducteur.

int32

Si cette valeur n'est pas définie, le serveur détermine le 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 de trajets 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 de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service qui effectue cet appel est membre.

TerminalLocation

Obligatoire. Point de retrait à proximité duquel effectuer la recherche.

TerminalLocation

Lieu de dépose 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 renvoyé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 à prendre en compte pour un trajet. La valeur doit être supérieure ou égale à 1. Le chauffeur n'est pas pris en compte dans la valeur de capacité.

TripType

Obligatoire. Représente le type de trajet proposé. Doit inclure un seul type. UNKNOWN_TRIP_TYPE : non autorisé. La recherche est limitée aux véhicules compatibles avec ce type de trajet.

Duration

Limite la recherche aux véhicules qui ont envoyé des mises à jour de leur position à Fleet Engine au cours de la période spécifiée. Les véhicules à l'arrêt qui transmettent toujours leur position ne sont pas considérés comme non actualisés. 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 d'un des types spécifiés. Vous devez spécifier au moins un type de véhicule. Les VehicleTypes dont la catégorie est 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, tandis que required_one_of_attributes utilise un message qui autorise une liste de listes. Combinés, 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 est une opération de conjonction/ET. Vous ne pouvez pas inclure plus de 50 attributs required_attributes. Cela correspond au nombre maximal d'attributs autorisés pour un véhicule.

VehicleAttributeList

Limite la recherche aux véhicules qui possèdent 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 inclusive/OR dans chaque VehicleAttributeList et une opération de conjonction/AND dans la collection de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets offre des fonctionnalités supplémentaires.

Comme 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 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 possèdent 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 inclusive/OR 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 à 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 ont été 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 des 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 effectuant des trajets actifs sont éligibles à cette recherche. Cette valeur doit être définie sur une valeur autre que CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type inclut SHARED.

string

Facultatif. Requête de filtre à appliquer lors de la recherche de 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 AND avec d'autres contraintes, telles que minimum_capacity ou vehicle_types.

Notez que seules les requêtes sur les attributs du véhicule sont acceptées (par exemple, attributes.<key> = <value> ou attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Le nombre maximal de restrictions autorisées 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 d'attributs acceptées 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").

VehicleMatch

Liste des véhicules correspondant aux critères SearchVehiclesRequest, triée selon le champ SearchVehiclesRequest.order_by.

int32

Index de début de cet intervalle dans le chemin d'accès. En JSON, lorsque l'index est défini sur 0, le champ apparaît comme non renseigné.

int32

Index de fin de cet intervalle dans le chemin. En JSON, lorsque l'index est défini sur 0, le champ apparaît comme non renseigné.

Speed

Vitesse du trafic dans cet intervalle.

LatLng

Obligatoire. Indique l'emplacement réel.

Timestamp

Indique quand l'arrêt a eu lieu.

Timestamp

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

LatLng

Indique la LatLng exacte du point de cheminement. 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.

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.

PointSource

Uniquement en sortie. Source du champ point.

TerminalPointId

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

string

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

string

Obsolète.

WaypointType

Obsolète : Vehicle.waypoint disposera de ces données.

string

Obsolète.

string

Obsolète.

string

Obsolète.

VisualTrafficReportPolylineRendering

Représentation sous forme de polyligne de la fluidité du trafic pour toutes les régions traversées par un client lors d'un trajet.

string

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

string

ID du véhicule effectuant ce trajet.

TripStatus

État actuel du trajet.

TripType

Type de trajet.

TerminalLocation

Lieu où le client indique qu'il sera pris en charge.

StopLocation

Uniquement en entrée. Lieu exact où le client a été pris en charge. Ce champ permet au fournisseur de fournir des commentaires sur les informations de retrait réelles.

StopLocation

Uniquement en entrée. Heure et lieu réels de l'arrivée du chauffeur au point de prise en charge. Ce champ permet au fournisseur de fournir des commentaires sur les informations d'arrivée réelles au point de retrait.

Timestamp

Uniquement en sortie. Heure future estimée à laquelle le ou les passagers seront pris en charge, ou heure réelle à laquelle ils l'ont été.

TerminalLocation

Arrêts intermédiaires dans l'ordre des demandes de trajet (en plus des lieux de prise en charge et de dépose). Au début, cette fonctionnalité ne sera pas disponible pour les trajets partagés.

Timestamp

Indique la dernière fois que 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, il s'agit d'un nombre compris entre 0 et N-1 indiquant la prochaine destination intermédiaire que le véhicule traversera. Lorsque TripStatus est ARRIVED_AT_INTERMEDIATE_DESTINATION, il s'agit d'un nombre compris entre 0 et N-1 indiquant la destination intermédiaire à laquelle se trouve le véhicule. Le fournisseur définit cette valeur. Si aucun intermediate_destinations n'est défini, ce champ est ignoré.

StopLocation

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

StopLocation

Uniquement en entrée. Heure et lieu réels où le client a été récupéré à une destination intermédiaire. Ce champ permet au fournisseur de fournir des commentaires sur les informations de prise en charge réelles aux destinations intermédiaires.

TerminalLocation

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

StopLocation

Uniquement en entrée. Heure et lieu réels où le client a été déposé. Ce champ permet au fournisseur de fournir des commentaires sur les informations de dépose réelles.

Timestamp

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

TripWaypoint

Uniquement en sortie. Chemin d'accès complet de l'emplacement actuel au point de dépôt, inclus. Ce chemin peut inclure des points de cheminement provenant d'autres trajets.

TripWaypoint

Ce champ permet de classer manuellement les points de cheminement du 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 pour 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é par le serveur que lors des appels UpdateTrip et CreateTrip, et NON lors des appels GetTrip.

LatLng

Uniquement en sortie. Itinéraire prévu pour ce trajet jusqu'à la première entrée de remaining_waypoints. Notez que le premier point de cheminement peut appartenir à un autre trajet.

string

Uniquement en sortie. Chemin encodé vers le prochain point de repère.

Remarque : Ce champ est destiné à être utilisé uniquement par le Driver SDK et le Consumer SDK. 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é à être utilisé uniquement par le Driver SDK et le Consumer SDK.

ConsumableTrafficPolyline

Uniquement en sortie. Indique les conditions de circulation le long de current_route_segment, lorsqu'elles sont disponibles.

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

Timestamp

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

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

TripWaypoint

Uniquement en sortie. Point de repère où current_route_segment se termine.

Int32Value

Uniquement en sortie. La distance de conduite restante 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 prévue au prochain point de repère (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 écoulée entre le moment où les données de trajet sont renvoyées et l'heure indiquée 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 repère a été ajouté, supprimé ou modifié).

Timestamp

Uniquement en sortie. Indique la dernière fois que 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 pour remaining_waypoints ne sont renvoyés que s'ils sont mis à jour.

int32

Immuable. Indique le nombre de passagers pour ce trajet (le conducteur n'est pas inclus). Un véhicule doit avoir de la 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 associé au current_route_segment. "False" si last_location ou current_route_segment n'existent pas. Il est calculé par Fleet Engine. Toute mise à jour des clients sera ignorée.

TripView

Sous-ensemble des champs de trajet renseignés et la façon dont ils doivent être interprétés.

TripAttribute

Liste des attributs de voyage personnalisés. Chaque attribut doit avoir une clé unique.

string

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

string

Valeur d'attribut de type chaîne.

bool

Valeur d'attribut de type booléen.

double

Valeur d'attribut de type double.

TerminalLocation

Emplacement de ce point de repère.

string

Trajet associé à ce point de cheminement.

WaypointType

Rôle de ce point de cheminement dans le trajet (par exemple, point de prise en charge ou de dépose).

LatLng

Chemin entre le point de repère précédent et le point de repère actuel. S'il s'agit du premier point de repère, le trajet part de la position actuelle du véhicule et va jusqu'au point de repère. Ce champ n'est renseigné que sur demande.

string

Chemin encodé du point de repère précédent au point de repère actuel.

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

ConsumableTrafficPolyline

Conditions de circulation sur le trajet jusqu'à ce point de repère. Notez que le trafic n'est disponible que pour les clients de la solution Courses et livraisons de Google Maps Platform.

Int32Value

Distance du chemin entre le point de repère précédent et le point de repère actuel. S'il s'agit du premier point de repère, la distance du chemin correspond à la distance entre la position actuelle du véhicule et le point de repère.

Timestamp

Heure d'arrivée estimée à ce point de repère.

Duration

Temps de trajet entre le point de cheminement précédent et celui-ci. S'il s'agit du premier point de cheminement, le temps de trajet est calculé depuis la position actuelle du véhicule jusqu'au point de cheminement.

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 qui effectue cet appel est membre.

Trip

Obligatoire. 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, l'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 point de cheminement supplémentaire. Vous devez organiser ces waypoints de sorte que, pour un trajet donné, le point de prise en charge se trouve avant les destinations intermédiaires, et que toutes les destinations intermédiaires se trouvent avant le point de dépose. Les waypoints d'un trajet EXCLUSIVE ne doivent pas être entrelacés avec ceux 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. Le Trip.intermediate_destinations_version transmis doit être cohérent avec 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. 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 qui effectue 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 de 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 correspondre à 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.

Vehicle

Obligatoire. Valeurs d'entité Vehicle à appliquer. Lorsque vous mettez à jour un Vehicle, les champs suivants ne peuvent pas être modifiés, 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 mis à jour, tous les attributs du véhicule sont remplacés par ceux fournis dans la requête. Si vous souhaitez mettre à jour uniquement certains attributs, consultez la méthode UpdateVehicleAttributes.

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

FieldMask

Obligatoire. Masque de champ indiquant les champs de 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.

VehicleLocation

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

int32

Nombre total de passagers que ce véhicule peut transporter. Le chauffeur n'est pas inclus dans cette valeur. Cette valeur doit être supérieure ou égale à 1.

VehicleAttribute

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

VehicleType

Obligatoire. Type de véhicule. Peut être utilisé pour filtrer les véhicules dans les résultats SearchVehicles. Il a également une incidence sur le calcul de l'heure d'arrivée prévue et de l'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 jusqu'au prochain point de repère. Cette liste est également renvoyée dans Trip.current_route_segment pour tous les trajets actifs attribués au véhicule.

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

TrafficPolylineData

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

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. Les conducteurs peuvent fournir cette information lors des appels UpdateVehicle, soit en tant que point de cheminement complet, soit 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 véritable point de cheminement 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 de conduite restante pour 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 prévue pour la première entrée dans le champ waypoints. La valeur n'est pas spécifiée si le champ waypoints ou Vehicle.current_route_segment est vide.

Lorsque vous mettez à jour 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 conduite restant pour 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.

Lorsque vous mettez à jour un véhicule, remaining_time_seconds est prioritaire sur eta_to_first_waypoint dans la même requête.

TripWaypoint

Points de cheminement restants attribués à ce véhicule.

Timestamp

Uniquement en sortie. Date 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 chauffeur accepte les courses consécutives. Si true, SearchVehicles peut inclure le véhicule même s'il est actuellement affecté à un trajet. La valeur par défaut est false.

NavigationStatus

État de la navigation du véhicule.

DeviceSettings

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

Category

Catégorie de type de véhicule

string

Clé de l'attribut. Les clés ne peuvent 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 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

Valeur d'attribut de type booléen.

double

Valeur d'attribut de type double.

VehicleAttribute

Liste des attributs de cette collection.

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.

DoubleValue

Obsolète : utilisez plutôt latlng_accuracy.

DoubleValue

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

Int32Value

Direction dans laquelle le véhicule se déplace, 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 plutôt altitude_accuracy.

DoubleValue

Précision de altitude en mètres.

Int32Value

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

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 de données de localisation (par exemple, GPS).

BoolValue

Indique si location est ancré à une route.

BoolValue

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

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.

Int32Value

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

LatLng

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

Timestamp

Code temporel associé à la position brute.

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

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

Timestamp

Code temporel de mise à jour de flp_location

DoubleValue

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

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).

LatLng

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

Timestamp

Code temporel associé au lieu 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 demande.

Timestamp

Heure d'arrivée estimée du véhicule au point de prise en charge spécifié dans la requête. Une valeur vide indique un échec du calcul de l'heure d'arrivée prévue pour le véhicule. Si SearchVehiclesRequest.include_back_to_back était défini sur 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 la position actuelle du véhicule et le point de prise en charge spécifié dans la requête, y compris les points de prise en charge ou de dépose intermédiaires pour les trajets existants. Cette distance comprend la distance de conduite (itinéraire) calculée, plus 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 de la navigation et le point de prise en charge demandé est généralement faible.) Une valeur vide indique une erreur dans le calcul de la distance.

Int32Value

Obligatoire. Distance à vol d'oiseau entre le véhicule et le point de prise en charge spécifié dans la requête.

Timestamp

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

Int32Value

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

TripType

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

Waypoint

Liste ordonnée des points de cheminement utilisés pour calculer l'heure d'arrivée prévue. La liste inclut la position du véhicule, les points de prise en charge des trajets actifs pour le véhicule et les points de prise en charge fournis dans la requête. Une liste vide indique un échec du calcul de l'heure d'arrivée prévue pour le véhicule.

VehicleMatchType

Type de correspondance du véhicule.

VehicleMatchOrder

Ordre demandé pour le tri des véhicules correspondants. Équivaut à ordered_by.

VehicleMatchOrder

Ordre demandé pour le tri des véhicules correspondants. Équivaut à requested_ordered_by.

RoadStretch

Facultatif. Tronçons de route à afficher le long de la polyligne. Les tronçons ne se chevauchent pas 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 à 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 chemin d'accès où appliquer le style.

LatLng

Emplacement de ce point de repère.

Timestamp

Heure d'arrivée estimée du véhicule à ce point de cheminement.