Fleet Tracking - On Demand Rides & Delivery (beta)

Classe FleetEngineVehicleLocationProvider

Classe google.maps.journeySharing.FleetEngineVehicleLocationProvider

Fournisseur de localisation de véhicule.

Cette classe étend PollingLocationProvider.

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

Interface FleetEngineVehicleLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Options pour le fournisseur de position du véhicule.
authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type:string
ID de projet du client à partir de Google Cloud Console.
activePolylineCustomization optional
Personnalisation appliquée à la polyligne active. Une polyligne active correspond à une partie du trajet que le véhicule emprunte actuellement.

Utilisez ce champ pour spécifier un style personnalisé (comme la couleur de la polyligne) et l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qu'il contient sont appliquées à la polyligne après sa création, en écrasant 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 de la polyligne. (Sur cette invocation, le paramètre isNew de l'objet des 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 position 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 trajet du véhicule.

Utilisez ce champ pour spécifier un style personnalisé (comme une icône de repère) et une interactivité (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qu'il contient sont appliquées au repère 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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (À cet appel, le paramètre isNew de l'objet des paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de position 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 de destination intermédiaires du trajet du véhicule.

Utilisez ce champ pour spécifier un style personnalisé (comme une icône de repère) et une interactivité (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qu'il contient sont appliquées au repère 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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (À cet appel, le paramètre isNew de l'objet des paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de position 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.

Utilisez ce champ pour spécifier un style personnalisé (comme une icône de repère) et une interactivité (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qu'il contient sont appliquées au repère 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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (À cet appel, le paramètre isNew de l'objet des paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de position 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
Durée minimale entre l'extraction des mises à jour de position, en millisecondes. Si l'extraction d'une mise à jour de position prend plus de pollingIntervalMillis, la mise à jour suivante ne commence pas tant que la mise à jour actuelle n'est pas terminée.

Définir cette valeur sur 0 désactive les mises à jour de position récurrentes. 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 de sondage sur une valeur inférieure non nulle, la valeur 5 000 est utilisée.
remainingPolylineCustomization optional
Personnalisation appliquée à la partie restante de la polyligne. Une polyligne restante correspond à une partie du trajet que le véhicule n'a pas encore commencé à parcourir.

Utilisez ce champ pour spécifier un style personnalisé (comme la couleur de la polyligne) et l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qu'il contient sont appliquées à la polyligne après sa création, en écrasant 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. (Sur cette invocation, le paramètre isNew de l'objet des 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 position 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 de vétusté de la position du véhicule. Si la dernière position du véhicule est antérieure à 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 à 0 ou défini sur Infinity, il sera ignoré et la position du véhicule ne sera pas considérée comme obsolète.
takenPolylineCustomization optional
Personnalisation appliquée à la polyligne enregistrée. Une polyligne prise correspond à une partie du trajet que le véhicule a déjà parcourue.

Utilisez ce champ pour spécifier un style personnalisé (comme la couleur de la polyligne) et l'interactivité (comme la gestion des clics).
  • Si un objet PolylineOptions est spécifié, les modifications qu'il contient sont appliquées à la polyligne après sa création, en écrasant 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 de la polyligne. (Sur cette invocation, le paramètre isNew de l'objet des 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 position 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 position. Si cet élément n'est pas spécifié, le fournisseur de position ne commence pas à suivre un véhicule. Utilisez FleetEngineVehicleLocationProvider.vehicleId pour définir l'ID et commencer le suivi.
vehicleMarkerCustomization optional
Personnalisation appliquée au repère du véhicule.

Utilisez ce champ pour spécifier un style personnalisé (comme une icône de repère) et une interactivité (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qu'il contient sont appliquées au repère 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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (À cet appel, le paramètre isNew de l'objet des paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de position 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 FleetEngineVehicleLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

Objet d'é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

Fournisseur de position de parc

Cette classe étend PollingLocationProvider.

Accédez-y en appelant const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Consultez la section Bibliothèques de l'API Maps JavaScript.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Paramètres:
Crée un fournisseur de position 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 de vétusté de la position du véhicule. Si la dernière position 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é une fois qu'une requête de mise à jour des données de Fleet Engine est terminée.
Hérité: ispollingchange

Interface FleetEngineFleetLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Options pour le fournisseur de position de la flotte.
authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type:string
ID de projet du client à partir de Google Cloud Console.
locationRestriction optional
Limites de latitude/longitude dans lesquelles suivre les véhicules immédiatement après l'instanciation du fournisseur de position. Si ce champ n'est pas défini, le fournisseur de position ne commence pas à suivre les véhicules. 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 de vétusté de la position du véhicule. Si la dernière position 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 Infinity, il sera ignoré et la position du véhicule ne sera pas considérée comme obsolète.
vehicleFilter optional
Type:string optional
Requête de filtre à appliquer lors de la récupération des véhicules. Ce filtre est transmis directement à Fleet Engine.

Pour connaître les formats acceptés, consultez ListVehiclesRequest.filter.

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

Utilisez ce champ pour spécifier un style personnalisé (comme l'icône du repère) et l'interactivité (comme la gestion des clics).
  • Si un objet MarkerOptions est spécifié, les modifications qu'il contient sont appliquées au repère 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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (À cet appel, le paramètre isNew de l'objet des paramètres de fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur de position 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 d'é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és par la requête. Non modifiable.