Fleet Tracking - On Demand Rides & Delivery (beta)

Classe FleetEngineVehicleLocationProvider

Classe google.maps.journeySharing.FleetEngineVehicleLocationProvider

Provedor de localização do veículo.

Essa classe estende PollingLocationProvider.

Acesse chamando const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parâmetros:
Cria um novo provedor de local 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 ciente do tráfego 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 a polilinha restante de acordo com a leitura de velocidade. Especifique essa função como FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization para renderizar uma polilinha ciente do tráfego para a polilinha restante.
staleLocationThresholdMillis
Tipo:number
Este campo é somente leitura. Limite para localização do veículo desatualizada. Se o local atualizado pela última vez for anterior a esse limite, o veículo não vai aparecer.
vehicleId
Tipo:string
ID do veículo que esse provedor de local observa. Defina esse campo para rastrear um veículo.
Herdado: isPolling, pollingIntervalMillis
Herdado: addListener
error
function(event)
Argumentos: 
Evento acionado quando o provedor de local encontra um erro.
update
function(event)
Argumentos: 
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 optional
Personalização aplicada à polilinha ativa. Uma polilinha ativa corresponde a uma parte da rota que o veículo está percorrendo.

Use esse campo para especificar estilos personalizados (como a cor da poligonal) e interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças especificadas nele serão aplicadas à poligonal 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 linha poligonal mudam ou quando o provedor de local recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa linha poligonal terem mudado.

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

Use este campo para especificar estilos personalizados (como o ícone do marcador) e interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças nele especificadas serão aplicadas ao marcador após a criação dele, 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. (Nesta 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 local recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

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

Use este campo para especificar estilos personalizados (como o ícone do marcador) e interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças nele especificadas serão aplicadas ao marcador após a criação dele, 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. (Nesta 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 local recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

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

Use este campo para especificar estilos personalizados (como o ícone do marcador) e interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças nele especificadas serão aplicadas ao marcador após a criação dele, 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. (Nesta 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 local recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte VehicleWaypointMarkerCustomizationFunctionParams para conferir uma lista de parâmetros fornecidos e os usos deles.
pollingIntervalMillis optional
Tipo:number optional
Tempo mínimo entre a busca de atualizações de local em milissegundos. Se levar mais tempo que pollingIntervalMillis para buscar uma atualização de local, a próxima atualização 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 de local é buscada se algum dos parâmetros observados pelo provedor de local mudar.

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

Use esse campo para especificar estilos personalizados (como a cor da poligonal) e interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças especificadas nele serão aplicadas à poligonal 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 linha poligonal mudam ou quando o provedor de local recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa linha poligonal terem mudado.

    Consulte VehiclePolylineCustomizationFunctionParams para conferir uma lista de parâmetros fornecidos e seus usos.
staleLocationThresholdMillis optional
Tipo:number optional
Limite para localização do veículo desatualizada. Se o último local atualizado do veículo for anterior a esse limite, ele não vai aparecer. O padrão é de 24 horas em milissegundos. Se o limite for menor que 0 ou Infinito, ele será ignorado e a localização do veículo não será considerada desatualizada.
takenPolylineCustomization optional
Personalização aplicada à polilinha tirada. Uma polilinha percorrida corresponde a uma parte da rota que o veículo já percorreu.

Use esse campo para especificar estilos personalizados (como a cor da poligonal) e interatividade (como o processamento de cliques).
  • Se um objeto PolylineOptions for especificado, as mudanças especificadas nele serão aplicadas à poligonal 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 linha poligonal mudam ou quando o provedor de local recebe dados do Fleet Engine, independentemente de os dados correspondentes a essa linha poligonal terem mudado.

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

Use este campo para especificar estilos personalizados (como o ícone do marcador) e interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças nele especificadas serão aplicadas ao marcador após a criação dele, 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. (Nesta 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 local recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

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

Interface FleetEngineVehicleLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

O objeto de evento transmitido ao gerenciador de eventos quando o evento FleetEngineVehicleLocationProvider.update é acionado.
trips optional
Tipo:Array<Trip> optional
A lista de viagens concluídas por esse veículo. Não modificável.
vehicle optional
Tipo:Vehicle optional
A estrutura de dados do veículo retornada pela atualização. Não modificável.

Classe FleetEngineFleetLocationProvider

Classe google.maps.journeySharing.FleetEngineFleetLocationProvider

Provedor de localização da frota.

Essa classe estende PollingLocationProvider.

Acesse chamando const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parâmetros:
Cria um novo provedor de local para veículos rastreados pelo Fleet Engine.
locationRestriction
Os limites em que os veículos são rastreados. Se nenhum limite for definido, nenhum veículo será rastreado. Para rastrear todos os veículos, independentemente do local, defina limites equivalentes a todo o planeta.
staleLocationThresholdMillis
Tipo:number
Este campo é somente leitura. Limite para localização do veículo desatualizada. Se o local atualizado pela última vez for anterior a esse limite, o veículo não vai aparecer.
vehicleFilter
Tipo:string optional
O filtro aplicado ao buscar os veículos.
Herdado: isPolling, pollingIntervalMillis
Herdado: addListener
update
function(event)
Argumentos: 
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 optional
Os limites de latitude/longitude em que os veículos são rastreados imediatamente após a instanciação do provedor de local. Se não for definido, o provedor de local não vai começar a rastrear nenhum veículo. Use FleetEngineFleetLocationProvider.locationRestriction para definir os limites e começar o rastreamento. Para rastrear todos os veículos, independentemente do local, defina limites equivalentes a todo o planeta.
staleLocationThresholdMillis optional
Tipo:number optional
Limite para localização do veículo desatualizada. Se o local atualizado pela última vez for anterior a esse limite, o veículo não vai aparecer. O padrão é de 24 horas em milissegundos. Se o limite for menor que zero ou Infinito, ele será ignorado e a localização do veículo não será considerada desatualizada.
vehicleFilter optional
Tipo:string optional
Uma consulta de filtro a ser aplicada ao buscar veículos. Esse filtro é transmitido diretamente para o Fleet Engine.

Consulte ListVehiclesRequest.filter para conferir os formatos aceitos.

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

Use este campo para especificar estilos personalizados (como o ícone do marcador) e interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as mudanças nele especificadas serão aplicadas ao marcador após a criação dele, 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. (Nesta 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 local recebe dados do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

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

Interface FleetEngineFleetLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

O objeto de evento transmitido ao gerenciador de eventos quando o evento FleetEngineFleetLocationProvider.update é acionado.
vehicles optional
Tipo:Array<Vehicle> optional
A lista de veículos retornada pela consulta. Não modificável.