Fleet Engine Entities

Task

Interface google.maps.journeySharing.Task

Os detalhes de uma tarefa retornada pelo Fleet Engine.

attributes
Tipo:  Object<string, *>
São os 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 e 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
São informações sobre os trechos que ainda precisam ser concluídos.
status
Tipo:  string
O estado de execução atual da tarefa.
type
Tipo:  string
O tipo de tarefa, por exemplo, uma pausa ou um 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 sobre a última atualização de local.
outcome optional
Tipo:  string optional
O resultado da tarefa.
outcomeLocation optional
Tipo:  LatLngLiteral optional
O local onde 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 acompanhamento do envio.
vehicleId optional
Tipo:  string optional
O ID do veículo que executa esta 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 pelo Fleet Engine.

attributes
Tipo:  Object<string, *>
São os 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 um comprimento máximo de 64 caracteres.
  • Normalizado 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 previsto 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 sobre 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 que o veículo resta 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 de 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 desta tarefa.
state optional
Tipo:  string optional
O estado de execução atual da tarefa.
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 tarefa.
taskOutcomeTime optional
Tipo:  Date optional
A hora em que o resultado da Tarefas foi definido pelo provedor.

Interface Trip.

Interface google.maps.journeySharing.Trip

Os detalhes de uma viagem retornada pelo Fleet Engine.

name
Tipo:  string
Use o 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 que indicam 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 da viagem. Os valores possíveis são UNKNOWN_TRIP_TYPE, SHARED ou EXCLUSIVE.
vehicleId
Tipo:  string
ID do veículo que está fazendo esta viagem.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Local onde o cliente foi deixado.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Local onde o cliente foi retirado.
dropOffTime optional
Tipo:  Date optional
A hora futura estimada em que os passageiros desembarcarão ou o horário real em que eles foram desembarcados.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informações específicas sobre a última atualização de local.
pickupTime optional
Tipo:  Date optional
A hora futura estimada em que os passageiros serão embarcados ou o horário real em que eles foram embarcados.
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.

Interface DeliveryVehicle

Interface google.maps.journeySharing.DeliveryVehicle

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

attributes
Tipo:  Object<string, string optional>
Atributos do veículo de entrega personalizada.
name
Tipo:  string
Use o 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 da viagem atribuídos a este veículo de entrega, começando no local informado mais recentemente. Só é preenchido quando o objeto de dados DeliveryVehicle é fornecido pelo FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:  LatLngLiteral optional
O local onde o trecho 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 percurso no trecho de trajeto atual, em milissegundos.

Interface DeliveryVehicleStop

Interface google.maps.journeySharing.DeliveryVehicleStop

Tipo DeliveryVehicleStop

tasks
Tipo:  Array<TaskInfo>
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.
plannedLocation optional
Tipo:  LatLngLiteral optional
O local da parada.
state optional
Tipo:  DeliveryVehicleStopState optional
O estado da parada.

Constantes DeliveryVehicleStopState

Constantes google.maps.journeySharing.DeliveryVehicleStopState

O estado atual de uma DeliveryVehicleStop.

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

ARRIVED Chegou à parada. Pressupõe que, quando o veículo está seguindo o trajeto para a próxima parada, todas as paradas anteriores foram concluídas.
ENROUTE Atribuído e fazendo roteamento ativo.
NEW Criada, mas sem roteamento ativo.
UNSPECIFIED Desconhecido.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegmento

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

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, e 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 essa 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 waypoint anterior (ou a localização atual do veículo, se este for o primeiro na lista de waypoints) até este waypoint em metros.
durationMillis optional
Tipo:  number optional
Tempo de viagem entre o waypoint anterior (ou a localização atual do veículo, se este for o primeiro na lista de waypoints) até este waypoint em milissegundos.
location optional
Tipo:  LatLngLiteral optional
A localização do waypoint.
path optional
Tipo:  Array<LatLngLiteral> optional
O caminho desde o waypoint anterior (ou a localização atual do veículo, se este for o primeiro na lista de waypoints) até este waypoint.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
A lista de velocidades de tráfego ao longo do caminho desde o waypoint anterior (ou localização do veículo) até o waypoint atual. Cada intervalo da lista descreve o tráfego em um segmento contíguo no caminho. O intervalo define os pontos inicial e final do segmento por meio dos índices deles. Confira a definição de SpeedReadingInterval para mais detalhes.

Interface Vehicle

Interface google.maps.journeySharing.Vehicle

Os detalhes de um veículo retornado pelo Fleet Engine.

attributes
Tipo:  Object<string, *>
Atributos personalizados do veículo.
name
Tipo:  string
Use o 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 trecho do trajeto atual termina.
currentRouteSegmentVersion optional
Tipo:  Date optional
Horário em que o trecho do trajeto atual foi definido.
currentTrips optional
Tipo:  Array<string> optional
Lista de IDs de viagens atribuídas atualmente a este veículo.
etaToFirstWaypoint optional
Tipo:  Date optional
O HEC para a primeira entrada no campo de waypoints.
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 pode carregar. O motorista não é considerado nesse valor.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipos de viagem aceitos por este veículo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
Os waypoints restantes atribuídos a este Veículo.
waypointsVersion optional
Tipo:  Date optional
Última vez que o campo de waypoints foi atualizado.

Constantes VehicleNavigationStatus

Constantes google.maps.journeySharing.VehicleNavigationStatus

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 está a aproximadamente 50 m do destino.
ENROUTE_TO_DESTINATION A navegação guiada está disponível, e a navegação no app do motorista entrou no modo GUID_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.

Constantes VehicleState

Constantes google.maps.journeySharing.VehicleState

O estado atual de uma 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 do veículo desconhecido.

Constantes de VehicleType

Constantes google.maps.journeySharing.VehicleType

É 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 atue como táxi (normalmente licenciado ou regulamentado).
TRUCK Um veículo com grande capacidade de armazenamento.
TWO_WHEELER Uma moto, ciclomoto ou outro veículo de duas rodas.
UNKNOWN Tipo de veículo desconhecido.

Constantes TripType

Constantes google.maps.journeySharing.TripType

Tipos de viagem aceitos por 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.
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 waypoint anterior (ou a localização atual do veículo, se este for o primeiro na lista de waypoints) até este waypoint em metros.
durationMillis optional
Tipo:  number optional
Tempo de viagem entre o waypoint anterior (ou a localização atual do veículo, se este for o primeiro na lista de waypoints) até este waypoint em milissegundos.
location optional
Tipo:  LatLng optional
A localização do waypoint.
path optional
Tipo:  Array<LatLng> optional
O caminho da parada anterior (ou a localização atual do veículo, se esta for a primeira na lista) até esta parada.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
A lista de velocidades de tráfego ao longo do caminho desde o waypoint anterior (ou localização do veículo) até o waypoint atual. Cada intervalo da lista descreve o tráfego em um segmento contíguo no caminho. O intervalo define os pontos inicial e final do segmento por meio dos índices deles. Confira a definição de SpeedReadingInterval para mais detalhes.
tripId optional
Tipo:  string optional
A viagem associada a este waypoint.
waypointType optional
Tipo:  WaypointType optional
A função que o waypoint desempenha na viagem, por exemplo, em embarque ou desembarque.

Constantes de WaypointType

Constantes google.maps.journeySharing.WaypointType

Tipos de waypoint 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 o embarque de passageiros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoints 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 waypoint desconhecido.

TimeWindow

Interface google.maps.journeySharing.TimeWindow

Um período.

endTime
Tipo:  Date
O horário de término da janela de tempo (inclusive).
startTime
Tipo:  Date
O horário de início da janela de tempo (inclusive).

Constantes de Velocidade

Constantes google.maps.journeySharing.Speed

A classificação da velocidade da polilinha com base nos dados de trânsito.

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

NORMAL Velocidade normal, nenhuma lentidão é detectada.
SLOW Lentidão detectada, mas não há engarrafamento.
TRAFFIC_JAM Engarrafamento detectado.

SpeedReadingInterval,

Interface google.maps.journeySharing.SpeedReadingInterval

Indicador de densidade do tráfego em um segmento de caminho contíguo. O intervalo define os pontos de início e fim do segmento por meio de seus índices.

endPolylinePointIndex
Tipo:  number
O índice baseado em zero do ponto final do intervalo no caminho.
speed
Tipo:  Speed
Velocidade do tráfego neste intervalo.
startPolylinePointIndex
Tipo:  number
O índice baseado em zero do ponto de partida do intervalo no caminho.