REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

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

string

Identifiant du véhicule effectuant ce trajet.

enum (TripStatus)

État actuel du trajet.

enum (TripType)

Type de trajet.

object (TerminalLocation)

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

object (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.

object (StopLocation)

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

string (Timestamp format)

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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (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). Dans un premier temps, cette option ne sera pas disponible pour les trajets partagés.

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

integer

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 défini sur ARRIVED_AT_INTERMEDIATE_DESTINATION, un nombre compris entre [0..N-1] indiquant la destination intermédiaire à laquelle se trouve le véhicule. Le fournisseur définit cette valeur. Si aucun intermediateDestinations n'est défini, ce champ est ignoré.

object (StopLocation)

Uniquement en entrée. Heure et lieu réels de l'arrivée du conducteur à 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.

object (StopLocation)

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

object (TerminalLocation)

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

object (StopLocation)

Uniquement en entrée. Heure et lieu exacts de la dépose du client. Ce champ permet au fournisseur de fournir des commentaires sur les informations de dépose réelles.

string (Timestamp format)

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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Uniquement en sortie. Chemin d'accès complet entre l'emplacement actuel et le point de dépôt, y compris. Ce tracé peut inclure des points de cheminement d'autres trajets.

object (TripWaypoint)

Ce champ permet de trier manuellement les points de cheminement pour le trajet. Il contient tous les points de repère restants pour le véhicule attribué, ainsi que les points 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 trips.update et trips.create, et NON pour les appels trips.get.

object (LatLng)

Uniquement en sortie. Itinéraire anticipé de ce trajet vers la première entrée dans les points de cheminement restants. Notez que le premier point de cheminement peut appartenir à un trajet différent.

string

Uniquement en sortie. Chemin encodé vers le point de cheminement suivant.

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.

string (Timestamp format)

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

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (ConsumableTrafficPolyline)

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

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

string (Timestamp format)

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

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

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

integer

Uniquement en sortie. Distance de conduite restante dans le champ currentRouteSegment. 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é.

string (Timestamp format)

Uniquement en sortie. Heure d'arrivée estimée au prochain point de cheminement (première entrée du champ remainingWaypoints). 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é).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Duration format)

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

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

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Uniquement en sortie. Indique la dernière fois que les remainingWaypoints.path_to_waypoint et remainingWaypoints.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 d'accès et le trafic de remainingWaypoints ne sont renvoyés que s'ils sont mis à jour.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

integer

Immuable. Indique le nombre de passagers pour ce trajet (le chauffeur n'est pas inclus). Un véhicule doit avoir une capacité disponible pour être renvoyé dans une réponse vehicles.search.

object (VehicleLocation)

Uniquement en sortie. Indique le dernier emplacement signalé du véhicule le long du trajet.

boolean

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

enum (TripView)

Sous-ensemble des champs "Trip" qui sont renseignés et comment ils doivent être interprétés.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Obligatoire. Indique l'emplacement réel.

string (Timestamp format)

Indique à quel moment l'arrêt s'est produit.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".