Trip and Order Progress

Clase FleetEngineTripLocationProvider

Clase google.maps.journeySharing.FleetEngineTripLocationProvider

Proveedor de ubicación de viajes.

Esta clase extiende PollingLocationProvider.

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

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parámetros: 
Crea un nuevo proveedor de ubicación para un viaje de Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parámetros: 
Valor que se devuelve: Ninguno
Función de personalización de polilíneas que colorea la polilínea activa según su velocidad de lectura Especifica esta función como FleetEngineTripLocationProviderOptions.activePolylineCustomization para renderizar una polilínea optimizada para el tráfico en la polilínea activa.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parámetros: 
Valor que se devuelve: Ninguno
Función de personalización de polilíneas que colorea la polilínea restante según su velocidad de lectura. Especifica esta función como FleetEngineTripLocationProviderOptions.remainingPolylineCustomization para renderizar una polilínea optimizada para el tráfico en la polilínea restante.
tripId
Tipo:  string
Es el ID del viaje que observa este proveedor de ubicación. Establece este campo para comenzar el seguimiento.
Heredado: isPolling, pollingIntervalMillis
refresh
refresh()
Parámetros: Ninguno
Valor que se devuelve:  void
Actualiza de forma explícita la ubicación a la que le hiciste seguimiento.
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 FleetEngineTripLocationProviderOptions

Interfaz de google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Opciones del proveedor de ubicación de viajes.

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
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
destinationMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Se aplicó la personalización al marcador de destino.

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 TripMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
originMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalización aplicada al marcador de origen.

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 TripMarkerCustomizationFunctionParams 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
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
takenPolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
tripId optional
Tipo:  string optional
El ID de viaje del que se realizará el seguimiento inmediatamente después de que se cree 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 viaje. Utiliza FleetEngineTripLocationProvider.tripId para establecer el ID y comenzar el seguimiento.
vehicleMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Se aplicó la personalización al marcador del vehículo.

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 TripMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
waypointMarkerCustomization optional
Personalización aplicada a un marcador de punto de referencia.

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 TripWaypointMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.

Interfaz de FleetEngineTripLocationProviderUpdateEvent

Interfaz de google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

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

trip optional
Tipo:  Trip optional
La estructura de viaje que muestra la actualización. No se puede modificar.