Ressource: Trip
Métadonnées des trajets.
Représentation JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Champs | |
---|---|
name |
Uniquement en sortie. Au format "providers/{provider}/trips/{trip}" |
vehicleId |
Identifiant du véhicule effectuant ce trajet. |
tripStatus |
État actuel du trajet. |
tripType |
Type de trajet. |
pickupPoint |
Lieu où le client indique qu'il sera récupéré. |
actualPickupPoint |
Uniquement en entrée. Lieu réel où et quand le client a été récupéré. Ce champ permet au fournisseur de fournir des commentaires sur les informations réelles de retrait. |
actualPickupArrivalPoint |
Uniquement en entrée. Heure et lieu réels d'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 retrait. |
pickupTime |
Uniquement en sortie. soit l'heure future estimée de prise en charge du ou des passagers, soit l'heure réelle à laquelle ils seront pris en charge. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
intermediateDestinations[] |
Arrêts intermédiaires pour que le trajet soit demandé (en plus des montées et des descentes). Dans un premier temps, cette fonctionnalité ne sera pas disponible pour les trajets partagés. |
intermediateDestinationsVersion |
Indique la dernière fois que le Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
intermediateDestinationIndex |
Lorsque |
actualIntermediateDestinationArrivalPoints[] |
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. |
actualIntermediateDestinations[] |
Uniquement en entrée. L'heure et le lieu réels de prise en charge du client à une destination intermédiaire. Ce champ permet au fournisseur de fournir des commentaires sur les informations réelles de retrait aux destinations intermédiaires. |
dropoffPoint |
Lieu où le client indique qu'il sera déposé. |
actualDropoffPoint |
Uniquement en entrée. Heure et lieu réels de départ et d'arrivée du client. Ce champ permet au fournisseur de fournir des commentaires sur les informations réelles de dépôt. |
dropoffTime |
Uniquement en sortie. soit l'heure future estimée de dépose des usagers à la destination finale, soit l'heure réelle à laquelle ils seront déposés. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
remainingWaypoints[] |
Uniquement en sortie. Chemin complet depuis la position actuelle jusqu'au point de dépôt (inclus). Ce trajet peut inclure des points de cheminement d'autres trajets. |
vehicleWaypoints[] |
Ce champ permet d'organiser manuellement les points de cheminement du trajet. Il contient tous les points de cheminement restants du 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 |
route[] |
Uniquement en sortie. Itinéraire prévu pour ce trajet vers la première entrée dans les lieux restants. Notez que le premier point de cheminement peut appartenir à un autre trajet. |
currentRouteSegment |
Uniquement en sortie. Trajet encodé vers le point de cheminement suivant. Remarque: Ce champ est destiné à être utilisé uniquement par le SDK Driver et le SDK grand public. Le décodage n'est pas encore pris en charge. |
currentRouteSegmentVersion |
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 SDK Driver et le SDK grand public. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
currentRouteSegmentTraffic |
Uniquement en sortie. Indique les conditions de circulation le long du Remarque: Ce champ est destiné à être utilisé uniquement par le SDK Driver et le SDK grand public. |
currentRouteSegmentTrafficVersion |
Uniquement en sortie. Indique la dernière fois que le Remarque: Ce champ est destiné à être utilisé uniquement par le SDK Driver et le SDK grand public. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
currentRouteSegmentEndPoint |
Uniquement en sortie. Point de cheminement où |
remainingDistanceMeters |
Uniquement en sortie. Distance restante en voiture dans le champ |
etaToFirstWaypoint |
Uniquement en sortie. L'heure d'arrivée prévue du point de cheminement suivant (la première entrée dans le champ Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
remainingTimeToFirstWaypoint |
Uniquement en sortie. Durée entre le renvoi des données sur le trajet et l'heure dans Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
remainingWaypointsVersion |
Uniquement en sortie. Indique la dernière fois que Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
remainingWaypointsRouteVersion |
Uniquement en sortie. Indique la dernière fois que Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
numberOfPassengers |
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 |
lastLocation |
Uniquement en sortie. Indique la dernière position signalée du véhicule sur l'itinéraire. |
lastLocationSnappable |
Uniquement en sortie. Indique si l'élément |
view |
Sous-ensemble des champs "Trajet" renseignés et comment ils doivent être interprétés. |
TripStatus
État d'un trajet indiquant sa progression.
Enums | |
---|---|
UNKNOWN_TRIP_STATUS |
Valeur par défaut, utilisée pour l'état du trajet non spécifié ou non reconnu. |
NEW |
Trajet créé. |
ENROUTE_TO_PICKUP |
Le chauffeur se dirige vers le lieu de prise en charge. |
ARRIVED_AT_PICKUP |
Le chauffeur est arrivé au point de prise en charge. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Le chauffeur est arrivé à une destination intermédiaire et attend le passager. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
le chauffeur se dirige vers une destination intermédiaire (et non le point de dépôt). |
ENROUTE_TO_DROPOFF |
Le chauffeur a pris le passager et se dirige vers la prochaine destination. |
COMPLETE |
le passager a été déposé et le trajet est terminé ; |
CANCELED |
Le trajet a été annulé avant la prise en charge par le conducteur, le passager ou le fournisseur de covoiturage. |
StopLocation
Lieu réel où l'arrêt (prise en charge/dépôt) s'est produit.
Représentation JSON |
---|
{
"point": {
object ( |
Champs | |
---|---|
point |
Obligatoire. Indique la position réelle. |
timestamp |
Indique à quel moment l'arrêt s'est produit. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
stopTime |
Uniquement en entrée. Obsolète. Utilisez le champ "Timestamp". Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
TripView
Sélecteur pour différents ensembles de champs "Trip" (Trajet) dans une réponse trips.get
. Consultez AIP-157 pour plus de contexte. D'autres vues sont susceptibles d'être ajoutées.
Enums | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Valeur par défaut. Pour assurer la rétrocompatibilité, l'API utilise par défaut une vue du SDK. Pour des raisons de stabilité et de compatibilité, nous recommandons aux clients de sélectionner une TripView autre que SDK . |
SDK |
Inclut des champs qui peuvent ne pas être interprétables ou pris en charge par les bibliothèques accessibles au public. |
JOURNEY_SHARING_V1S |
Les champs du trajet sont renseignés pour le cas d'utilisation du partage de trajet. Cette vue est destinée aux communications de serveur à serveur. |
Méthodes |
|
---|---|
|
Crée un trajet dans Fleet Engine et l'affiche. |
|
Obtenez des informations sur un seul trajet. |
|
Obtenez tous les trajets pour un véhicule spécifique. |
|
Met à jour les données sur les trajets. |