Fleet Tracking

Classe FleetEngineDeliveryVehicleLocationProvider

Classe google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider

Provedor de localização do veículo de entrega.

Essa classe estende PollingLocationProvider.

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.

Ao usar v=beta, é possível chamar const {FleetEngineDeliveryVehicleLocationProvider} = await google.map.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parâmetros:
Cria um novo provedor de localização para um veículo de entrega do Fleet Engine.
deliveryVehicleId
Tipo: string
ID do veículo que esse provedor de localização observa. Defina este campo para rastrear um veículo.
shouldShowOutcomeLocations
Tipo:boolean optional
Permitir que os usuários exibam o local do resultado da tarefa.
shouldShowTasks
Tipo:boolean optional
Permitir que os usuários exibam tarefas buscadas.
staleLocationThresholdMillis
Tipo: number
Este campo é somente leitura. Limite para localização de veículo desatualizado. Se o último local atualizado do veículo for mais antigo que esse limite, ele não será exibido.
taskFilterOptions
Retorna as opções de filtro a serem aplicadas ao buscar tarefas.
Herdadas: isPolling
Herdadas: 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.
Herdadas: ispollingchange

interface FleetEngineDeliveryVehicleLocationProviderOptions.

Interface google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

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

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.
authTokenFetcher
Fornece JSON Web Tokens para autenticar o cliente na Fleet Engine.
projectId
Tipo:string
O ID do projeto do consumidor no Console do Google Cloud.
deliveryVehicleId optional
Tipo:string optional
O ID do veículo de entrega a ser rastreado imediatamente após o provedor de local ser instanciado. Se não for especificado, o provedor de local não começará a monitorar nenhum veículo. Use FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId para definir o ID e começar a rastrear.
deliveryVehicleMarkerCustomization optional
Personalização aplicada ao marcador de veículo de entrega.

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 alterações especificadas serão aplicadas ao marcador depois que ele for criado, substituindo as opções padrão, se existirem.
  • Se uma função é especificada, é invocada uma vez quando o marcador é criado, antes de ser adicionada à visualização do mapa. Nesta invocação, o parâmetro isNew no objeto de parâmetros de função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados da frota do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte DeliveryVehicleMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os respectivos usos.
plannedStopMarkerCustomization optional
Personalização aplicada a um marcador de parada planejado.

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 alterações especificadas serão aplicadas ao marcador depois que ele for criado, substituindo as opções padrão, se existirem.
  • Se uma função é especificada, é invocada uma vez quando o marcador é criado, antes de ser adicionada à visualização do mapa. Nesta invocação, o parâmetro isNew no objeto de parâmetros de função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados da frota do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte PlannedStopMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os respectivos usos.
pollingIntervalMillis optional
Tipo:number optional
Tempo mínimo entre buscar atualizações de localização em milissegundos. Se demorar 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 recorrentes de local. Uma nova atualização de localização será buscada se um dos parâmetros observados pelo provedor de localização mudar.

O intervalo padrão de pesquisa é de 5.000 milissegundos, o mínimo. Se você definir o intervalo de pesquisa para um valor diferente de zero, o valor 5.000 será usado.
shouldShowOutcomeLocations optional
Tipo: boolean optional
Booleano para mostrar ou ocultar locais de resultados para as tarefas buscadas.
shouldShowTasks optional
Tipo: boolean optional
Booleano para mostrar ou ocultar tarefas. Definir como "false" vai impedir que o endpoint "ListTasks" seja chamado para buscar as tarefas. Somente as próximas paradas do veículo serão exibidas.
staleLocationThresholdMillis optional
Tipo:number optional
Limite para localização de veículo desatualizado. Se o último local atualizado do veículo for mais antigo que esse limite, ele não será exibido. O padrão é 24 horas em milissegundos. Se o limite for menor que 0 ou Infinity, ele será ignorado e o local do veículo não será considerado desatualizado.
taskFilterOptions optional
Opções de filtro a serem aplicadas ao buscar tarefas. As opções podem incluir um veículo específico, horário e status da tarefa.
taskMarkerCustomization optional
Tipo: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalização aplicada a um marcador de tarefa. Um marcador de tarefa é renderizado no local planejado de cada tarefa atribuída ao veículo de entrega.

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 alterações especificadas serão aplicadas ao marcador depois que ele for criado, substituindo as opções padrão, se existirem.
  • Se uma função é especificada, é invocada uma vez quando o marcador é criado, antes de ser adicionada à visualização do mapa. Nesta invocação, o parâmetro isNew no objeto de parâmetros de função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados da frota do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte TaskMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os respectivos usos.
taskOutcomeMarkerCustomization optional
Tipo:function(TaskMarkerCustomizationFunctionParams): void optional
Personalização aplicada a um marcador de resultado da tarefa. Um marcador de resultado de tarefa é renderizado no local real de cada tarefa atribuída ao veículo de entrega.

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 alterações especificadas serão aplicadas ao marcador depois que ele for criado, substituindo as opções padrão, se existirem.
  • Se uma função é especificada, é invocada uma vez quando o marcador é criado, antes de ser adicionada à visualização do mapa. Nesta invocação, o parâmetro isNew no objeto de parâmetros de função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados da frota do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte TaskMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os respectivos usos.

Interface FleetEngineTaskFilterOptions.

Interface google.maps.journeySharing.FleetEngineTaskFilterOptions

Opções de filtragem para tarefas no provedor de localização do veículo de entrega.

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.
completionTimeFrom optional
Tipo: Date optional
Limite inferior exclusivo para o tempo de conclusão da tarefa. Usado para filtrar tarefas que foram concluídas após o tempo especificado.
completionTimeTo optional
Tipo: Date optional
Limite superior exclusivo para o tempo de conclusão da tarefa. Usado para filtrar tarefas que foram concluídas antes do tempo especificado.
state optional
Tipo:string optional
O estado da tarefa. Os valores válidos são OPEN ou CLOSED.

Interface FleetEngineDeliveryVehicleLocationProviderUpdateEvent.

Interface google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

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

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.
completedVehicleJourneySegments optional
Os trechos da jornada que foram concluídos por este veículo. Não pode ser modificado.
deliveryVehicle optional
Tipo:DeliveryVehicle optional
A estrutura de dados do veículo de entrega retornada pela atualização. Não pode ser modificado.
tasks optional
Tipo: Array<Task> optional
A lista de tarefas exibidas por este veículo de entrega. Não pode ser modificado.

Classe FleetEngineDeliveryFleetLocationProvider

Classe google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider

Provedor de localização da frota de entrega.

Essa classe estende PollingLocationProvider.

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.

Ao usar v=beta, é possível chamar const {FleetEngineDeliveryFleetLocationProvider} = await google.map.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parâmetros:
Cria um novo provedor de localização para veículos rastreados pelo Fleet Engine.
deliveryVehicleFilter
Tipo: string optional
O filtro aplicado na busca dos veículos de entrega.
locationRestriction
Os limites para rastrear veículos de entrega. Se nenhum limite for definido, nenhum veículo de entrega será rastreado. Para rastrear todos os veículos de entrega, independentemente da localização, defina limites equivalentes a toda a Terra.
pollingIntervalMillis
Tipo:number optional
Tempo mínimo entre buscar atualizações de localização em milissegundos. Se demorar 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 recorrentes de local. Uma nova atualização de localização será buscada se um dos parâmetros observados pelo provedor de localização mudar.

O intervalo padrão de pesquisa é de 5.000 milissegundos, o mínimo. Se você definir o intervalo de pesquisa para um valor diferente de zero, o valor 5.000 será usado.
staleLocationThresholdMillis
Tipo:number
Este campo é somente leitura. Limite para localização de veículo desatualizado. Se o último local atualizado do veículo for mais antigo que esse limite, ele não será exibido.
Herdadas: isPolling
Herdadas: addListener
update
function(event)
Argumentos:
Evento acionado quando uma solicitação de atualização de dados do Fleet Engine é concluída.
Herdadas: ispollingchange

Interface FleetEngineDeliveryFleetLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

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

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.
authTokenFetcher
Fornece JSON Web Tokens para autenticar o cliente na Fleet Engine.
projectId
Tipo:string
O ID do projeto do consumidor no Console do Google Cloud.
deliveryVehicleFilter optional
Tipo:string optional
Uma consulta de filtro a ser aplicada ao buscar veículos de entrega. Esse filtro é transmitido diretamente para o Fleet Engine.

Veja os formatos compatíveis em ListDeliveryVehiclesRequest.filter.

Os filtros válidos para atributos precisam ter o prefixo "attributes". Por exemplo, attributes.x = "y" ou attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
Personalização aplicada a um marcador de veículo de entrega.

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 alterações especificadas serão aplicadas ao marcador depois que ele for criado, substituindo as opções padrão, se existirem.
  • Se uma função é especificada, é invocada uma vez quando o marcador é criado, antes de ser adicionada à visualização do mapa. Nesta invocação, o parâmetro isNew no objeto de parâmetros de função é definido como true. Além disso, essa função é invocada quando o provedor de localização recebe dados da frota do Fleet Engine, independentemente de os dados correspondentes a esse marcador terem mudado.

    Consulte DeliveryVehicleMarkerCustomizationFunctionParams para ver uma lista de parâmetros fornecidos e os respectivos usos.
locationRestriction optional
Os limites de latitude/longitude em que os veículos serão rastreados imediatamente após o provedor do local ser instanciado. Se ela não for definida, o provedor de localização não começará a monitorar nenhum veículo. Use FleetEngineDeliveryFleetLocationProvider.locationRestriction para definir os limites e iniciar o rastreamento. Para rastrear todos os veículos de entrega, independentemente da localização, defina limites equivalentes a toda a Terra.
staleLocationThresholdMillis optional
Tipo:number optional
Limite para localização de veículo desatualizado. Se o último local atualizado do veículo for mais antigo que esse limite, ele não será exibido. O padrão é 24 horas em milissegundos. Se o limite for menor que zero ou infinito, ele será ignorado e o local do veículo não será considerado desatualizado.

Interface FleetEngineDeliveryFleetLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

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

Carregar usando o parâmetro de URL &libraries=journeySharing. Consulte Bibliotecas na API Maps JavaScript.
deliveryVehicles optional
Tipo: Array<DeliveryVehicle> optional
A lista de veículos de entrega retornados pela consulta. Não pode ser modificado.