- Ressource: Trip
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TripStatus
- StopLocation
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TripView
- Méthodes
Ressource: Trip
Métadonnées du trajet.
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 retiré. |
actualPickupPoint |
Uniquement en entrée. L'emplacement réel où et quand le client a été retiré. Ce champ permet au fournisseur de fournir des commentaires sur les informations de retrait réelles. |
actualPickupArrivalPoint |
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. |
pickupTime |
Uniquement en sortie. Il peut s'agir de l'heure de départ estimée du ou des passagers, ou de 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 : |
intermediateDestinations[] |
Arrêts intermédiaires dans l'ordre de la demande de trajet (en plus des prises en charge et des déposes). Dans un premier temps, cette option ne sera pas disponible pour les trajets partagés. |
intermediateDestinationsVersion |
Indique la dernière fois que le Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
intermediateDestinationIndex |
Lorsque |
actualIntermediateDestinationArrivalPoints[] |
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. |
actualIntermediateDestinations[] |
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 prise en charge réelles aux destinations intermédiaires. |
dropoffPoint |
Lieu où le client indique qu'il sera déposé. |
actualDropoffPoint |
Uniquement en entrée. L'heure et le lieu réels du moment et du lieu où le client a été déposé Ce champ permet au fournisseur de fournir des commentaires sur les informations de dépôt réelles. |
dropoffTime |
Uniquement en sortie. Il peut s'agir de l'heure à laquelle les usagers seront déposés à la destination finale ou de l'heure réelle à laquelle ils seront 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 : |
remainingWaypoints[] |
Uniquement en sortie. Chemin complet (inclus) entre la position actuelle et le point de dépôt. Ce tracé peut inclure des points de cheminement d'autres trajets. |
vehicleWaypoints[] |
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é par le serveur que lors des appels |
route[] |
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. |
currentRouteSegment |
Uniquement en sortie. Chemin encodé vers le point de cheminement suivant. Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver et le SDK Consumer. Le décodage n'est pas encore pris en charge. |
currentRouteSegmentVersion |
Uniquement en sortie. Indique la date de la dernière modification de l'itinéraire. Remarque: Ce champ est destiné uniquement à ê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 : |
currentRouteSegmentTraffic |
Uniquement en sortie. Indique les conditions de circulation le long du Remarque: Ce champ est destiné uniquement à être utilisé par le SDK Driver et le SDK Consumer. |
currentRouteSegmentTrafficVersion |
Uniquement en sortie. Indique la dernière fois que le Remarque: Ce champ est destiné uniquement à ê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 : |
currentRouteSegmentEndPoint |
Uniquement en sortie. Point de cheminement où se termine |
remainingDistanceMeters |
Uniquement en sortie. Distance en voiture restante dans le champ |
etaToFirstWaypoint |
Uniquement en sortie. Heure d'arrivée prévue au point de cheminement suivant (première entrée du champ Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
remainingTimeToFirstWaypoint |
Uniquement en sortie. Durée entre le retour des données de 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 Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
remainingWaypointsRouteVersion |
Uniquement en sortie. Indique la dernière fois que les éléments Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
numberOfPassengers |
Immuable. Indique le nombre de passagers pour ce trajet (le chauffeur 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 le |
view |
Sous-ensemble des champs "Trip" qui sont 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 |
Nouveau voyage. |
ENROUTE_TO_PICKUP |
Le chauffeur est en route 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 conducteur est arrivé à une destination intermédiaire et attend le passager. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Le chauffeur est en route vers une destination intermédiaire (et non au lieu de dépose). |
ENROUTE_TO_DROPOFF |
Le conducteur a pris en charge 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 partage de course. |
StopLocation
L'emplacement réel de l'arrêt (prise en charge/dépose).
Représentation JSON |
---|
{
"point": {
object ( |
Champs | |
---|---|
point |
Obligatoire. Indique le lieu réel. |
timestamp |
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 : |
stopTime |
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 : |
TripView
Sélecteur pour différents ensembles de champs de trajet dans une réponse trips.get
. Pour plus de contexte, reportez-vous à l'AIP-157. 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 d'assistance, nous recommandons aux clients de sélectionner un TripView autre que SDK . |
SDK |
Inclut des champs qui ne peuvent pas être interprétés ni gérés à l'aide de bibliothèques accessibles au public. |
JOURNEY_SHARING_V1S |
Les champs "Trip" sont renseignés pour le cas d'utilisation "Partage de trajet". Cette vue est destinée aux communications de serveur à serveur. |
Méthodes |
|
---|---|
|
Crée un trajet dans Fleet Engine et renvoie le nouveau trajet. |
|
Obtenir des informations sur un seul trajet |
|
Obtenez tous les trajets d'un véhicule spécifique. |
|
Met à jour les données du trajet. |