Fleet Tracking - On Demand Rides & Delivery

Classe FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider classe
estende PollingLocationProvider
biblioteca "journeySharing"

Provedor de localização do veículo.

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parâmetros:
Cria um novo provedor de localização para um veículo do Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parâmetros:
Valor de retorno: nenhum
Função de personalização de polilinha que colore a polilinha ativa de acordo com a leitura de velocidade. Especifique essa função como FleetEngineVehicleLocationProviderOptions.activePolylineCustomization para renderizar uma polilinha que considera o trânsito para a polilinha ativa.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parâmetros:
Valor de retorno: nenhum
Função de personalização de polilinha que colore o restante da polilinha de acordo com a leitura de velocidade. Especifique essa função como FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization para renderizar uma polilinha que considera o trânsito para o restante da polilinha.
staleLocationThresholdMillis
Tipo: number
Este campo é somente leitura. Limite para localização desatualizada do veículo. Se o último local atualizado do veículo for mais antigo que esse limite, o veículo não será exibido.
vehicleId
Tipo: string
ID do veículo que esse provedor de localização observa. Defina esse campo para rastrear um veículo.
Herdado: isPolling, pollingIntervalMillis
Herdado: addListener
error
function(event)
Argumentos:
Evento que é acionado quando o provedor de localização encontra um erro.
update
function(event)
Evento acionado quando uma solicitação de atualização de dados do Fleet Engine é concluída.
Herdado: ispollingchange

Interface FleetEngineVehicleLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Opções para o provedor de localização do veículo.

authTokenFetcher
Fornece JSON Web Tokens para autenticar o cliente no Fleet Engine.
projectId
Tipo: string
O ID do projeto do consumidor no console do Google Cloud.
activePolylineCustomization
opcional
Personalização aplicada à polilinha ativa. Uma polilinha ativa corresponde a uma parte do trajeto que o veículo está percorrendo no momento.

Use esse campo para especificar o estilo personalizado (como a cor da polilinha) e a interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças indicadas nele serão aplicadas à polilinha depois que ela for criada, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando a polilinha for criada. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando as coordenadas da polilinha mudam ou quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa polilinha terem mudado.

    Consulte VehiclePolylineCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
destinationMarkerCustomization
opcional
Personalização aplicada ao marcador de destino da viagem do veículo.

Use esse campo para especificar o estilo personalizado (como o ícone do marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças especificadas nele serão aplicadas ao marcador após a criação, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando o marcador for criado, antes de ser adicionado à visualização do mapa. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado ou não.

    Consulte VehicleWaypointMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
intermediateDestinationMarkerCustomization
opcional
Personalização aplicada aos marcadores de destino intermediário da viagem do veículo.

Use esse campo para especificar o estilo personalizado (como o ícone do marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças especificadas nele serão aplicadas ao marcador após a criação, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando o marcador for criado, antes de ser adicionado à visualização do mapa. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado ou não.

    Consulte VehicleWaypointMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
originMarkerCustomization
opcional
Personalização aplicada ao marcador de origem da viagem do veículo.

Use esse campo para especificar o estilo personalizado (como o ícone do marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças especificadas nele serão aplicadas ao marcador após a criação, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando o marcador for criado, antes de ser adicionado à visualização do mapa. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado ou não.

    Consulte VehicleWaypointMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
pollingIntervalMillis
opcional
Tipo: number optional
Tempo mínimo entre as atualizações do local em milissegundos. Se levar mais de pollingIntervalMillis para buscar uma atualização de local, a próxima não será iniciada até que a atual seja concluída.

Definir esse valor como 0 desativa as atualizações de local recorrentes. Uma nova atualização do local é buscada se algum dos parâmetros observados pelo provedor de localização mudar.

O intervalo de sondagem padrão é de 5.000 milissegundos, que é o intervalo mínimo. Se você definir o intervalo de sondagem como um valor diferente de zero menor, 5000 será usado.
remainingPolylineCustomization
opcional
Personalização aplicada à polilinha restante. Uma polilinha restante corresponde a uma parte do trajeto que o veículo ainda não começou a percorrer.

Use esse campo para especificar o estilo personalizado (como a cor da polilinha) e a interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças indicadas nele serão aplicadas à polilinha depois que ela for criada, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando a polilinha for criada. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando as coordenadas da polilinha mudam ou quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa polilinha terem mudado.

    Consulte VehiclePolylineCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
staleLocationThresholdMillis
opcional
Tipo: number optional
Limite para localização desatualizada do veículo. Se o último local atualizado do veículo for mais antigo que esse limite, o veículo não será exibido. O padrão é 24 horas em milissegundos. Se o limite for menor que 0 ou Infinity, ele será ignorado, e a localização do veículo não será considerada desatualizada.
takenPolylineCustomization
opcional
Personalização aplicada à polilinha percorrida. Uma polilinha percorrida corresponde a uma parte do trajeto que o veículo já percorreu.

Use esse campo para especificar o estilo personalizado (como a cor da polilinha) e a interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças indicadas nele serão aplicadas à polilinha depois que ela for criada, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando a polilinha for criada. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando as coordenadas da polilinha mudam ou quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa polilinha terem mudado.

    Consulte VehiclePolylineCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.
vehicleId
opcional
Tipo: string optional
O ID do veículo a ser rastreado imediatamente após a instanciação do provedor de localização. Se não for especificado, o provedor de localização não vai começar a rastrear nenhum veículo. Use FleetEngineVehicleLocationProvider.vehicleId para definir o ID e iniciar o rastreamento.
vehicleMarkerCustomization
opcional
Personalização aplicada ao marcador de veículo.

Use esse campo para especificar o estilo personalizado (como o ícone do marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças especificadas nele serão aplicadas ao marcador após a criação, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando o marcador for criado, antes de ser adicionado à visualização do mapa. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado ou não.

    Consulte VehicleMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.

Interface FleetEngineVehicleLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

O objeto de evento transmitido ao manipulador de eventos quando o evento FleetEngineVehicleLocationProvider.update é acionado.

trips
opcional
Tipo: Array<Trip> optional
A lista de viagens concluídas por este veículo. Não modificável.
vehicle
opcional
Tipo: Vehicle optional
A estrutura de dados do veículo retornada pela atualização. Não modificável.

Classe FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider classe
estende PollingLocationProvider
biblioteca "journeySharing"

Provedor de localização da frota.

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parâmetros:
Cria um novo provedor de localização para veículos rastreados pelo Fleet Engine.
locationRestriction
Os limites em que os veículos serão rastreados. Se nenhum limite for definido, nenhum veículo será rastreado. Para rastrear todos os veículos, independentemente do local, defina limites equivalentes à Terra inteira.
staleLocationThresholdMillis
Tipo: number
Este campo é somente leitura. Limite para localização desatualizada do veículo. Se o último local atualizado do veículo for mais antigo que esse limite, o veículo não será exibido.
vehicleFilter
Tipo: string optional
O filtro aplicado ao buscar os veículos.
Herdado: isPolling, pollingIntervalMillis
Herdado: addListener
update
function(event)
Evento acionado quando uma solicitação de atualização de dados do Fleet Engine é concluída.
Herdado: ispollingchange

Interface FleetEngineFleetLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Opções para o provedor de localização da frota.

authTokenFetcher
Fornece JSON Web Tokens para autenticar o cliente no Fleet Engine.
projectId
Tipo: string
O ID do projeto do consumidor no console do Google Cloud.
locationRestriction
opcional
Os limites de latitude/longitude em que os veículos serão rastreados imediatamente após a instanciação do provedor de localização. Se não for definido, o provedor de localização não vai começar a rastrear nenhum veículo. Use FleetEngineFleetLocationProvider.locationRestriction para definir os limites e iniciar o rastreamento. Para rastrear todos os veículos, independentemente do local, defina limites equivalentes à Terra inteira.
staleLocationThresholdMillis
opcional
Tipo: number optional
Limite para localização desatualizada do veículo. Se o último local atualizado do veículo for mais antigo que esse limite, o veículo não será exibido. O padrão é 24 horas em milissegundos. Se o limite for menor que zero ou Infinity, ele será ignorado, e a localização do veículo não será considerada desatualizada.
vehicleFilter
opcional
Tipo: string optional
Uma consulta de filtro para aplicar ao buscar veículos. Esse filtro é transmitido diretamente para o Fleet Engine.

Consulte ListVehiclesRequest.filter para ver os formatos compatíveis.

Os filtros válidos para atributos precisam ter o prefixo "attributes". Por exemplo, attributes.x = "y" ou attributes."x y" = "z".
vehicleMarkerCustomization
opcional
Tipo: function(VehicleMarkerCustomizationFunctionParams): void optional
Personalização aplicada a um marcador de veículo.

Use esse campo para especificar o estilo personalizado (como o ícone do marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças especificadas nele serão aplicadas ao marcador após a criação, substituindo as opções padrão, se houver.
  • Se uma função for especificada, ela será invocada uma vez quando o marcador for criado, antes de ser adicionado à visualização do mapa. Nessa invocação, o parâmetro isNew no objeto de parâmetros da função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado ou não.

    Consulte VehicleMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os usos deles.

Interface FleetEngineFleetLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

O objeto de evento transmitido ao manipulador de eventos quando o evento FleetEngineFleetLocationProvider.update é acionado.

vehicles
opcional
Tipo: Array<Vehicle> optional
A lista de veículos retornada pela consulta. Não modificável.