Fleet Engine Entities

Interface Task

Interface google.maps.journeySharing.Task

Os detalhes de uma tarefa retornada pela Fleet Engine.

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 o ID de rastreamento de um frete, use o campo "tracking_id". Várias tarefas podem ter o mesmo acompanhamento_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, um intervalo ou uma remessa.
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 de 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 onde a tarefa será concluída.
trackingId optional
Tipo:string optional
O ID de acompanhamento do envio.
vehicleId optional
Tipo:string optional
ID do veículo que está realizando esta tarefa.

Interface TaskTrackingInfo.

Interface google.maps.journeySharing.TaskTrackingInfo

Os detalhes de um objeto de informações de rastreamento de tarefas retornado pela Fleet Engine.

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.
  • Normalizada de acordo com o Formulário C de Normalização Unicode.
  • Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',', ou '#'.
estimatedArrivalTime optional
Tipo:Date optional
O horário estimado de chegada para o 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 em que a tarefa 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é a parada da tarefa, incluindo a parada da tarefa. Por exemplo, se a próxima parada do veículo for a parada de tarefas, 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 desta tarefa.
state optional
Tipo:string optional
O estado de execução atual da tarefa.
taskOutcome optional
Tipo:string optional
O resultado da tentativa de executar uma tarefa.
taskOutcomeTime optional
Tipo:Date optional
A hora em que o resultado da tarefa foi definido pelo provedor.

Interface 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 waypoints indicando o caminho da localização 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 da viagem. Os valores possíveis são UNKNOWN_TRIP_TYPE, SHARED ou EXCLUSIVE.
vehicleId
Tipo:string
ID do veículo que está fazendo a viagem.
actualDropOffLocation optional
Tipo:LatLngLiteral optional
Local em que o cliente foi entregue.
actualPickupLocation optional
Tipo:LatLngLiteral optional
Local em que o cliente foi retirado.
dropOffTime optional
Tipo:Date optional
A hora futura estimada em que os passageiros desembarcarão ou o horário real de desembarque.
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 embarcados ou a hora 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 vai ser retirado.

Interface DeliveryVehicle

Interface google.maps.journeySharing.DeliveryVehicle

Os detalhes de um veículo de entrega retornado pela Fleet Engine.

attributes
Tipo:Object<string, string optional>
Atributos personalizados do veículo de entrega.
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 restante no percurso da rota atual em metros.
remainingVehicleJourneySegments
Os segmentos de jornada atribuídos a este veículo de entrega, a partir do local informado mais recentemente pelo veículo.
currentRouteSegmentEndPoint optional
Tipo:LatLngLiteral optional
O local onde o segmento de 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 percurso no trecho da rota atual em milissegundos.

Interface DeliveryVehicleStop.

Interface google.maps.journeySharing.DeliveryVehicleStop

Tipo de veículo para entrega

tasks
Tipo:Array<{
  id:string optional,
  extraDurationMillis:number optional
}>
A lista de tarefas a serem realizadas nesta parada.
  • id: o ID da tarefa.
  • extraDurationMillis: o tempo extra necessário para executar a tarefa, em milissegundos.

DeliveryVehicleStopState (constantes).

google.maps.journeySharing.DeliveryVehicleStopState constantes

O estado atual de um DeliveryVehicleStop.

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

ARRIVED Chegou na parada. Suponha que, quando o veículo estiver indo para a próxima parada, todas as paradas anteriores tenham sido concluídas.
ENROUTE Atribuído e com roteamento ativo.
NEW Criada, mas não roteando ativamente.
UNSPECIFIED Desconhecido.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo de segmento de veículo

drivingDistanceMeters optional
Tipo:number optional
A distância do percurso da parada anterior até essa parada, em metros.
drivingDurationMillis optional
Tipo:number optional
O tempo de viagem em relação à parada anterior, em milissegundos.
path optional
Tipo:Array<LatLngLiteral> optional
O caminho do ponto de referência anterior (ou a localização atual do veículo, se este for o primeiro da lista)
stop optional
Tipo:Array<DeliveryVehicleStop> optional
As paradas a serem atendidas por este veículo.

Interface VehicleLocationUpdate

Interface google.maps.journeySharing.VehicleLocationUpdate

Tipo de VehicleLocationUpdate

heading optional
Tipo:number optional
O título da atualização. 0 corresponde ao norte, 180 ao 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 esta atualização foi recebida do veículo.

Interface VehicleWaypoint.

Interface google.maps.journeySharing.VehicleWaypoint

Tipo de VehicleWaypoint.

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