Fleet Engine Entities

Task.

Interface google.maps.journeySharing.Task

Os detalhes de uma tarefa retornada pela Fleet Engine.
attributes
Tipo:  Object<string, *>
Atributos atribuídos à tarefa.
name
Tipo:  string
O nome da tarefa no formato "providers/{provider_id}/tasks/{task_id}". O task_id precisa ser um identificador exclusivo, não um ID de acompanhamento. Para armazenar um ID de rastreamento de um envio, use o campo tracking_id. Várias tarefas podem ter o mesmo tracking_id.
remainingVehicleJourneySegments
Informações sobre os segmentos que ainda precisam ser concluídos nessa tarefa.
status
Tipo:  string
O estado de execução atual da tarefa.
type
Tipo:  string
O tipo de tarefa, por exemplo, uma pausa ou envio.
estimatedCompletionTime optional
Tipo:  Date optional
O carimbo de data/hora do tempo estimado de conclusão da tarefa.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informações específicas para a última atualização de local.
outcome optional
Tipo:  string optional
O resultado da tarefa.
outcomeLocation optional
Tipo:  LatLngLiteral optional
O local em que a tarefa foi concluída (do provedor).
outcomeLocationSource optional
Tipo:  string optional
O setter do local do resultado da tarefa ("PROVIDER" ou "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
O carimbo de data/hora de quando o resultado da tarefa foi definido (do provedor).
plannedLocation optional
Tipo:  LatLngLiteral optional
O local em que a tarefa será concluída.
targetTimeWindow optional
Tipo:  TimeWindow optional
A janela de tempo em que a tarefa deve ser concluída.
trackingId optional
Tipo:  string optional
O código de rastreamento da remessa.
vehicleId optional
Tipo:  string optional
O ID do veículo que está realizando a tarefa.

TaskInfo.

Interface google.maps.journeySharing.TaskInfo

Tipo de TaskInfo usado por DeliveryVehicleStop.
extraDurationMillis optional
Tipo:  number optional
O tempo extra necessário para executar a tarefa, em milissegundos.
id optional
Tipo:  string optional
O ID da tarefa.
targetTimeWindow optional
Tipo:  TimeWindow optional
A janela de tempo em que a tarefa deve ser concluída.

TaskTrackingInfo.

Interface google.maps.journeySharing.TaskTrackingInfo

Os detalhes de um objeto de informações de rastreamento de tarefas retornado pela Fleet Engine.
attributes
Tipo:  Object<string, *>
Atributos atribuídos à tarefa.
name
Tipo:  string
O nome no formato "providers/{provider_id}/taskTrackingInfo/{tracking_id}", em que tracking_id representa o ID de acompanhamento.
trackingId
Tipo:  string
O ID de acompanhamento de uma tarefa.
  • Precisa ser uma string Unicode válida.
  • Limitado a 64 caracteres.
  • Normalizado de acordo com o Formulário C de Normalização Unicode.
  • Não pode conter os seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.
estimatedArrivalTime optional
Tipo:  Date optional
O horário estimado de chegada ao local da parada.
estimatedTaskCompletionTime optional
Tipo:  Date optional
O tempo estimado de conclusão de uma tarefa.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informações específicas para a última atualização de local.
plannedLocation optional
Tipo:  LatLng optional
O local onde a Task será concluída.
remainingDrivingDistanceMeters optional
Tipo:  number optional
A distância total restante em metros até o VehicleStop de interesse.
remainingStopCount optional
Tipo:  number optional
Indica o número de paradas restantes do veículo até que a parada da tarefa seja alcançada, incluindo a parada da tarefa. Por exemplo, se a próxima parada do veículo for a parada da tarefa, o valor será 1.
routePolylinePoints optional
Tipo:  Array<LatLng> optional
Uma lista de pontos que, quando conectados, formam uma polilinha do trajeto esperado do veículo até o local dessa tarefa.
state optional
Tipo:  string optional
O estado de execução atual da Task.
targetTimeWindow optional
Tipo:  TimeWindow optional
A janela de tempo em que a tarefa deve ser concluída.
taskOutcome optional
Tipo:  string optional
O resultado da tentativa de executar uma Task.
taskOutcomeTime optional
Tipo:  Date optional
A hora em que o resultado da tarefa foi definido pelo provedor.

Trip

Interface google.maps.journeySharing.Trip

Os detalhes de uma viagem retornada pela Fleet Engine.
name
Tipo:  string
No formato "providers/{provider_id}/trips/{trip_id}". O trip_id precisa ser um identificador exclusivo.
passengerCount
Tipo:  number
Número de passageiros nesta viagem. Não inclui o motorista.
remainingWaypoints
Uma matriz de pontos de referência indicando o caminho do local atual até o ponto de desembarque.
status
Tipo:  string
Status atual da viagem. Os valores possíveis são UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE ou CANCELED.
type
Tipo:  string
O tipo de viagem. Os valores possíveis são UNKNOWN_TRIP_TYPE, SHARED ou EXCLUSIVE.
vehicleId
Tipo:  string
Código do veículo que fez esta viagem.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Local onde o cliente foi entregue.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Local onde o cliente foi retirado.
dropOffTime optional
Tipo:  Date optional
O tempo estimado futuro em que os passageiros desembarcarão ou o horário real em que eles desembarcaram.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informações específicas para a última atualização de local.
pickupTime optional
Tipo:  Date optional
A hora futura estimada em que os passageiros serão transportados ou o tempo real em que eles foram retirados.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Local em que o cliente indica que será entregue.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Local em que o cliente indica que será retirado.

DeliveryVehicle.

Interface google.maps.journeySharing.DeliveryVehicle

Detalhes de um veículo de entrega retornado pela Fleet Engine.
attributes
Tipo:  Object<string, string optional>
Atributos do veículo de entrega personalizado.
name
Tipo:  string
No formato "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". O delivery_vehicle_id precisa ser um identificador exclusivo.
navigationStatus
Tipo:  string
O status de navegação atual do veículo.
remainingDistanceMeters
Tipo:  number
A distância de carro restante no trecho de trajeto atual, em metros.
remainingVehicleJourneySegments
Os trechos de viagem atribuídos a este veículo de entrega, a partir da localização informada mais recentemente pelo veículo. Isso só é preenchido quando o objeto de dados DeliveryVehicle é fornecido por meio de FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:  LatLngLiteral optional
O local onde o segmento do trajeto atual termina.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
O último local informado do veículo de entrega.
remainingDurationMillis optional
Tipo:  number optional
A duração restante do trajeto no segmento de trajeto atual, em milissegundos.

DeliveryVehicleStop.

Interface google.maps.journeySharing.DeliveryVehicleStop

Tipo de veículo de entrega de veículo
tasks
Tipo:  Array<TaskInfo>
A lista de tarefas a serem realizadas nessa parada.
  • id: o ID da tarefa.
  • extraDurationMillis: o tempo extra necessário para executar a tarefa, em milissegundos.
plannedLocation optional
Tipo:  LatLngLiteral optional
O local da parada.
state optional
Tipo:  DeliveryVehicleStopState optional
O estado da parada.

DeliveryVehicleStopState.

google.maps.journeySharing.DeliveryVehicleStopState constantes

O estado atual de um DeliveryVehicleStop.

Acesse chamando const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
ARRIVED Chegou ao ponto. Presume que quando o veículo estiver indo para a próxima parada, todas as paradas anteriores foram concluídas.
ENROUTE Atribuído e roteando ativamente.
NEW Criada, mas sem roteamento ativo.
UNSPECIFIED Desconhecido.

interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo de VehicleJourneySegment
drivingDistanceMeters optional
Tipo:  number optional
A distância de viagem da parada anterior até essa parada, em metros.
drivingDurationMillis optional
Tipo:  number optional
O tempo de viagem da parada anterior em questão, em milissegundos.
path optional
Tipo:  Array<LatLngLiteral> optional
O caminho da parada anterior (ou o local atual do veículo, se ela for a primeira na lista de paradas) até essa parada.
stop optional
Tipo:  DeliveryVehicleStop optional
Informações sobre a parada.

VehicleLocationUpdate.

Interface google.maps.journeySharing.VehicleLocationUpdate

Tipo de VehicleLocationUpdate
heading optional
Tipo:  number optional
O título da atualização. 0 corresponde ao norte, de 180 a sul.
location optional
Tipo:  LatLngLiteral|LatLng optional
O local da atualização.
speedKilometersPerHour optional
Tipo:  number optional
A velocidade em quilômetros por hora.
time optional
Tipo:  Date optional
A hora em que essa atualização foi recebida do veículo.

VehicleWaypoint.

Interface google.maps.journeySharing.VehicleWaypoint

VehicleWaypoint.
distanceMeters optional
Tipo:  number optional
A distância do caminho entre o ponto de referência anterior (ou a localização atual do veículo, se este for o primeiro da lista de pontos de referência) até esse ponto em metros.
durationMillis optional
Tipo:  number optional
Tempo de viagem entre o ponto de referência anterior (ou a localização atual do veículo, se o ponto de referência for o primeiro da lista) em milissegundos.
location optional
Tipo:  LatLngLiteral optional
O local do ponto de referência.
path optional
Tipo:  Array<LatLngLiteral> optional
O caminho do ponto de referência anterior (ou a localização atual do veículo, se esse é o primeiro da lista)

Interface Vehicle

Interface google.maps.journeySharing.Vehicle

Detalhes de um veículo retornado pelo Fleet Engine.
attributes
Tipo:  Object<string, *>
Atributos personalizados do veículo.
name
Tipo:  string
No formato "providers/{provider_id}/vehicles/{vehicle_id}". O veículo_id precisa ser um identificador exclusivo.
navigationStatus
O status de navegação atual do veículo.
remainingDistanceMeters
Tipo:  number
A distância de carro restante no trecho de trajeto atual, em metros.
vehicleState
Tipo:  VehicleState
O estado do veículo.
vehicleType
Tipo:  VehicleType
O tipo deste veículo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
O ponto de referência onde o segmento do trajeto atual termina.
currentRouteSegmentVersion optional
Tipo:  Date optional
Hora em que o segmento de trajeto atual foi definido.
currentTrips optional
Tipo:  Array<string> optional
Lista dos IDs de viagem para este veículo.
etaToFirstWaypoint optional
Tipo:  Date optional
O HEC para a primeira entrada no campo de pontos de referência.
latestLocation optional
Tipo:  VehicleLocationUpdate optional
O último local informado do veículo.
maximumCapacity optional
Tipo:  number optional
O número total de passageiros que este veículo suporta. O driver não é considerado nesse valor.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipos de viagem compatíveis com este veículo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
Os pontos de referência restantes atribuídos a este veículo.
waypointsVersion optional
Tipo:  Date optional
A última vez que o campo "waypoints" foi atualizado.

VehicleNavigationStatus.

google.maps.journeySharing.VehicleNavigationStatus constantes

O status de navegação atual de um Vehicle.

Acesse chamando const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
ARRIVED_AT_DESTINATION O veículo fica a aproximadamente 50 m do destino.
ENROUTE_TO_DESTINATION A navegação passo a passo está disponível, e a navegação do app Driver entrou no modo GUIDED_NAV.
NO_GUIDANCE A navegação do app do motorista está no modo FREE_NAV.
OFF_ROUTE O veículo saiu do trajeto sugerido.
UNKNOWN_NAVIGATION_STATUS Status de navegação não especificado.

VehicleState

google.maps.journeySharing.VehicleState constantes

O estado atual de um Vehicle.

Acesse chamando const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
OFFLINE O veículo não está aceitando novas viagens.
ONLINE O veículo está aceitando novas viagens.
UNKNOWN_VEHICLE_STATE Estado desconhecido do veículo.

VehicleType

google.maps.journeySharing.VehicleType constantes

É o tipo de Vehicle.

Acesse chamando const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
AUTO Um automóvel.
TAXI Qualquer veículo que atua como táxi (em geral, licenciado ou regulamentado)
TRUCK Um veículo com grande capacidade de armazenamento.
TWO_WHEELER Uma motocicleta, ciclomotor ou outro veículo de duas rodas.
UNKNOWN Tipo de veículo desconhecido.

TripType

google.maps.journeySharing.TripType constantes

Tipos de viagem compatíveis com um Vehicle.

Acesse chamando const {TripType} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
EXCLUSIVE A viagem é exclusiva para um veículo.
SHARED A viagem pode compartilhar um veículo com outras viagens.
UNKNOWN_TRIP_TYPE Tipo de viagem desconhecido.

TripWaypoint.

Interface google.maps.journeySharing.TripWaypoint

Tipo de TripWaypoint.
distanceMeters optional
Tipo:  number optional
A distância do caminho entre o ponto de referência anterior (ou a localização atual do veículo, se este for o primeiro da lista de pontos de referência) até esse ponto em metros.
durationMillis optional
Tipo:  number optional
Tempo de viagem entre o ponto de referência anterior (ou a localização atual do veículo, se o ponto de referência for o primeiro da lista) em milissegundos.
location optional
Tipo:  LatLngLiteral optional
O local do ponto de referência.
tripId optional
Tipo:  string optional
A viagem associada a este ponto de referência.
waypointType optional
Tipo:  WaypointType optional
O papel que esse ponto de referência desempenha nessa viagem, como embarque ou desembarque.

WaypointType.

google.maps.journeySharing.WaypointType constantes

Tipos de ponto de referência compatíveis com Vehicle.

Acesse chamando const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Pontos de referência para desembarcar passageiros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Pontos de referência para destinos intermediários em uma viagem com vários destinos.
PICKUP_WAYPOINT_TYPE Pontos de referência para pegar passageiros.
UNKNOWN_WAYPOINT_TYPE Tipo de ponto de referência desconhecido.

TimeWindow

Interface google.maps.journeySharing.TimeWindow

Um intervalo de tempo.
endTime
Tipo:  Date
O horário de término do período (inclusive).
startTime
Tipo:  Date
O horário de início do período (inclusive).