Fleet Tracking - On Demand Rides & Delivery

Clase FleetEngineVehicleLocationProvider

class google.maps.journeySharing.FleetEngineVehicleLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Proveedor de ubicación del vehículo

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parámetros:
Crea un nuevo proveedor de ubicación para un vehículo de Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parámetros:
Valor de retorno: Ninguno
Es la función de personalización de polilíneas que colorea la polilínea activa según su lectura de velocidad. Especifica esta función como FleetEngineVehicleLocationProviderOptions.activePolylineCustomization para renderizar una polilínea que tenga en cuenta el tráfico para la polilínea activa.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parámetros:
Valor de retorno: Ninguno
Función de personalización de polilíneas que colorea la polilínea restante según su lectura de velocidad Especifica esta función como FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization para renderizar una polilínea que tenga en cuenta el tráfico para la polilínea restante.
staleLocationThresholdMillis
Tipo: number
Este campo es de solo lectura. Es el umbral para 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.
vehicleId
Tipo: string
Es el ID del vehículo que observa este proveedor de ubicación. Establece este campo para hacer un seguimiento de un vehículo.
Heredado: isPolling, pollingIntervalMillis
Heredado: addListener
error
function(event)
Argumentos:
Es el evento que se activa cuando el proveedor de ubicación encuentra un error.
update
function(event)
Es el evento que se activa cuando finaliza una solicitud de actualización de datos de Fleet Engine.
Heredado: ispollingchange

Interfaz FleetEngineVehicleLocationProviderOptions

interfaz google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Opciones para el proveedor de ubicación del vehículo.

authTokenFetcher
Proporciona tokens web JSON para autenticar el cliente en Fleet Engine.
projectId
Tipo: string
Es el ID del proyecto del consumidor de la consola de Google Cloud.
activePolylineCustomization
opcional
Es la personalización que se aplica a la polilínea activa. Una polilínea activa corresponde a una parte de la ruta que el vehículo está recorriendo en ese momento.

Usa este campo para especificar un estilo personalizado (como el color de la polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios que se indiquen en él se aplicarán a la polilínea después de que se cree, lo que reemplazará sus opciones predeterminadas si existen.
  • 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 la función se establece en true). Además, esta función se invoca cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si cambiaron los datos correspondientes a esta polilínea.

    Consulta VehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
destinationMarkerCustomization
opcional
Es la personalización que se aplica al marcador de destino del viaje 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 que se indiquen en él se aplicarán al marcador después de que se haya creado, lo que reemplazará sus opciones predeterminadas si existen.
  • Si se especifica una función, se invoca una vez cuando se crea el marcador, antes de que se agregue a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de la 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 cambiaron los datos correspondientes a este marcador.

    Consulta VehicleWaypointMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
intermediateDestinationMarkerCustomization
opcional
Es la personalización que se aplica a los marcadores de destino intermedio del viaje 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 que se indiquen en él se aplicarán al marcador después de que se haya creado, lo que reemplazará sus opciones predeterminadas si existen.
  • Si se especifica una función, se invoca una vez cuando se crea el marcador, antes de que se agregue a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de la 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 cambiaron los datos correspondientes a este marcador.

    Consulta VehicleWaypointMarkerCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
originMarkerCustomization
opcional
Es la personalización que se aplica al marcador de origen del viaje 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 que se indiquen en él se aplicarán al marcador después de que se haya creado, lo que reemplazará sus opciones predeterminadas si existen.
  • Si se especifica una función, se invoca una vez cuando se crea el marcador, antes de que se agregue a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de la 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 cambiaron los datos correspondientes a este marcador.

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

Si estableces este valor en 0, se inhabilitarán las actualizaciones de ubicación recurrentes. Se recupera una nueva ubicación actualizada 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 más bajo que no sea cero, se usará 5000.
remainingPolylineCustomization
opcional
Se aplicó la personalización a la polilínea restante. Una polilínea restante corresponde a una parte de la ruta que el vehículo aún no comenzó a recorrer.

Usa este campo para especificar un estilo personalizado (como el color de la polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios que se indiquen en él se aplicarán a la polilínea después de que se cree, lo que reemplazará sus opciones predeterminadas si existen.
  • 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 la función se establece en true). Además, esta función se invoca cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si cambiaron los datos correspondientes a esta polilínea.

    Consulta VehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
staleLocationThresholdMillis
opcional
Tipo: number optional
Es el umbral para 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. El valor predeterminado es de 24 horas en milisegundos. Si el umbral es menor que 0 o Infinity, se ignorará el umbral y la ubicación del vehículo no se considerará inactiva.
takenPolylineCustomization
opcional
Es la personalización que se aplica 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 la polilínea) y la interactividad (como el control de clics).
  • Si se especifica un objeto PolylineOptions, los cambios que se indiquen en él se aplicarán a la polilínea después de que se cree, lo que reemplazará sus opciones predeterminadas si existen.
  • 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 la función se establece en true). Además, esta función se invoca cuando cambian las coordenadas de la polilínea o cuando el proveedor de ubicación recibe datos de Fleet Engine, independientemente de si cambiaron los datos correspondientes a esta polilínea.

    Consulta VehiclePolylineCustomizationFunctionParams para obtener una lista de los parámetros proporcionados y sus usos.
vehicleId
opcional
Tipo: string optional
Es el ID del vehículo del que se hará un 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 inicia el seguimiento de ningún vehículo. Usa FleetEngineVehicleLocationProvider.vehicleId para establecer el ID y comenzar el seguimiento.
vehicleMarkerCustomization
opcional
Es la personalización que se aplica 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 que se indiquen en él se aplicarán al marcador después de que se haya creado, lo que reemplazará sus opciones predeterminadas si existen.
  • Si se especifica una función, se invoca una vez cuando se crea el marcador, antes de que se agregue a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de la 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 cambiaron los datos correspondientes a este marcador.

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

Interfaz FleetEngineVehicleLocationProviderUpdateEvent

interfaz google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

Es el objeto de evento que se pasa al controlador de eventos cuando se activa el evento FleetEngineVehicleLocationProvider.update.

trips
opcional
Tipo: Array<Trip> optional
Es la lista de viajes que completó este vehículo. No se puede modificar.
vehicle
opcional
Tipo: Vehicle optional
Es la estructura de datos del vehículo que devuelve la actualización. No se puede modificar.

Clase FleetEngineFleetLocationProvider

class google.maps.journeySharing.FleetEngineFleetLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Proveedor de ubicación de la flota.

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parámetros:
Crea un nuevo proveedor de ubicación para los vehículos a los que Fleet Engine hace un seguimiento.
locationRestriction
Son los límites dentro de los cuales se deben seguir los vehículos. Si no se establecen límites, no se hará un seguimiento de ningún vehículo. Para hacer un seguimiento de todos los vehículos, independientemente de su ubicación, establece límites equivalentes a toda la Tierra.
staleLocationThresholdMillis
Tipo: number
Este campo es de solo lectura. Es el umbral para 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.
vehicleFilter
Tipo: string optional
Es el filtro que se aplica cuando se recuperan los vehículos.
Heredado: isPolling, pollingIntervalMillis
Heredado: addListener
update
function(event)
Es el evento que se activa cuando finaliza una solicitud de actualización de datos de Fleet Engine.
Heredado: ispollingchange

Interfaz FleetEngineFleetLocationProviderOptions

interfaz google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Opciones para el proveedor de ubicación de la flota.

authTokenFetcher
Proporciona tokens web JSON para autenticar el cliente en Fleet Engine.
projectId
Tipo: string
Es el ID del proyecto del consumidor de la consola de Google Cloud.
locationRestriction
opcional
Son los límites de latitud y longitud dentro de los cuales se deben seguir los vehículos inmediatamente después de que se crea una instancia del proveedor de ubicación. Si no se establece, el proveedor de ubicación no comenzará a hacer un seguimiento de ningún vehículo. Usa FleetEngineFleetLocationProvider.locationRestriction para establecer los límites y comenzar el seguimiento. Para hacer un seguimiento de todos los vehículos, independientemente de su ubicación, establece límites equivalentes a toda la Tierra.
staleLocationThresholdMillis
opcional
Tipo: number optional
Es el umbral para 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. El valor predeterminado es de 24 horas en milisegundos. Si el umbral es menor que cero o Infinity, se ignorará y la ubicación del vehículo no se considerará inactiva.
vehicleFilter
opcional
Tipo: string optional
Es una consulta de filtro que se aplica cuando se recuperan vehículos. Este filtro se pasa directamente a Fleet Engine.

Consulta ListVehiclesRequest.filter para conocer los formatos admitidos.

Ten en cuenta que los filtros válidos para los atributos deben tener el prefijo "attributes". Por ejemplo, attributes.x = "y" o attributes."x y" = "z".
vehicleMarkerCustomization
opcional
Tipo: function(VehicleMarkerCustomizationFunctionParams): void optional
Personalización aplicada a un marcador de 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 que se indiquen en él se aplicarán al marcador después de que se haya creado, lo que reemplazará sus opciones predeterminadas si existen.
  • Si se especifica una función, se invoca una vez cuando se crea el marcador, antes de que se agregue a la vista de mapa. (En esta invocación, el parámetro isNew del objeto de parámetros de la 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 cambiaron los datos correspondientes a este marcador.

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

Interfaz FleetEngineFleetLocationProviderUpdateEvent

interfaz google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

Es el objeto de evento que se pasa al controlador de eventos cuando se activa el evento FleetEngineFleetLocationProvider.update.

vehicles
opcional
Tipo: Array<Vehicle> optional
Es la lista de vehículos que devuelve la consulta. No se puede modificar.