Fleet Tracking - Last Mile Fleet

Clase FleetEngineDeliveryVehicleLocationProvider.

Clase google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider

Proveedor de ubicación de vehículos de reparto.

Esta clase extiende PollingLocationProvider.

Para acceder, llama a const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parámetros: 
Crea un nuevo proveedor de ubicación para un vehículo de entrega de Fleet Engine.
deliveryVehicleId
Tipo:  string
Es el ID del vehículo que observa este proveedor de ubicación. Establece este campo para hacer el seguimiento de un vehículo.
shouldShowOutcomeLocations
Tipo:  boolean optional
De manera opcional, permite que los usuarios muestren la ubicación del resultado de la tarea.
shouldShowTasks
Tipo:  boolean optional
De forma opcional, permite que los usuarios muestren las tareas recuperadas.
staleLocationThresholdMillis
Tipo:  number
Este campo es de solo lectura. Umbral de la ubicación de un vehículo inactivo. Si la última ubicación actualizada del vehículo es anterior a este umbral, no se mostrará el vehículo.
taskFilterOptions
Muestra las opciones de filtro que se aplicarán cuando se recuperen tareas.
Heredado: isPolling, pollingIntervalMillis
Heredado: addListener
error
function(event)
Argumentos: 
Evento que se activa cuando el proveedor de ubicación encuentra un error
update
function(event)
Evento que se activa cuando finaliza una solicitud de actualización de datos de Fleet Engine.
Heredado: ispollingchange

Interfaz de FleetEngineDeliveryVehicleLocationProviderOptions

Interfaz de google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

Opciones del proveedor de ubicación del vehículo de entrega.

authTokenFetcher
Proporciona tokens web JSON para autenticar al cliente en Fleet Engine.
projectId
Tipo:  string
El ID del proyecto del consumidor de la consola de Google Cloud.
activePolylineCustomization optional
Personalización aplicada a la polilínea activa. Una polilínea activa corresponde a una parte de la ruta que el vehículo atraviesa actualmente.

Usa este campo para especificar un estilo personalizado (como el color de polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios especificados se aplicarán a la polilínea después de crearla y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, se invoca una vez cuando se crea la polilínea. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, se invoca esta función cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, sin importar si cambiaron los datos correspondientes a esta polilínea.

    Consulta DeliveryVehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
deliveryVehicleId optional
Tipo:  string optional
El ID del vehículo de entrega que se debe rastrear inmediatamente después de que se crea una instancia del proveedor de ubicación. Si no se especifica, el proveedor de ubicación no comenzará a realizar el seguimiento de ningún vehículo. Usa FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId para establecer el ID y comenzar el seguimiento.
deliveryVehicleMarkerCustomization optional
Se aplicó una personalización al marcador del vehículo de entrega.

Usa este campo para especificar un estilo personalizado (como el ícono de marcador) y la interactividad (como el control de clics).
  • Si se especifica un objeto MarkerOptions, los cambios especificados se aplicarán al marcador después de que se cree y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, esta se invoca una vez que se crea el marcador, antes de agregarla a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, esta función se invoca cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si los datos correspondientes a este marcador cambiaron.

    Consulta DeliveryVehicleMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
plannedStopMarkerCustomization optional
Personalización aplicada a un marcador de parada planificado.

Usa este campo para especificar un estilo personalizado (como el ícono de marcador) y la interactividad (como el control de clics).
  • Si se especifica un objeto MarkerOptions, los cambios especificados se aplicarán al marcador después de que se cree y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, esta se invoca una vez que se crea el marcador, antes de agregarla a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, esta función se invoca cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si los datos correspondientes a este marcador cambiaron.

    Consulta PlannedStopMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
pollingIntervalMillis optional
Tipo:  number optional
Tiempo mínimo entre la recuperación de las actualizaciones de ubicación en milisegundos. Si tarda más de pollingIntervalMillis en recuperar una actualización de ubicación, no se iniciará la próxima actualización de ubicación hasta que finalice la actual.

Si estableces este valor en 0, se inhabilitarán las actualizaciones de ubicación recurrentes. Se recupera una nueva actualización de ubicación si cambia alguno de los parámetros que observa el proveedor de ubicación.

El intervalo de sondeo predeterminado es de 5,000 milisegundos, que es el intervalo mínimo. Si estableces el intervalo de sondeo en un valor inferior que no sea cero, se usa 5,000.
remainingPolylineCustomization optional
Personalización de la polilínea restante Una polilínea restante corresponde a una parte de la ruta que el vehículo aún no ha comenzado a recorrer.

Usa este campo para especificar un estilo personalizado (como el color de polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios especificados se aplicarán a la polilínea después de crearla y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, se invoca una vez cuando se crea la polilínea. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, se invoca esta función cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, sin importar si cambiaron los datos correspondientes a esta polilínea.

    Consulta DeliveryVehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
shouldShowOutcomeLocations optional
Tipo:  boolean optional
Es un valor booleano para mostrar u ocultar las ubicaciones de resultados de las tareas recuperadas.
shouldShowTasks optional
Tipo:  boolean optional
Booleano para mostrar u ocultar tareas. Si se establece como falsa, evitarás que se llame al extremo ListTasks para recuperar las tareas. Solo se mostrarán las próximas paradas del vehículo.
staleLocationThresholdMillis optional
Tipo:  number optional
Umbral de la ubicación de un vehículo inactivo. Si la ubicación actualizada más reciente del vehículo es anterior a este umbral, no se mostrará el vehículo. La configuración predeterminada es 24 horas en milisegundos. Si el umbral es inferior a 0 o Infinity, se ignorará y la ubicación del vehículo no se considerará inactiva.
takenPolylineCustomization optional
Personalización aplicada a la polilínea tomada. Una polilínea tomada corresponde a una parte de la ruta que el vehículo ya recorrió.

Usa este campo para especificar un estilo personalizado (como el color de polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios especificados se aplicarán a la polilínea después de crearla y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, se invoca una vez cuando se crea la polilínea. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, se invoca esta función cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, sin importar si cambiaron los datos correspondientes a esta polilínea.

    Consulta DeliveryVehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
taskFilterOptions optional
Opciones de filtro que se aplicarán cuando se recuperen tareas. Las opciones pueden incluir el estado específico del vehículo, la hora y la tarea.
taskMarkerCustomization optional
Tipo:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalización aplicada a un marcador de tarea. Se renderiza un marcador de tarea en la ubicación planificada de cada tarea asignada al vehículo de entregas.

Usa este campo para especificar un estilo personalizado (como el ícono de marcador) y la interactividad (como el control de clics).
  • Si se especifica un objeto MarkerOptions, los cambios especificados se aplicarán al marcador después de que se cree y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, esta se invoca una vez que se crea el marcador, antes de agregarla a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, esta función se invoca cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si los datos correspondientes a este marcador cambiaron.

    Consulta TaskMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
taskOutcomeMarkerCustomization optional
Tipo:  function(TaskMarkerCustomizationFunctionParams): void optional
Personalización aplicada a un marcador de resultado de tarea. Se renderiza un marcador de resultados de tareas en la ubicación de resultado real de cada tarea asignada al vehículo de entrega.

Usa este campo para especificar un estilo personalizado (como el ícono de marcador) y la interactividad (como el control de clics).
  • Si se especifica un objeto MarkerOptions, los cambios especificados se aplicarán al marcador después de que se cree y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, esta se invoca una vez que se crea el marcador, antes de agregarla a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, esta función se invoca cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si los datos correspondientes a este marcador cambiaron.

    Consulta TaskMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.

Interfaz de FleetEngineTaskFilterOptions

Interfaz de google.maps.journeySharing.FleetEngineTaskFilterOptions

Opciones de filtrado para tareas en el proveedor de ubicación de vehículos de entrega.

completionTimeFrom optional
Tipo:  Date optional
Límite inferior exclusivo para el tiempo de finalización de la tarea. Se usa para filtrar las tareas que se completaron después del tiempo especificado.
completionTimeTo optional
Tipo:  Date optional
Límite superior exclusivo para el tiempo de finalización de la tarea. Se usa para filtrar las tareas que se completaron antes del tiempo especificado.
state optional
Tipo:  string optional
El estado de la tarea. Los valores válidos son OPEN o CLOSED.

Interfaz de FleetEngineDeliveryVehicleLocationProviderUpdateEvent

Interfaz de google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

El objeto de evento que se pasa al controlador de eventos cuando se activa el evento FleetEngineDeliveryVehicleLocationProvider.update.

completedVehicleJourneySegments optional
Tipo:  Array<VehicleJourneySegment> optional
Son los segmentos de recorrido que completó este vehículo. No se puede modificar.
deliveryVehicle optional
Tipo:  DeliveryVehicle optional
Es la estructura de datos del vehículo de entrega que muestra la actualización. No se puede modificar.
tasks optional
Tipo:  Array<Task> optional
Es la lista de tareas que realiza este vehículo de entregas. No se puede modificar.

Clase FleetEngineDeliveryFleetLocationProvider.

Clase google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider

Proveedor de ubicación de flota de entrega.

Esta clase extiende PollingLocationProvider.

Para acceder, llama a const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parámetros: 
Crea un nuevo proveedor de ubicación para los vehículos a los que hace un seguimiento Fleet Engine.
deliveryVehicleFilter
Tipo:  string optional
Es el filtro que se aplica cuando se recuperan los vehículos de entrega.
locationRestriction
Son los límites dentro de los que se debe rastrear los vehículos de entrega. Si no se establecen límites, no se hará un seguimiento de los vehículos de entrega. Para hacer un seguimiento de todos los vehículos de entrega, independientemente de la ubicación, establece límites equivalentes a todo el planeta.
staleLocationThresholdMillis
Tipo:  number
Este campo es de solo lectura. Umbral de la ubicación de un vehículo inactivo. Si la última ubicación actualizada del vehículo es anterior a este umbral, no se mostrará el vehículo.
Heredado: isPolling, pollingIntervalMillis
Heredado: addListener
update
function(event)
Evento que se activa cuando finaliza una solicitud de actualización de datos de Fleet Engine.
Heredado: ispollingchange

Interfaz de FleetEngineDeliveryFleetLocationProviderOptions.

Interfaz de google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

Opciones del proveedor de ubicación de la flota de entregas.

authTokenFetcher
Proporciona tokens web JSON para autenticar al cliente en Fleet Engine.
projectId
Tipo:  string
El ID del proyecto del consumidor de la consola de Google Cloud.
deliveryVehicleFilter optional
Tipo:  string optional
Una consulta de filtro que se aplicará cuando se recuperen vehículos de entrega. Este filtro se pasa directamente a Fleet Engine.

Consulta ListDeliveryVehiclesRequest.filter para conocer los formatos admitidos.

Ten en cuenta que los filtros válidos para los atributos deben tener el prefijo de los “atributos”. Por ejemplo, attributes.x = "y" o attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
Tipo:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
Personalización aplicada a un marcador de vehículo de entrega.

Usa este campo para especificar un estilo personalizado (como el ícono de marcador) y la interactividad (como el control de clics).
  • Si se especifica un objeto MarkerOptions, los cambios especificados se aplicarán al marcador después de que se cree y sobrescribirán las opciones predeterminadas que existan.
  • Si se especifica una función, esta se invoca una vez que se crea el marcador, antes de agregarla a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de función se establece en true). Además, esta función se invoca cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si los datos correspondientes a este marcador cambiaron.

    Consulta DeliveryVehicleMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
locationRestriction optional
Los límites de latitud y longitud dentro de los cuales se debe rastrear vehículos inmediatamente después de que se crea una instancia del proveedor de ubicación. Si no la estableces, el proveedor de ubicación no comenzará a realizar el seguimiento de ningún vehículo. Usa FleetEngineDeliveryFleetLocationProvider.locationRestriction para establecer los límites y comenzar el seguimiento. Para hacer un seguimiento de todos los vehículos de entrega, independientemente de la ubicación, establece límites equivalentes a todo el planeta.
staleLocationThresholdMillis optional
Tipo:  number optional
Umbral de la ubicación de un vehículo inactivo. Si la ubicación actualizada más reciente del vehículo es anterior a este umbral, no se mostrará el vehículo. La configuración predeterminada es 24 horas en milisegundos. Si el umbral es inferior a cero o Infinity, se ignorará y la ubicación del vehículo no se considerará inactiva.

Interfaz de FleetEngineDeliveryFleetLocationProviderUpdateEvent.

Interfaz de google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

El objeto de evento que se pasa al controlador de eventos cuando se activa el evento FleetEngineDeliveryFleetLocationProvider.update.

deliveryVehicles optional
Tipo:  Array<DeliveryVehicle> optional
La lista de vehículos de entrega que muestra la consulta. No se puede modificar.