Fleet Engine Entities

Interface Task

Interface google.maps.journeySharing.Task

Détails d'une tâche renvoyés par Fleet Engine.
attributes
Type:Object<string, *>
Attributs attribués à la tâche.
name
Type:string
Nom de la tâche au format "providers/{provider_id}/tasks/{task_id}". Le champ "task_id" doit être un identifiant unique et non un ID de suivi. Pour stocker l'ID de suivi d'un envoi, utilisez le champ tracking_id. Plusieurs tâches peuvent avoir le même identifiant de suivi.
remainingVehicleJourneySegments
Informations sur les segments restants à terminer pour cette tâche.
status
Type:string
État actuel de l'exécution de la tâche.
type
Type:string
Type de tâche (par exemple, pause ou expédition).
estimatedCompletionTime optional
Type:Date optional
Code temporel de la durée estimée d'exécution de la tâche.
latestVehicleLocationUpdate optional
Type:VehicleLocationUpdate optional
Informations spécifiques à la dernière mise à jour de la position.
outcome optional
Type:string optional
Résultat de la tâche.
outcomeLocation optional
Type:LatLngLiteral optional
Emplacement où la tâche a été effectuée (fournisseur).
outcomeLocationSource optional
Type:string optional
Définisseur de l'emplacement du résultat de la tâche ('PROVIDER' ou "LAST_VEHICLE_LOCATION").
outcomeTime optional
Type:Date optional
Code temporel de définition du résultat de la tâche (fourni par le fournisseur).
plannedLocation optional
Type:LatLngLiteral optional
Emplacement où la tâche doit être effectuée.
targetTimeWindow optional
Type:TimeWindow optional
Période pendant laquelle la tâche doit être effectuée.
trackingId optional
Type:string optional
ID de suivi de l'envoi.
vehicleId optional
Type:string optional
Identifiant du véhicule effectuant cette tâche.

Interface TaskInfo

Interface google.maps.journeySharing.TaskInfo

Type TaskInfo, utilisé par DeliveryVehicleStop.
extraDurationMillis optional
Type:number optional
Temps supplémentaire nécessaire pour effectuer la tâche, en millisecondes.
id optional
Type:string optional
ID de la tâche.
targetTimeWindow optional
Type:TimeWindow optional
Période pendant laquelle la tâche doit être effectuée.

Interface TaskTrackingInfo

Interface google.maps.journeySharing.TaskTrackingInfo

Détails d'un objet d'informations de suivi des tâches renvoyé par Fleet Engine.
attributes
Type:Object<string, *>
Attributs attribués à la tâche.
name
Type:string
Nom au format "providers/{provider_id}/taskTrackingInfo/{tracking_id}", où tracking_id représente l'ID de suivi.
trackingId
Type:string
ID de suivi d'une tâche.
  • Doit être une chaîne de caractères Unicode valide.
  • Limité à 64 caractères maximum.
  • Normalisé selon la forme de normalisation Unicode C.
  • Ne doit pas contenir l'un des caractères ASCII suivants: '/', ':', '?', ',' ou '#'.
estimatedArrivalTime optional
Type:Date optional
Heure d'arrivée estimée à l'arrêt.
estimatedTaskCompletionTime optional
Type:Date optional
Durée estimée d'exécution d'une tâche.
latestVehicleLocationUpdate optional
Type:VehicleLocationUpdate optional
Informations spécifiques à la dernière mise à jour de la position.
plannedLocation optional
Type:LatLng optional
Emplacement où la tâche sera effectuée.
remainingDrivingDistanceMeters optional
Type:number optional
Distance totale restante en mètres jusqu'au VehicleStop d'intérêt.
remainingStopCount optional
Type:number optional
Indique le nombre d'arrêts restants du véhicule jusqu'à l'arrêt de la tâche, y compris l'arrêt de la tâche. Par exemple, si l'arrêt suivant du véhicule est l'arrêt de la tâche, la valeur est 1.
routePolylinePoints optional
Type:Array<LatLng> optional
Liste de points qui, lorsqu'ils sont connectés, forment une polyligne de l'itinéraire prévu du véhicule vers l'emplacement de cette tâche.
state optional
Type:string optional
État actuel de l'exécution de la tâche.
targetTimeWindow optional
Type:TimeWindow optional
Période pendant laquelle la tâche doit être effectuée.
taskOutcome optional
Type:string optional
Résultat de la tentative d'exécution d'une tâche.
taskOutcomeTime optional
Type:Date optional
Heure à laquelle le fournisseur a défini le résultat de la tâche.

Interface Trip (Trajet)

Interface google.maps.journeySharing.Trip

Détails d'un trajet renvoyés par Fleet Engine.
name
Type:string
Au format "providers/{provider_id}/trips/{trip_id}". Le champ "trip_id" doit être un identifiant unique.
passengerCount
Type:number
Nombre de passagers sur ce trajet (ne comprend pas le conducteur).
remainingWaypoints
Tableau de points de cheminement indiquant le chemin entre l'emplacement actuel et le point de dépôt.
status
Type:string
État actuel du trajet. Les valeurs possibles sont UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE ou CANCELED.
type
Type:string
Type de trajet. Les valeurs possibles sont UNKNOWN_TRIP_TYPE, PARTAGÉ ou EXCLUSIF.
vehicleId
Type:string
Identifiant du véhicule effectuant ce trajet.
actualDropOffLocation optional
Type:LatLngLiteral optional
Lieu où le client a été déposé.
actualPickupLocation optional
Type:LatLngLiteral optional
Lieu où le client a été pris en charge.
dropOffTime optional
Type:Date optional
Heure estimée à laquelle les passagers seront déposés ou heure réelle à laquelle ils ont été déposés.
latestVehicleLocationUpdate optional
Type:VehicleLocationUpdate optional
Informations spécifiques à la dernière mise à jour de la position.
pickupTime optional
Type:Date optional
Heure estimée à laquelle les passagers seront pris en charge ou heure réelle à laquelle ils ont été pris en charge.
plannedDropOffLocation optional
Type:LatLngLiteral optional
Lieu où le client indique qu'il souhaite être déposé.
plannedPickupLocation optional
Type:LatLngLiteral optional
Lieu où le client indique qu'il viendra récupérer son colis.

Interface DeliveryVehicle

Interface google.maps.journeySharing.DeliveryVehicle

Détails d'un véhicule de livraison renvoyés par Fleet Engine.
attributes
Type:Object<string, string optional>
Attributs du véhicule de livraison personnalisés
name
Type:string
Au format "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". L'identifiant de véhicule de livraison doit être unique.
navigationStatus
Type:string
État de navigation actuel du véhicule.
remainingDistanceMeters
Type:number
Distance restante à parcourir en voiture sur le segment d'itinéraire actuel, en mètres.
remainingVehicleJourneySegments
Segments de trajet attribués à ce véhicule de livraison, en commençant par son dernier emplacement signalé. Ce champ n'est renseigné que lorsque l'objet de données DeliveryVehicle est fourni via FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Type:LatLngLiteral optional
Emplacement où se termine le segment de trajet actuel.
latestVehicleLocationUpdate optional
Type:VehicleLocationUpdate optional
Dernière position signalée du véhicule de livraison.
remainingDurationMillis optional
Type:number optional
Durée restante du trajet sur le segment d'itinéraire actuel, en millisecondes.

Interface DeliveryVehicleStop

Interface google.maps.journeySharing.DeliveryVehicleStop

Type DeliveryVehicleStop
tasks
Liste des tâches à effectuer à cet arrêt.
  • id: ID de la tâche.
  • extraDurationMillis: temps supplémentaire nécessaire pour effectuer la tâche, en millisecondes.
plannedLocation optional
Type:LatLngLiteral optional
Emplacement de l'arrêt.
state optional
État de l'arrêt.

Constantes DeliveryVehicleStopState

Constantes google.maps.journeySharing.DeliveryVehicleStopState

État actuel d'un DeliveryVehicleStop.

Accédez-y en appelant const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
ARRIVED Arrivé à l'arrêt. Part du principe que lorsque le véhicule se dirige vers l'arrêt suivant, tous les arrêts précédents ont été effectués.
ENROUTE Attribué et en cours de routage.
NEW Créé, mais pas de routage actif.
UNSPECIFIED Inconnu.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Type VehicleJourneySegment
drivingDistanceMeters optional
Type:number optional
Distance parcourue entre l'arrêt précédent et cet arrêt, en mètres.
drivingDurationMillis optional
Type:number optional
Temps de trajet entre l'arrêt précédent et cet arrêt, en millisecondes.
path optional
Type:Array<LatLngLiteral> optional
Trajet entre l'arrêt précédent (ou l'emplacement actuel du véhicule, si cet arrêt est le premier de la liste) et cet arrêt.
stop optional
Type:DeliveryVehicleStop optional
Informations sur l'arrêt.

Interface VehicleLocationUpdate

Interface google.maps.journeySharing.VehicleLocationUpdate

Type VehicleLocationUpdate
heading optional
Type:number optional
Titre de la mise à jour. 0 correspond au nord et 180 au sud.
location optional
Type:LatLngLiteral|LatLng optional
Emplacement de la mise à jour.
speedKilometersPerHour optional
Type:number optional
Vitesse en kilomètres par heure.
time optional
Type:Date optional
Heure à laquelle cette mise à jour a été reçue du véhicule.

Interface VehicleWaypoint

Interface google.maps.journeySharing.VehicleWaypoint

Type de point de cheminement VehicleWaypoint.
distanceMeters optional
Type:number optional
Distance du trajet entre le point de cheminement précédent (ou l'emplacement actuel du véhicule, si ce point de cheminement est le premier de la liste) et ce point de cheminement, en mètres.
durationMillis optional
Type:number optional
Temps de trajet entre le point de cheminement précédent (ou la position actuelle du véhicule, si ce point de cheminement est le premier de la liste) et ce point de cheminement, en millisecondes.
location optional
Type:LatLngLiteral optional
Emplacement du point de cheminement.
path optional
Type:Array<LatLngLiteral> optional
Trajet entre le point de cheminement précédent (ou l'emplacement actuel du véhicule, si ce point de cheminement est le premier de la liste) et ce point de cheminement.
speedReadingIntervals optional
Liste des vitesses de circulation sur le trajet entre le point de cheminement précédent (ou l'emplacement du véhicule) et le point de cheminement actuel. Chaque intervalle de la liste décrit le trafic sur un segment contigu du chemin. L'intervalle définit les points de début et de fin du segment via leurs indices. Pour en savoir plus, consultez la définition de SpeedReadingInterval.

Interface Véhicule

Interface google.maps.journeySharing.Vehicle

Détails d'un véhicule renvoyés par Fleet Engine.
attributes
Type:Object<string, *>
Attributs de véhicule personnalisés
name
Type:string
Au format "providers/{provider_id}/vehicles/{vehicle_id}". L'identifiant vehicle_id doit être unique.
navigationStatus
État de navigation actuel du véhicule.
remainingDistanceMeters
Type:number
Distance restante à parcourir en voiture sur le segment d'itinéraire actuel, en mètres.
vehicleState
État du véhicule.
vehicleType
Type de ce véhicule.
currentRouteSegmentEndPoint optional
Type:TripWaypoint optional
Point de cheminement où se termine le segment de route actuel.
currentRouteSegmentVersion optional
Type:Date optional
Heure à laquelle le segment de route actuel a été défini.
currentTrips optional
Type:Array<string> optional
Liste des ID de trajets actuellement attribués à ce véhicule.
etaToFirstWaypoint optional
Type:Date optional
Heure d'arrivée estimée au premier point d'intérêt du champ "Points de repère".
latestLocation optional
Type:VehicleLocationUpdate optional
Dernière position signalée du véhicule.
maximumCapacity optional
Type:number optional
Nombre total de passagers que ce véhicule peut transporter. Le conducteur n'est pas pris en compte dans cette valeur.
supportedTripTypes optional
Type:Array<TripType> optional
Types de trajets acceptés par ce véhicule.
waypoints optional
Type:Array<TripWaypoint> optional
Les points de cheminement restants attribués à ce véhicule.
waypointsVersion optional
Type:Date optional
Dernière fois que le champ "Points de repère" a été mis à jour.

Constantes VehicleNavigationStatus

Constantes google.maps.journeySharing.VehicleNavigationStatus

État de navigation actuel d'un Vehicle.

Accédez-y en appelant const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
ARRIVED_AT_DESTINATION Le véhicule se trouve à environ 50 m de la destination.
ENROUTE_TO_DESTINATION La navigation détaillée est disponible et la navigation dans l'application Driver est passée en mode GUIDED_NAV.
NO_GUIDANCE La navigation de l'application Driver est en mode FREE_NAV.
OFF_ROUTE Le véhicule a quitté l'itinéraire suggéré.
UNKNOWN_NAVIGATION_STATUS État de navigation non spécifié.

Constantes VehicleState

Constantes google.maps.journeySharing.VehicleState

État actuel d'un Vehicle.

Accédez-y en appelant const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
OFFLINE Le véhicule n'accepte plus de nouveaux trajets.
ONLINE Le véhicule accepte de nouveaux trajets.
UNKNOWN_VEHICLE_STATE État du véhicule inconnu.

Constantes VehicleType

Constantes google.maps.journeySharing.VehicleType

Type de propriété Vehicle.

Accédez-y en appelant const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
AUTO Une automobile.
TAXI Tout véhicule qui fait office de taxi (généralement sous licence ou réglementé).
TRUCK Un véhicule offrant une grande capacité de stockage.
TWO_WHEELER Moto, mobylette ou autre véhicule à deux roues
UNKNOWN Type de véhicule inconnu.

Constantes TripType

Constantes google.maps.journeySharing.TripType

Types de trajets compatibles avec un Vehicle.

Accédez-y en appelant const {TripType} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
EXCLUSIVE Le trajet est réservé à un véhicule.
SHARED Le trajet peut partager un véhicule avec d'autres trajets.
UNKNOWN_TRIP_TYPE Type de trajet inconnu.

Interface TripWaypoint

Interface google.maps.journeySharing.TripWaypoint

Type de point de repère de trajet.
distanceMeters optional
Type:number optional
Distance du trajet entre le point de cheminement précédent (ou l'emplacement actuel du véhicule, si ce point de cheminement est le premier de la liste) et ce point de cheminement, en mètres.
durationMillis optional
Type:number optional
Temps de trajet entre le point de cheminement précédent (ou la position actuelle du véhicule, si ce point de cheminement est le premier de la liste) et ce point de cheminement, en millisecondes.
location optional
Type:LatLng optional
Emplacement du point de cheminement.
path optional
Type:Array<LatLng> optional
Trajet entre l'arrêt précédent (ou l'emplacement actuel du véhicule, si cet arrêt est le premier de la liste) et cet arrêt.
speedReadingIntervals optional
Liste des vitesses de circulation sur le trajet entre le point de cheminement précédent (ou l'emplacement du véhicule) et le point de cheminement actuel. Chaque intervalle de la liste décrit le trafic sur un segment contigu du chemin. L'intervalle définit les points de début et de fin du segment via leurs indices. Pour en savoir plus, consultez la définition de SpeedReadingInterval.
tripId optional
Type:string optional
Trajet associé à ce point de repère.
waypointType optional
Type:WaypointType optional
Rôle de ce point de repère dans ce trajet, par exemple "Ramassage" ou "Dépose".

Constantes WaypointType

Constantes google.maps.journeySharing.WaypointType

Types de points de cheminement compatibles avec Vehicle.

Accédez-y en appelant const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Points de cheminement pour déposer des passagers
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Points de cheminement pour les destinations intermédiaires d'un trajet multi-destination
PICKUP_WAYPOINT_TYPE Points de cheminement pour la prise en charge des passagers
UNKNOWN_WAYPOINT_TYPE Type de point de cheminement inconnu.

Interface TimeWindow

Interface google.maps.journeySharing.TimeWindow

Période.
endTime
Type:Date
Heure de fin de la période (incluse).
startTime
Type:Date
Heure de début de la période (incluse).

Constantes de vitesse

Constantes google.maps.journeySharing.Speed

Classification de la vitesse de la polyligne en fonction des données sur le trafic.

Accédez-y en appelant const {Speed} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
NORMAL Vitesse normale, aucun ralentissement n'est détecté.
SLOW Ralentissement détecté, mais aucun embouteillage n'est formé.
TRAFFIC_JAM Embouteillage détecté.

Interface SpeedReadingInterval

Interface google.maps.journeySharing.SpeedReadingInterval

Indicateur de densité du trafic sur un segment de parcours contigu. L'intervalle définit les points de début et de fin du segment via leurs indices.
endPolylinePointIndex
Type:number
Index basé sur zéro du point de fin de l'intervalle dans le chemin.
speed
Type:Speed
Vitesse du trafic pendant cet intervalle.
startPolylinePointIndex
Type:number
Index basé sur zéro du point de départ de l'intervalle dans le chemin d'accès.