Fleet Tracking - On Demand Rides & Delivery (beta)

Classe FleetEngineVehicleLocationProvider

Classe google.maps.journeySharing.FleetEngineVehicleLocationProvider

Provedor de localização de veículos.

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 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 sua velocidade de leitura. Especifique essa função como FleetEngineVehicleLocationProviderOptions.activePolylineCustomization para renderizar uma polilinha com reconhecimento de 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 a polilinha restante de acordo com sua velocidade de leitura. Especifique essa função como FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization para renderizar uma polilinha que reconhece o trânsito para a polilinha restante.
staleLocationThresholdMillis
Tipo:  number
Este campo é somente leitura. Limite para a localização do veículo desatualizado. Se o último local atualizado do veículo for anterior a esse limite, o veículo não será exibido.
vehicleId
Tipo:  string
ID do veículo que esse provedor de localização observa. Defina este campo para monitorar um veículo.
Herdado: isPolling, pollingIntervalMillis
Herdado: addListener
error
function(event)
Argumentos: 
Evento acionado quando o provedor de localização 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

FleetEngineVehicleLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Opções do provedor de localização de veículos.
authTokenFetcher
Fornece tokens JSON Web 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 do trajeto pelo qual o veículo está passando.

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 alterações especificadas nele serão aplicadas à polilinha depois da criação dela, 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 dos parâmetros fornecidos e seus usos.
destinationMarkerCustomization optional
Personalização aplicada ao marcador de destino da viagem do veículo.

Use esse campo para especificar o estilo personalizado (como o ícone de um marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as alterações especificadas nele 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 de 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 da mudança nos dados correspondentes a esse marcador.

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

Use esse campo para especificar o estilo personalizado (como o ícone de um marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as alterações especificadas nele 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 de 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 da mudança nos dados correspondentes a esse marcador.

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

Use esse campo para especificar o estilo personalizado (como o ícone de um marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as alterações especificadas nele 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 de 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 da mudança nos dados correspondentes a esse marcador.

    Consulte VehicleWaypointMarkerCustomizationFunctionParams para conferir uma lista dos 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 de pollingIntervalMillis para buscar uma atualização de local, a próxima atualização de local não será iniciada até que a atual seja concluída.

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

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

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 alterações especificadas nele serão aplicadas à polilinha depois da criação dela, 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 dos parâmetros fornecidos e seus usos.
staleLocationThresholdMillis optional
Tipo:  number optional
Limite para a localização do veículo desatualizado. Se o último local atualizado do veículo tiver um valor anterior a esse limite, o veículo não será mostrado. O padrão é de 24 horas em milissegundos. Se o limite for menor que 0, ou Infinity, o limite será ignorado, e a localização do veículo não será considerada desatualizada.
takenPolylineCustomization optional
Personalização aplicada à polilinha escolhida. Uma polilinha selecionada 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 alterações especificadas nele serão aplicadas à polilinha depois da criação dela, 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 dos parâmetros fornecidos e seus usos.
vehicleId optional
Tipo:  string optional
O ID do veículo a ser monitorado imediatamente após o provedor de localização ser instanciado. Se não for especificado, o provedor do local não vai começar a rastrear nenhum veículo. Use FleetEngineVehicleLocationProvider.vehicleId para definir o ID e iniciar o monitoramento.
vehicleMarkerCustomization optional
Tipo:  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalização aplicada ao marcador do veículo.

Use esse campo para especificar o estilo personalizado (como o ícone de um marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as alterações especificadas nele 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 de 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 da mudança nos dados correspondentes a esse marcador.

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

Interface FleetEngineVehicleLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

O objeto do evento transmitido ao manipulador de eventos quando o evento FleetEngineVehicleLocationProvider.update é acionado.
trips optional
Tipo:  Array<Trip> optional
A lista de viagens concluídas por este 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 de frotas.

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 localização para veículos rastreados pelo Fleet Engine.
locationRestriction
Os limites para rastrear veículos. Se nenhum limite for definido, nenhum veículo será rastreado. Para rastrear todos os veículos, independentemente do local, defina limites equivalentes a toda a Terra.
staleLocationThresholdMillis
Tipo:  number
Este campo é somente leitura. Limite para a localização do veículo desatualizado. Se o último local atualizado do veículo for anterior a 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)
Argumentos: 
Evento acionado quando uma solicitação de atualização de dados do Fleet Engine é concluída.
Herdado: ispollingchange

FleetEngineFleetLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Opções para o provedor de localização da frota.
authTokenFetcher
Fornece tokens JSON Web 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 nos quais rastrear veículos imediatamente após o provedor de localização ser instanciado. Se ela não for definida, o provedor de localização 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 toda a Terra.
staleLocationThresholdMillis optional
Tipo:  number optional
Limite para a localização do veículo desatualizado. Se o último local atualizado do veículo for anterior a esse limite, o veículo não será exibido. O padrão é de 24 horas em milissegundos. Se o limite for menor que zero ou Infinity, o limite vai ser ignorado, e a localização do veículo não vai ser considerada desatualizada.
vehicleFilter optional
Tipo:  string optional
Uma consulta de filtro para aplicar ao buscar veículos. Esse filtro é transmitido diretamente para o Fleet Engine.

Consulte os formatos compatíveis em ListVehiclesRequest.filter.

Os filtros válidos para atributos precisam ter o prefixo "atributos". 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 esse campo para especificar o estilo personalizado (como o ícone de um marcador) e a interatividade (como o processamento de cliques).
  • Se um objeto MarkerOptions for especificado, as alterações especificadas nele 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 de 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 da mudança nos dados correspondentes a esse marcador.

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

Interface FleetEngineFleetLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

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