Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

Delivery Vehicle Location Provider.

This class extends PollingLocationProvider.

Access by callingconst {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary( "journeySharing" ).SeeLibraries in the Maps JavaScript API.

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parameters:
Creates a new location provider for a Fleet Engine delivery vehicle.
deliveryVehicleId
Type:string
ID for the vehicle that this location provider observes. Set this field to track a vehicle.
shouldShowOutcomeLocations
Type:booleanoptional
Optionally allow users to display the task's outcome location.
shouldShowTasks
Type:booleanoptional
Optionally allow users to display fetched tasks.
staleLocationThresholdMillis
Type:number
This Field is read-only. Threshold for stale vehicle location. If the last updated location for the vehicle is older than this threshold, the vehicle will not be displayed.
taskFilterOptions
Returns the filter options to apply when fetching tasks.
Inherited: isPolling, pollingIntervalMillis
Inherited: addListener
error
function(event)
Arguments:
Event that is triggered when the location provider encounters an error.
update
function(event)
Event that is triggered when a Fleet Engine data update request has finished.
Inherited: ispollingchange

FleetEngineDeliveryVehicleLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions interface

Options for delivery vehicle location provider.

authTokenFetcher
Provides JSON Web Tokens for authenticating the client to Fleet Engine.
projectId
Type:string
The consumer's project ID from Google Cloud Console.
activePolylineCustomizationoptional
Customization applied to the active polyline. An active polyline corresponds to a portion of the route the vehicle is currently traversing through.

Use this field to specify custom styling (such as polyline color) and interactivity (such as click handling).
  • If aPolylineOptionsobject is specified, the changes specified in it are applied to the polyline after the polyline has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the polyline is created. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the polyline's coordinates change, or when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this polyline have changed.

    SeeDeliveryVehiclePolylineCustomizationFunctionParamsfor a list of supplied parameters and their uses.
deliveryVehicleIdoptional
Type:stringoptional
The delivery vehicle ID to track immediately after the location provider is instantiated. If not specified, the location provider does not start tracking any vehicle; useFleetEngineDeliveryVehicleLocationProvider.deliveryVehicleIdto set the ID and begin tracking.
deliveryVehicleMarkerCustomizationoptional
Customization applied to the delivery vehicle marker.

Use this field to specify custom styling (such as marker icon) and interactivity (such as click handling).
  • If aMarkerOptionsobject is specified, the changes specified in it are applied to the marker after the marker has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the marker is created, before it is added to the map view. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this marker have changed.

    SeeDeliveryVehicleMarkerCustomizationFunctionParamsfor a list of supplied parameters and their uses.
plannedStopMarkerCustomizationoptional
Customization applied to a planned stop marker.

Use this field to specify custom styling (such as marker icon) and interactivity (such as click handling).
  • If aMarkerOptionsobject is specified, the changes specified in it are applied to the marker after the marker has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the marker is created, before it is added to the map view. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this marker have changed.

    SeePlannedStopMarkerCustomizationFunctionParamsfor a list of supplied parameters and their uses.
pollingIntervalMillisoptional
Type:numberoptional
Minimum time between fetching location updates in milliseconds. If it takes longer thanpollingIntervalMillisto fetch a location update, the next location update is not started until the current one finishes.

Setting this value to 0 disables recurring location updates. A new location update is fetched if any of the parameters observed by the location provider changes.

The default polling interval is 5000 milliseconds, the minimum interval. If you set the polling interval to a lower non-zero value, 5000 is used.
remainingPolylineCustomizationoptional
Customization applied to the remaining polyline. A remaining polyline corresponds to a portion of the route the vehicle has not yet started traversing through.

Use this field to specify custom styling (such as polyline color) and interactivity (such as click handling).
  • If aPolylineOptionsobject is specified, the changes specified in it are applied to the polyline after the polyline has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the polyline is created. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the polyline's coordinates change, or when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this polyline have changed.

    SeeDeliveryVehiclePolylineCustomizationFunctionParamsfor a list of supplied parameters and their uses.
shouldShowOutcomeLocationsoptional
Type:booleanoptional
Boolean to show or hide outcome locations for the fetched tasks.
shouldShowTasksoptional
Type:booleanoptional
Boolean to show or hide tasks. Setting this to false will prevent the ListTasks endpoint from being called to fetch the tasks. Only the upcoming vehicle stops will be displayed.
staleLocationThresholdMillisoptional
Type:numberoptional
Threshold for stale vehicle location. If the last updated location for the vehicle is older this threshold, the vehicle will not be displayed. Defaults to 24 hours in milliseconds. If the threshold is less than 0, orInfinity,the threshold will be ignored and the vehicle location will not be considered stale.
takenPolylineCustomizationoptional
Customization applied to the taken polyline. A taken polyline corresponds to a portion of the route the vehicle has already traversed through.

Use this field to specify custom styling (such as polyline color) and interactivity (such as click handling).
  • If aPolylineOptionsobject is specified, the changes specified in it are applied to the polyline after the polyline has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the polyline is created. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the polyline's coordinates change, or when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this polyline have changed.

    SeeDeliveryVehiclePolylineCustomizationFunctionParamsfor a list of supplied parameters and their uses.
taskFilterOptionsoptional
Filter options to apply when fetching tasks. The options can include specific vehicle, time, and task status.
taskMarkerCustomizationoptional
Customization applied to a task marker. A task marker is rendered at the planned location of each task assigned to the delivery vehicle.

Use this field to specify custom styling (such as marker icon) and interactivity (such as click handling).
  • If aMarkerOptionsobject is specified, the changes specified in it are applied to the marker after the marker has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the marker is created, before it is added to the map view. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this marker have changed.

    SeeTaskMarkerCustomizationFunctionParamsfor a list of supplied parameters and their uses.
taskOutcomeMarkerCustomizationoptional
Type:function(TaskMarkerCustomizationFunctionParams): voidoptional
Customization applied to a task outcome marker. A task outcome marker is rendered at the actual outcome location of each task assigned to the delivery vehicle.

Use this field to specify custom styling (such as marker icon) and interactivity (such as click handling).
  • If aMarkerOptionsobject is specified, the changes specified in it are applied to the marker after the marker has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the marker is created, before it is added to the map view. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this marker have changed.

    SeeTaskMarkerCustomizationFunctionParamsfor a list of supplied parameters and their uses.

FleetEngineTaskFilterOptions interface

google.maps.journeySharing.FleetEngineTaskFilterOptions interface

Filtering options for tasks in the Delivery Vehicle Location Provider.

completionTimeFromoptional
Type:Dateoptional
Exclusive lower bound for the completion time of the task. Used to filter for tasks that were completed after the specified time.
completionTimeTooptional
Type:Dateoptional
Exclusive upper bound for the completion time of the task. Used to filter for tasks that were completed before the specified time.
stateoptional
Type:stringoptional
The state of the task. Valid values are OPEN or CLOSED.

FleetEngineDeliveryVehicleLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent interface

The event object passed to the event handler when theFleetEngineDeliveryVehicleLocationProvider.updateevent is triggered.

completedVehicleJourneySegmentsoptional
The journey segments that have been completed by this vehicle. Unmodifiable.
deliveryVehicleoptional
Type:DeliveryVehicleoptional
The delivery vehicle data structure returned by the update. Unmodifiable.
tasksoptional
Type:Array<Task>optional
The list of tasks served by this delivery vehicle. Unmodifiable.

FleetEngineDeliveryFleetLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class

Delivery Fleet Location Provider.

This class extends PollingLocationProvider.

Access by callingconst {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary( "journeySharing" ).SeeLibraries in the Maps JavaScript API.

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parameters:
Creates a new location provider for vehicles tracked by Fleet Engine.
deliveryVehicleFilter
Type:stringoptional
The filter applied when fetching the delivery vehicles.
locationRestriction
The bounds within which to track delivery vehicles. If no bounds are set, no delivery vehicles will be tracked. To track all delivery vehicles regardless of location, set bounds equivalent to the entire earth.
staleLocationThresholdMillis
Type:number
This Field is read-only. Threshold for stale vehicle location. If the last updated location for the vehicle is older than this threshold, the vehicle will not be displayed.
Inherited: isPolling, pollingIntervalMillis
Inherited: addListener
update
function(event)
Event that is triggered when a Fleet Engine data update request has finished.
Inherited: ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions interface

Options for delivery fleet location provider.

authTokenFetcher
Provides JSON Web Tokens for authenticating the client to Fleet Engine.
projectId
Type:string
The consumer's project ID from Google Cloud Console.
deliveryVehicleFilteroptional
Type:stringoptional
A filter query to apply when fetching delivery vehicles. This filter is passed directly to Fleet Engine.

SeeListDeliveryVehiclesRequest.filterfor supported formats.

Note that valid filters for attributes must have the "attributes" prefix. For example,attributes.x = "y"orattributes. "x y" = "z".
deliveryVehicleMarkerCustomizationoptional
Customization applied to a delivery vehicle marker.

Use this field to specify custom styling (such as marker icon) and interactivity (such as click handling).
  • If aMarkerOptionsobject is specified, the changes specified in it are applied to the marker after the marker has been created, overwriting its default options if they exist.
  • If a function is specified, it is invoked once when the marker is created, before it is added to the map view. (On this invocation, theisNewparameter in the function parameters object is set totrue.) Additionally, this function is invoked when the location provider receives data from Fleet Engine, regardless of whether the data corresponding to this marker have changed.

    SeeDeliveryVehicleMarkerCustomizationFunctionParamsfor a list of supplied parameters and their uses.
locationRestrictionoptional
The latitude/longitude bounds within which to track vehicles immediately after the location provider is instantiated. If not set, the location provider does not start tracking any vehicles; useFleetEngineDeliveryFleetLocationProvider.locationRestrictionto set the bounds and begin tracking. To track all delivery vehicles regardless of location, set bounds equivalent to the entire earth.
staleLocationThresholdMillisoptional
Type:numberoptional
Threshold for stale vehicle location. If the last updated location for the vehicle is older this threshold, the vehicle will not be displayed. Defaults to 24 hours in milliseconds. If the threshold is less than zero, orInfinity,the threshold will be ignored and the vehicle location will not be considered stale.

FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent interface

The event object passed to the event handler when theFleetEngineDeliveryFleetLocationProvider.updateevent is triggered.

deliveryVehiclesoptional
Type:Array<DeliveryVehicle>optional
The list of delivery vehicles returned by the query. Unmodifiable.