Fleet Tracking - Last Mile Fleet

Classe FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Fournisseur de localisation pour un véhicule de livraison.

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Paramètres :
Crée un fournisseur de localisation pour un véhicule de livraison Fleet Engine.
deliveryVehicleId
Type : string
ID du véhicule observé par ce fournisseur de localisation. Définissez ce champ pour suivre un véhicule.
shouldShowOutcomeLocations
Type : boolean optional
Vous pouvez éventuellement autoriser les utilisateurs à afficher l'emplacement du résultat de la tâche.
shouldShowTasks
Type : boolean optional
Autorisez éventuellement les utilisateurs à afficher les tâches récupérées.
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.
taskFilterOptions
Renvoie les options de filtre à appliquer lors de la récupération des tâches.
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)
Arguments :
Événement déclenché lorsqu'une requête de mise à jour des données Fleet Engine est terminée.
Hérité : ispollingchange

FleetEngineDeliveryVehicleLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions interface

Options du fournisseur de localisation du véhicule de livraison.
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 DeliveryVehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
deliveryVehicleId
facultatif
Type : string optional
ID du véhicule de livraison à 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 FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId pour définir l'ID et commencer le suivi.
deliveryVehicleMarkerCustomization
facultatif
Personnalisation appliquée au repère du véhicule de livraison.

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 DeliveryVehicleMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
plannedStopMarkerCustomization
facultatif
Personnalisation appliquée à un repère d'arrêt planifié.

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 PlannedStopMarkerCustomizationFunctionParams 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 DeliveryVehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
shouldShowOutcomeLocations
facultatif
Type : boolean optional
Valeur booléenne permettant d'afficher ou de masquer les emplacements des résultats pour les tâches récupérées.
shouldShowTasks
facultatif
Type : boolean optional
Valeur booléenne permettant d'afficher ou de masquer les tâches. Si vous définissez cette valeur sur "false", le point de terminaison ListTasks ne sera pas appelé pour récupérer les tâches. Seuls les prochains arrêts du véhicule seront affichés.
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 DeliveryVehiclePolylineCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
taskFilterOptions
facultatif
Options de filtre à appliquer lors de la récupération des tâches. Les options peuvent inclure un véhicule, une heure et un état de tâche spécifiques.
taskMarkerCustomization
facultatif
Type : (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personnalisation appliquée à un repère de tâche. Un repère de tâche s'affiche à l'emplacement prévu de chaque tâche attribuée au véhicule de livraison.

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 TaskMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
taskOutcomeMarkerCustomization
facultatif
Type : function(TaskMarkerCustomizationFunctionParams): void optional
Personnalisation appliquée à un repère de résultat de tâche. Un repère de résultat de tâche est affiché à l'emplacement réel du résultat de chaque tâche attribuée au véhicule de livraison.

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 TaskMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.

Interface FleetEngineTaskFilterOptions

google.maps.journeySharing.FleetEngineTaskFilterOptions interface

Options de filtrage des tâches dans le fournisseur d'emplacement du véhicule de livraison.
completionTimeFrom
facultatif
Type : Date optional
Limite inférieure exclusive pour l'heure d'achèvement de la tâche. Permet de filtrer les tâches terminées après l'heure spécifiée.
completionTimeTo
facultatif
Type : Date optional
Limite supérieure exclusive pour l'heure d'achèvement de la tâche. Permet de filtrer les tâches terminées avant l'heure spécifiée.
state
facultatif
Type : string optional
État de la tâche. Les valeurs valides sont OPEN ou CLOSED.

Interface FleetEngineDeliveryVehicleLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent interface

Objet d'événement transmis au gestionnaire d'événements lorsque l'événement FleetEngineDeliveryVehicleLocationProvider.update est déclenché.
completedVehicleJourneySegments
facultatif
Type : Array<VehicleJourneySegment> optional
Segments de trajet effectués par ce véhicule. Non modifiable.
deliveryVehicle
facultatif
Type : DeliveryVehicle optional
Structure de données du véhicule de livraison renvoyée par la mise à jour. Non modifiable.
tasks
facultatif
Type : Array<Task> optional
Liste des tâches effectuées par ce véhicule de livraison. Non modifiable.

FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Fournisseur de localisation pour la flotte de livraison.

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Paramètres :
Crée un fournisseur de localisation pour les véhicules suivis par Fleet Engine.
deliveryVehicleFilter
Type : string optional
Filtre appliqué lors de la récupération des véhicules de livraison.
locationRestriction
Limites dans lesquelles suivre les véhicules de livraison. Si aucune limite n'est définie, aucun véhicule de livraison ne sera suivi. Pour suivre tous les véhicules de livraison, 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.
Hérité : isPolling, pollingIntervalMillis
Hérité : addListener
update
function(event)
Arguments :
Événement déclenché lorsqu'une requête de mise à jour des données Fleet Engine est terminée.
Hérité : ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions interface

Options du fournisseur de localisation de la flotte de livraison.
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.
deliveryVehicleFilter
facultatif
Type : string optional
Requête de filtre à appliquer lors de la récupération des véhicules de livraison. Ce filtre est transmis directement à Fleet Engine.

Consultez ListDeliveryVehiclesRequest.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".
deliveryVehicleMarkerCustomization
facultatif
Type : function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
Personnalisation appliquée à un repère de véhicule de livraison.

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 DeliveryVehicleMarkerCustomizationFunctionParams pour obtenir la liste des paramètres fournis et leurs utilisations.
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 FleetEngineDeliveryFleetLocationProvider.locationRestriction pour définir les limites et commencer le suivi. Pour suivre tous les véhicules de livraison, 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.

Interface FleetEngineDeliveryFleetLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

Objet d'événement transmis au gestionnaire d'événements lorsque l'événement FleetEngineDeliveryFleetLocationProvider.update est déclenché.
deliveryVehicles
facultatif
Type : Array<DeliveryVehicle> optional
Liste des véhicules de livraison renvoyés par la requête. Non modifiable.