Fleet Tracking - On Demand Rides & Delivery

Classe FleetEngineVehicleLocationProvider

class google.maps.journeySharing.FleetEngineVehicleLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Fournisseur de localisation de véhicules.

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
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 :
Valeur renvoyée : aucune
Fonction de personnalisation des polylignes qui colore la polyligne active en fonction de sa 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 de polyligne qui colore la polyligne restante en fonction de la vitesse de lecture. Spécifiez cette fonction en tant que FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization pour afficher une polyligne tenant compte du trafic pour la polyligne restante.
staleLocationThresholdMillis
Type : number
Ce champ est en lecture seule. Seuil pour l'emplacement obsolète du véhicule. Si la dernière position mise à jour du véhicule est antérieure à 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é lorsque le fournisseur de localisation rencontre une erreur.
update
function(event)
Événement déclenché lorsqu'une requête de mise à jour des données Fleet Engine est terminée.
Hérité : ispollingchange

Interface FleetEngineVehicleLocationProviderOptions

interface google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Options du fournisseur de localisation du véhicule.

authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type : string
ID du projet du client dans la console Google Cloud.
activePolylineCustomization
facultatif
Personnalisation appliquée à la polyligne active. Une polyligne active correspond à une partie de l'itinéraire que le véhicule est en train de 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 si elles existent.
  • 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 la 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 leurs utilisations.
destinationMarkerCustomization
facultatif
Personnalisation appliquée au repère de destination du trajet du 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 é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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur 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 leurs utilisations.
intermediateDestinationMarkerCustomization
facultatif
Personnalisation appliquée aux repères de destination intermédiaire du trajet du 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 é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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur 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 leurs utilisations.
originMarkerCustomization
facultatif
Personnalisation appliquée au repère d'origine du trajet du 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 é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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur 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 leurs utilisations.
pollingIntervalMillis
facultatif
Type : number optional
Intervalle de temps minimal entre les récupérations des mises à jour de position, en millisecondes. Si la récupération d'une mise à jour de la position prend plus de pollingIntervalMillis, la mise à jour suivante ne démarre pas tant que la mise à jour actuelle n'est pas terminée.

Si vous définissez cette valeur sur 0, les notifications de position récurrentes sont désactivées. Une nouvelle notification de position est récupérée si l'un des paramètres observés par le fournisseur de localisation change.

L'intervalle d'interrogation par défaut est de 5 000 millisecondes, ce qui correspond à l'intervalle minimal. Si vous définissez l'intervalle d'interrogation sur une valeur inférieure non nulle, la valeur 5000 est utilisée.
remainingPolylineCustomization
facultatif
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é à 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 si elles existent.
  • 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 la 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 leurs utilisations.
staleLocationThresholdMillis
facultatif
Type : number optional
Seuil pour l'emplacement obsolète du véhicule. Si la dernière position mise à jour 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 s'il est défini sur Infinity, il sera ignoré et la position du véhicule ne sera pas considérée comme obsolète.
takenPolylineCustomization
facultatif
Personnalisation appliquée à la polyligne empruntée. Une polyligne empruntée correspond à une partie de l'itinéraire 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. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la 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 leurs utilisations.
vehicleId
facultatif
Type : string optional
ID du véhicule à suivre immédiatement après l'instanciation du fournisseur de localisation. Si aucun ID n'est spécifié, le fournisseur de localisation ne commence pas à suivre un véhicule. Utilisez FleetEngineVehicleLocationProvider.vehicleId pour définir l'ID et commencer le suivi.
vehicleMarkerCustomization
facultatif
Type : (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personnalisation appliquée au repère du 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 é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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur 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 leurs utilisations.

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
facultatif
Type : Array<Trip> optional
Liste des trajets effectués par ce véhicule. Non modifiable.
vehicle
facultatif
Type : Vehicle optional
Structure des données du véhicule renvoyée par la mise à jour. Non modifiable.

FleetEngineFleetLocationProvider

class google.maps.journeySharing.FleetEngineFleetLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Fournisseur de localisation de parc.

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
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 Terre entière.
staleLocationThresholdMillis
Type : number
Ce champ est en lecture seule. Seuil pour l'emplacement obsolète du véhicule. Si la dernière position mise à jour du véhicule est antérieure à 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)
Événement déclenché lorsqu'une requête de mise à jour des données Fleet Engine est terminée.
Hérité : ispollingchange

Interface FleetEngineFleetLocationProviderOptions

interface google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Options du fournisseur de localisation de la flotte.

authTokenFetcher
Fournit des jetons Web JSON pour authentifier le client auprès de Fleet Engine.
projectId
Type : string
ID du projet du client dans la console Google Cloud.
locationRestriction
facultatif
Limites de latitude/longitude dans lesquelles suivre les véhicules immédiatement après l'instanciation du fournisseur de localisation. S'il n'est pas défini, le fournisseur de localisation 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 Terre entière.
staleLocationThresholdMillis
facultatif
Type : number optional
Seuil pour l'emplacement obsolète du véhicule. Si la dernière position mise à jour 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 à zéro ou s'il est défini sur Infinity, il sera ignoré et la position du véhicule ne sera pas considérée comme obsolète.
vehicleFilter
facultatif
Type : string optional
Requête de filtre à appliquer lors de la récupération des véhicules. Ce filtre est transmis directement à Fleet Engine.

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

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
facultatif
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 é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 du repère, avant qu'il ne soit ajouté à la vue de la carte. (Lors de cet appel, le paramètre isNew de l'objet de paramètres de la fonction est défini sur true.) De plus, cette fonction est appelée lorsque le fournisseur 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 leurs utilisations.

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
facultatif
Type : Array<Vehicle> optional
Liste des véhicules renvoyés par la requête. Non modifiable.