Fleet Tracking - On Demand Rides & Delivery (beta)

Classe FleetEngineVehicleLocationProvider

Classe google.maps.journeySharing.FleetEngineVehicleLocationProvider

Fournisseur de localisation de véhicules.

Cette classe étend PollingLocationProvider.

Pour y accéder, appelez const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Paramètres: 
Crée un fournisseur de localisation pour un véhicule Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Fonction de personnalisation des polylignes qui colore la polyligne active en fonction de sa vitesse de lecture. Spécifiez cette fonction en tant que FleetEngineVehicleLocationProviderOptions.activePolylineCustomization afin d'afficher une polyligne prenant en compte le trafic pour la polyligne active.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Paramètres: 
Return Value (Valeur renvoyée) : aucune
Fonction de personnalisation des polylignes qui colore la polyligne restante en fonction de sa vitesse de lecture. Spécifiez cette fonction en tant que FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization afin d'afficher une polyligne tenant compte du trafic pour la polyligne restante.
staleLocationThresholdMillis
Type:number
Ce champ est en lecture seule. Seuil applicable à l'obsolescence de l'emplacement du véhicule. Si la dernière position actualisée du véhicule est plus ancienne que ce seuil, le véhicule ne s'affiche pas.
vehicleId
Type:string
ID du véhicule observé par ce fournisseur de localisation. Définissez ce champ pour suivre un véhicule.
Hérité:isPolling, pollingIntervalMillis
Hérité: addListener
error
function(event)
Arguments: 
Événement déclenché lorsqu'une erreur est rencontrée par le fournisseur de services de localisation.
update
function(event)
Arguments: 
Événement déclenché lorsqu'une requête de mise à jour de données Fleet Engine est terminée.
Hérité: ispollingchange

FleetEngineVehicleLocationProviderOptions.

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Options pour le fournisseur de services de localisation de véhicules.
authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type:string
ID du projet du client provenant de la console Google Cloud.
activePolylineCustomization optional
Personnalisation appliquée à la polyligne active. Une polyligne active correspond à une partie de l'itinéraire que le véhicule traverse.

Ce champ vous permet de spécifier un style personnalisé (comme la couleur de la polyligne) et de l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qui y sont spécifiées sont appliquées à la polyligne après sa création, en remplaçant ses options par défaut, le cas échéant.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création de la polyligne. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque les coordonnées de la polyligne changent ou lorsque le fournisseur de localisation reçoit des données de Fleet Engine, que les données correspondant à cette polyligne aient changé ou non.

    Consultez VehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
destinationMarkerCustomization optional
Personnalisation appliquée au repère de destination du véhicule.

Ce champ vous permet de définir un style personnalisé (comme une icône de repère) et des éléments interactifs (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qui y sont spécifiées sont appliquées au repère une fois celui-ci créé, remplaçant ses options par défaut si elles existent.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création du repère, avant qu'elle ne soit ajoutée à la vue plan. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de services de localisation reçoit des données de Fleet Engine, que les données correspondant à ce repère aient changé ou non.

    Consultez VehicleWaypointMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
intermediateDestinationMarkerCustomization optional
Personnalisation appliquée aux repères intermédiaires de destination du trajet du véhicule.

Ce champ vous permet de définir un style personnalisé (comme une icône de repère) et des éléments interactifs (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qui y sont spécifiées sont appliquées au repère une fois celui-ci créé, remplaçant ses options par défaut si elles existent.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création du repère, avant qu'elle ne soit ajoutée à la vue plan. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de services de localisation reçoit des données de Fleet Engine, que les données correspondant à ce repère aient changé ou non.

    Consultez VehicleWaypointMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
originMarkerCustomization optional
Personnalisation appliquée au repère de départ du trajet du véhicule.

Ce champ vous permet de définir un style personnalisé (comme une icône de repère) et des éléments interactifs (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qui y sont spécifiées sont appliquées au repère une fois celui-ci créé, remplaçant ses options par défaut si elles existent.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création du repère, avant qu'elle ne soit ajoutée à la vue plan. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de services de localisation reçoit des données de Fleet Engine, que les données correspondant à ce repère aient changé ou non.

    Consultez VehicleWaypointMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
pollingIntervalMillis optional
Type:number optional
Délai minimal entre la récupération des mises à jour de la position (en millisecondes). Si la récupération d'une mise à jour de la position prend plus de pollingIntervalMillis, la mise à jour suivante n'est lancée que lorsque la mise à jour en cours est terminée.

Si vous définissez cette valeur sur 0, les mises à jour de la position sont désactivées de façon récurrente. Une nouvelle mise à jour de la position est récupérée si l'un des paramètres observés par le fournisseur de position change.

L'intervalle d'interrogation par défaut est de 5 000 millisecondes, l'intervalle minimal. Si vous définissez l'intervalle d'interrogation sur une valeur non nulle inférieure, la valeur 5 000 est utilisée.
remainingPolylineCustomization optional
Personnalisation appliquée à la polyligne restante. Une polyligne restante correspond à une partie de l'itinéraire que le véhicule n'a pas encore commencé à traverser.

Ce champ vous permet de spécifier un style personnalisé (comme la couleur de la polyligne) et de l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qui y sont spécifiées sont appliquées à la polyligne après sa création, en remplaçant ses options par défaut, le cas échéant.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création de la polyligne. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque les coordonnées de la polyligne changent ou lorsque le fournisseur de localisation reçoit des données de Fleet Engine, que les données correspondant à cette polyligne aient changé ou non.

    Consultez VehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
staleLocationThresholdMillis optional
Type:number optional
Seuil applicable à l'obsolescence de l'emplacement du véhicule. Si la dernière position actualisée du véhicule est plus ancienne que ce seuil, le véhicule ne s'affichera pas. La valeur par défaut est de 24 heures en millisecondes. Si le seuil est inférieur à 0 (ou à la valeur Infinity), il est ignoré et l'emplacement du véhicule n'est pas considéré comme obsolète.
takenPolylineCustomization optional
Personnalisation appliquée à la polyligne choisie. Une polyligne utilisée correspond à une partie de l'itinéraire que le véhicule a déjà traversé.

Ce champ vous permet de spécifier un style personnalisé (comme la couleur de la polyligne) et de l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qui y sont spécifiées sont appliquées à la polyligne après sa création, en remplaçant ses options par défaut, le cas échéant.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création de la polyligne. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque les coordonnées de la polyligne changent ou lorsque le fournisseur de localisation reçoit des données de Fleet Engine, que les données correspondant à cette polyligne aient changé ou non.

    Consultez VehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.
vehicleId optional
Type:string optional
ID du véhicule à suivre immédiatement après l'instanciation du fournisseur de localisation. S'il n'est pas spécifié, le fournisseur de services de localisation ne commence à suivre aucun véhicule. Utilisez FleetEngineVehicleLocationProvider.vehicleId pour définir l'identifiant et commencer le suivi.
vehicleMarkerCustomization optional
Personnalisation appliquée au repère du véhicule.

Ce champ vous permet de définir un style personnalisé (comme une icône de repère) et des éléments interactifs (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qui y sont spécifiées sont appliquées au repère une fois celui-ci créé, remplaçant ses options par défaut si elles existent.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création du repère, avant qu'elle ne soit ajoutée à la vue plan. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de services de localisation reçoit des données de Fleet Engine, que les données correspondant à ce repère aient changé ou non.

    Consultez VehicleMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.

FleetEngineVehicleLocationProviderUpdateEvent.

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

Objet événement transmis au gestionnaire d'événements lorsque l'événement FleetEngineVehicleLocationProvider.update est déclenché.
trips optional
Type:Array<Trip> optional
Liste des trajets effectués par ce véhicule. Non modifiable.
vehicle optional
Type:Vehicle optional
Structure des données du véhicule renvoyée par la mise à jour Non modifiable.

Classe FleetEngineFleetLocationProvider

Classe google.maps.journeySharing.FleetEngineFleetLocationProvider

Fleet Location Provider.

Cette classe étend PollingLocationProvider.

Pour y accéder, appelez const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Consultez Bibliothèques dans l'API Maps JavaScript.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Paramètres: 
Crée un fournisseur de localisation pour les véhicules suivis par Fleet Engine.
locationRestriction
Limites dans lesquelles suivre les véhicules. Si aucune limite n'est définie, aucun véhicule ne sera suivi. Pour suivre tous les véhicules, quel que soit leur emplacement, définissez des limites équivalentes à la surface de la Terre.
staleLocationThresholdMillis
Type:number
Ce champ est en lecture seule. Seuil applicable à l'obsolescence de l'emplacement du véhicule. Si la dernière position actualisée du véhicule est plus ancienne que ce seuil, le véhicule ne s'affiche pas.
vehicleFilter
Type:string optional
Filtre appliqué lors de la récupération des véhicules.
Hérité:isPolling, pollingIntervalMillis
Hérité: addListener
update
function(event)
Arguments: 
Événement déclenché lorsqu'une requête de mise à jour de données Fleet Engine est terminée.
Hérité: ispollingchange

Interface FleetEngineFleetLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Options pour le fournisseur de services de localisation de parc.
authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type:string
ID du projet du client provenant de la console Google Cloud.
locationRestriction optional
Limites de latitude/longitude dans lesquelles suivre les véhicules immédiatement après l'instanciation du fournisseur de localisation. Si cette règle n'est pas configurée, le fournisseur de localisation ne commence à suivre aucun véhicule. Utilisez FleetEngineFleetLocationProvider.locationRestriction pour définir les limites et commencer le suivi. Pour suivre tous les véhicules, quel que soit leur emplacement, définissez des limites équivalentes à la surface de la Terre.
staleLocationThresholdMillis optional
Type:number optional
Seuil applicable à l'obsolescence de l'emplacement du véhicule. Si la dernière position actualisée du véhicule est plus ancienne que ce seuil, le véhicule ne s'affiche pas. La valeur par défaut est de 24 heures en millisecondes. Si le seuil est inférieur à zéro ou défini sur Infinity, il est ignoré et la position du véhicule n'est pas considérée comme obsolète.
vehicleFilter optional
Type:string optional
Requête de filtre à appliquer lors de la récupération de véhicules. Ce filtre est transmis directement à Fleet Engine.

Consultez ListVehiclesRequest.filter pour connaître les formats acceptés.

Notez que les filtres d'attributs valides doivent comporter le préfixe "attributes". Exemples : attributes.x = "y" ou attributes."x y" = "z".
vehicleMarkerCustomization optional
Type:function(VehicleMarkerCustomizationFunctionParams): void optional
Personnalisation appliquée à un repère de véhicule.

Ce champ vous permet de définir un style personnalisé (comme une icône de repère) et des éléments interactifs (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qui y sont spécifiées sont appliquées au repère une fois celui-ci créé, remplaçant ses options par défaut si elles existent.
  • Si une fonction est spécifiée, elle est appelée une fois lors de la création du repère, avant qu'elle ne soit ajoutée à la vue plan. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de services de localisation reçoit des données de Fleet Engine, que les données correspondant à ce repère aient changé ou non.

    Consultez VehicleMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leur utilisation.

Interface FleetEngineFleetLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

Objet événement transmis au gestionnaire d'événements lorsque l'événement FleetEngineFleetLocationProvider.update est déclenché.
vehicles optional
Type:Array<Vehicle> optional
Liste des véhicules renvoyée par la requête. Non modifiable.