Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

Delivery Vehicle Location Provider.

This class extends PollingLocationProvider.

Access by calling const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). See Libraries 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:  boolean optional
Optionally allow users to display the task's outcome location.
shouldShowTasks
Type:  boolean optional
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.
activePolylineCustomization optional
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 a PolylineOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See DeliveryVehiclePolylineCustomizationFunctionParams for a list of supplied parameters and their uses.
deliveryVehicleId optional
Type:  string optional
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; use FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId to set the ID and begin tracking.
deliveryVehicleMarkerCustomization optional
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 a MarkerOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See DeliveryVehicleMarkerCustomizationFunctionParams for a list of supplied parameters and their uses.
plannedStopMarkerCustomization optional
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 a MarkerOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See PlannedStopMarkerCustomizationFunctionParams for a list of supplied parameters and their uses.
pollingIntervalMillis optional
Type:  number optional
Minimum time between fetching location updates in milliseconds. If it takes longer than pollingIntervalMillis to 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.
remainingPolylineCustomization optional
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 a PolylineOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See DeliveryVehiclePolylineCustomizationFunctionParams for a list of supplied parameters and their uses.
shouldShowOutcomeLocations optional
Type:  boolean optional
Boolean to show or hide outcome locations for the fetched tasks.
shouldShowTasks optional
Type:  boolean optional
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.
staleLocationThresholdMillis optional
Type:  number optional
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, or Infinity, the threshold will be ignored and the vehicle location will not be considered stale.
takenPolylineCustomization optional
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 a PolylineOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See DeliveryVehiclePolylineCustomizationFunctionParams for a list of supplied parameters and their uses.
taskFilterOptions optional
Filter options to apply when fetching tasks. The options can include specific vehicle, time, and task status.
taskMarkerCustomization optional
Type:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
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 a MarkerOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See TaskMarkerCustomizationFunctionParams for a list of supplied parameters and their uses.
taskOutcomeMarkerCustomization optional
Type:  function(TaskMarkerCustomizationFunctionParams): void optional
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 a MarkerOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See TaskMarkerCustomizationFunctionParams for 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.

completionTimeFrom optional
Type:  Date optional
Exclusive lower bound for the completion time of the task. Used to filter for tasks that were completed after the specified time.
completionTimeTo optional
Type:  Date optional
Exclusive upper bound for the completion time of the task. Used to filter for tasks that were completed before the specified time.
state optional
Type:  string optional
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 the FleetEngineDeliveryVehicleLocationProvider.update event is triggered.

completedVehicleJourneySegments optional
Type:  Array<VehicleJourneySegment> optional
The journey segments that have been completed by this vehicle. Unmodifiable.
deliveryVehicle optional
Type:  DeliveryVehicle optional
The delivery vehicle data structure returned by the update. Unmodifiable.
tasks optional
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 calling const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). See Libraries in the Maps JavaScript API.

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parameters: 
Creates a new location provider for vehicles tracked by Fleet Engine.
deliveryVehicleFilter
Type:  string optional
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.
deliveryVehicleFilter optional
Type:  string optional
A filter query to apply when fetching delivery vehicles. This filter is passed directly to Fleet Engine.

See ListDeliveryVehiclesRequest.filter for supported formats.

Note that valid filters for attributes must have the "attributes" prefix. For example, attributes.x = "y" or attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
Type:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
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 a MarkerOptions object 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, the isNew parameter in the function parameters object is set to true.) 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.

    See DeliveryVehicleMarkerCustomizationFunctionParams for a list of supplied parameters and their uses.
locationRestriction optional
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; use FleetEngineDeliveryFleetLocationProvider.locationRestriction to set the bounds and begin tracking. To track all delivery vehicles regardless of location, set bounds equivalent to the entire earth.
staleLocationThresholdMillis optional
Type:  number optional
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, or Infinity, 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 the FleetEngineDeliveryFleetLocationProvider.update event is triggered.

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