Fleet Engine Entities

Task.

Interface google.maps.journeySharing.Task

Détails d'une tâche renvoyée 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 ID de suivi.
remainingVehicleJourneySegments
Informations sur les segments qu'il reste à effectuer pour cette tâche.
status
Type:string
État d'exécution actuel de la tâche.
type
Type:string
Type de tâche (par exemple, une pause ou une expédition).
estimatedCompletionTime optional
Type:Date optional
Horodatage de l'heure d'achèvement estimée 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
Le résultat de la tâche.
outcomeLocation optional
Type:LatLngLiteral optional
Emplacement où la tâche a été effectuée (à partir du fournisseur).
outcomeLocationSource optional
Type:string optional
Setter de l'emplacement du résultat de la tâche ("PROVIDER" ou "LAST_VEHICLE_LOCATION")
outcomeTime optional
Type:Date optional
Code temporel du moment où le résultat de la tâche a été défini (à partir du fournisseur).
plannedLocation optional
Type:LatLngLiteral optional
L'emplacement où la tâche doit être effectuée.
targetTimeWindow optional
Type:TimeWindow optional
Période pendant laquelle la tâche doit être terminé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.

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 terminée.

Interface TaskTrackingInfo

Interface google.maps.journeySharing.TaskTrackingInfo

Détails d'un objet d'informations de suivi de tâche 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.
  • Vous devez saisir une chaîne Unicode valide.
  • La longueur ne doit pas dépasser 64 caractères.
  • Normalisée conformément au formulaire de normalisation Unicode C.
  • Ne doit contenir aucun des caractères ASCII suivants: "/", ":", "?", ""," ou "#".
estimatedArrivalTime optional
Type:Date optional
Heure d'arrivée estimée à l'emplacement de l'arrêt.
estimatedTaskCompletionTime optional
Type:Date optional
Estimation de la duré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 terminée.
remainingDrivingDistanceMeters optional
Type:number optional
Distance totale restante en mètres jusqu'au VehicleStop qui vous intéresse.
remainingStopCount optional
Type:number optional
Indique le nombre d'arrêts restants par le véhicule jusqu'à ce que l'arrêt de la tâche soit atteint, y compris celui de la tâche. Par exemple, si le prochain arrêt 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 reliés entre eux, forment une polyligne représentant l'itinéraire attendu du véhicule vers l'emplacement de la tâche.
state optional
Type:string optional
État d'exécution actuel de la tâche.
targetTimeWindow optional
Type:TimeWindow optional
Période pendant laquelle la tâche doit être terminé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 résultat de la tâche a été défini par le fournisseur.

Trip (Trajet)

Interface google.maps.journeySharing.Trip

Détails d'un trajet renvoyé par Fleet Engine.
name
Type:string
Il est au format "providers/{provider_id}/trips/{trip_id}". La valeur "trip_id" doit être un identifiant unique.
passengerCount
Type:number
Nombre de passagers pour ce trajet (le conducteur n'est pas inclus).
remainingWaypoints
Tableau de points de cheminement indiquant le trajet entre la position actuelle 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, SHARED ou EXCLUSIVE.
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é récupéré.
dropOffTime optional
Type:Date optional
Estimation de l'heure à laquelle les passagers vont être déposés ou de l'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
Estimation de l'heure à laquelle les passagers seront pris en charge ou de l'heure réelle à laquelle ils seront pris en charge.
plannedDropOffLocation optional
Type:LatLngLiteral optional
Lieu où le client indique qu'il sera déposé.
plannedPickupLocation optional
Type:LatLngLiteral optional
Lieu où le client indique qu'il sera récupéré.

DeliveryVehicle.

Interface google.maps.journeySharing.DeliveryVehicle

Détails d'un véhicule de livraison renvoyé par Fleet Engine.
attributes
Type:Object<string, string optional>
Attributs personnalisés du véhicule de livraison.
name
Type:string
Ce doit être au format "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". Delivery_vehicle_id doit être un identifiant unique.
navigationStatus
Type:string
État de la navigation actuelle du véhicule.
remainingDistanceMeters
Type:number
Distance en voiture restante dans la section d'itinéraire actuelle, en mètres.
remainingVehicleJourneySegments
Segments de trajet attribués à ce véhicule de livraison, à partir de sa dernière position enregistrée. Ce champ n'est renseigné que lorsque l'objet de données DeliveryVehicle est fourni via FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Type:LatLngLiteral optional
Point d'arrivée de la section de route actuelle.
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 pour le segment d'itinéraire actuel, en millisecondes.

Interface DeliveryVehicleStop

Interface google.maps.journeySharing.DeliveryVehicleStop

Type DeliveryVehicleStop
tasks
Liste des tâches à exécuter à 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'une DeliveryVehicleStop.

Pour y accéder, appelez const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
ARRIVED Arrivé à l'arrêt. Suppose 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 routage actif.
NEW Créé, mais pas de routage actif.
UNSPECIFIED Inconnu.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Type VehicleJourneySegment
drivingDistanceMeters optional
Type:number optional
Distance en mètres entre l'arrêt précédent et cet arrêt.
drivingDurationMillis optional
Type:number optional
Durée du trajet depuis l'arrêt précédent cet arrêt, en millisecondes.
path optional
Type:Array<LatLngLiteral> optional
Chemin entre l'arrêt précédent (ou la position actuelle du véhicule, si cet arrêt est le premier de la liste des arrêts) jusqu'à 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 le véhicule a reçu la mise à jour.

Interface VehicleWaypoint

Interface google.maps.journeySharing.VehicleWaypoint

VehicleWaypoint.
distanceMeters optional
Type:number optional
Distance en mètres entre le point de cheminement précédent (ou la position actuelle du véhicule, s'il est le premier de la liste des points de cheminement).
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 des points de cheminement) jusqu'à ce point de cheminement en millisecondes.
location optional
Type:LatLngLiteral optional
Emplacement du point de cheminement.
path optional
Type:Array<LatLngLiteral> optional
Chemin entre le point de cheminement précédent (ou la position actuelle du véhicule, s'il est le premier de la liste des points de cheminement) à celui-ci.
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épart et d'arrivée du segment par le biais de leurs index. Pour en savoir plus, consultez la définition de SpeedReadingInterval.

Interface Vehicle

Interface google.maps.journeySharing.Vehicle

Détails d'un véhicule retourné par Fleet Engine.
attributes
Type:Object<string, *>
Attributs de véhicule personnalisés.
name
Type:string
Il doit utiliser le format "providers/{provider_id}/vehicles/{vehicle_id}". La valeur "vehicle_id" doit être un identifiant unique.
navigationStatus
État de la navigation actuelle du véhicule.
remainingDistanceMeters
Type:number
Distance en voiture restante dans la section d'itinéraire actuelle, 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 la section de route actuelle.
currentRouteSegmentVersion optional
Type:Date optional
Heure à laquelle la section d'itinéraire actuelle a été définie.
currentTrips optional
Type:Array<string> optional
Liste des identifiants de trajets actuellement attribués à ce véhicule.
etaToFirstWaypoint optional
Type:Date optional
Heure d'arrivée prévue à la première entrée dans le champ des points de cheminement.
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 compatibles avec ce véhicule.
waypoints optional
Type:Array<TripWaypoint> optional
Points de cheminement restants attribués à ce véhicule.
waypointsVersion optional
Type:Date optional
Heure de la dernière mise à jour du champ des points de cheminement.

Constantes VehicleNavigationStatus

Constantes google.maps.journeySharing.VehicleNavigationStatus

État de navigation actuel d'un élément Vehicle.

Pour y accéder, appelez const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
ARRIVED_AT_DESTINATION Le véhicule se trouve dans un rayon d'environ 50 mètres autour de la destination.
ENROUTE_TO_DESTINATION La navigation détaillée est disponible et l'application Conducteur est passée en mode GUIDED_NAV.
NO_GUIDANCE La navigation de l'application Conducteur 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'une Vehicle.

Pour y accéder, appelez const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
OFFLINE Le véhicule n'accepte pas 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.

Pour y accéder, appelez const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
AUTO Une voiture.
TAXI Tout véhicule agissant en tant que taxi (généralement agréé ou réglementé).
TRUCK Un véhicule avec une grande capacité de stockage
TWO_WHEELER Moto, cyclomoteur 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.

Pour y accéder, appelez const {TripType} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
EXCLUSIVE Le trajet est réservé à un véhicule.
SHARED Un véhicule peut être partagé lors d'autres trajets.
UNKNOWN_TRIP_TYPE Type de trajet inconnu.

TripWaypoint

Interface google.maps.journeySharing.TripWaypoint

TripWaypoint.
distanceMeters optional
Type:number optional
Distance en mètres entre le point de cheminement précédent (ou la position actuelle du véhicule, s'il est le premier de la liste des points de cheminement).
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 des points de cheminement) jusqu'à ce point de cheminement en millisecondes.
location optional
Type:LatLng optional
Emplacement du point de cheminement.
path optional
Type:Array<LatLng> optional
Chemin entre l'arrêt précédent (ou la position actuelle du véhicule, si cet arrêt est le premier de la liste des arrêts) jusqu'à 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épart et d'arrivée du segment par le biais de leurs index. Pour en savoir plus, consultez la définition de SpeedReadingInterval.
tripId optional
Type:string optional
Trajet associé à ce point de cheminement.
waypointType optional
Type:WaypointType optional
Rôle de ce point de cheminement dans le trajet (prise en charge ou dépose, par exemple).

Constantes WaypointType

Constantes google.maps.journeySharing.WaypointType

Types de points de cheminement compatibles avec Vehicle.

Pour y accéder, appelez const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Points de cheminement pour les usagers
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Points de cheminement pour des destinations intermédiaires dans un trajet multidestination
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

Une 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 de trafic.

Pour y accéder, appelez const {Speed} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
NORMAL Vitesse normale, aucun ralentissement détecté
SLOW Ralentissement détecté, mais aucun embouteillage détecté.
TRAFFIC_JAM Embouteillage détecté.

Interface SpeedReadingInterval

Interface google.maps.journeySharing.SpeedReadingInterval

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