Trip and Order Progress

Classe FleetEngineTripLocationProvider

Classe google.maps.journeySharing.FleetEngineTripLocationProvider

Provedor do local da viagem.

Essa classe estende PollingLocationProvider.

Acesse chamando const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parâmetros: 
Cria um novo provedor de localização para uma viagem 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 FleetEngineTripLocationProviderOptions.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 FleetEngineTripLocationProviderOptions.remainingPolylineCustomization para renderizar uma polilinha que reconhece o trânsito para a polilinha restante.
tripId
Tipo:  string
O ID da viagem que esse provedor de localização observa. Defina este campo para iniciar o monitoramento.
Herdado: isPolling, pollingIntervalMillis
refresh
refresh()
Parâmetros: nenhum
Valor de retorno:  void
Atualiza explicitamente o local rastreado.
Herdado: addListener
error
function(event)
Argumentos: 
Evento 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

FleetEngineTripLocationProviderOptions

Interface google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Opções para o provedor do local da viagem.

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
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para ver uma lista dos parâmetros fornecidos e seus usos.
destinationMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalização aplicada ao marcador de destino.

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 TripMarkerCustomizationFunctionParams para conferir uma lista dos parâmetros fornecidos e os usos deles.
originMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalização aplicada ao marcador de origem.

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 TripMarkerCustomizationFunctionParams 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
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para ver uma lista dos parâmetros fornecidos e seus usos.
takenPolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions 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 TripPolylineCustomizationFunctionParams para ver uma lista dos parâmetros fornecidos e seus usos.
tripId optional
Tipo:  string optional
O ID da viagem a ser acompanhada 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 viagens. Use FleetEngineTripLocationProvider.tripId para definir o ID e iniciar o rastreamento.
vehicleMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): 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 TripMarkerCustomizationFunctionParams para conferir uma lista dos parâmetros fornecidos e os usos deles.
waypointMarkerCustomization optional
Personalização aplicada a um marcador de waypoint.

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 TripWaypointMarkerCustomizationFunctionParams para conferir uma lista dos parâmetros fornecidos e os usos deles.

Interface FleetEngineTripLocationProviderUpdateEvent

Interface google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

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

trip optional
Tipo:  Trip optional
A estrutura da viagem retornada pela atualização. Não modificável.