Fleet Engine Entities

Interface Tarefa

Interface google.maps.journeySharing.Task

Os detalhes de uma tarefa retornada pelo 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 rastreamento. Para armazenar um ID de acompanhamento de um envio, use o campo "tracking_id". Várias tarefas podem ter o mesmo tracking_id.
remainingVehicleJourneySegments
Informações sobre os segmentos restantes para serem concluídos para essa tarefa.
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 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 (pelo provedor).
plannedLocation optional
Tipo:LatLngLiteral optional
O local em que a tarefa será concluída.
targetTimeWindow optional
Tipo:TimeWindow optional
O período em que a tarefa deve ser concluída.
trackingId optional
Tipo:string optional
O ID de acompanhamento do envio.
vehicleId optional
Tipo:string optional
O ID do veículo que está executando essa tarefa.

Interface TaskInfo

Interface google.maps.journeySharing.TaskInfo

Tipo TaskInfo usado por DeliveryVehicleStop.

extraDurationMillis optional
Tipo:number optional
O tempo extra necessário para realizar a tarefa, em milissegundos.
id optional
Tipo:string optional
O ID da tarefa.
targetTimeWindow optional
Tipo:TimeWindow optional
O período em que a tarefa deve ser concluída.

Interface 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, *>
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 rastreamento.
trackingId
Tipo:string
O ID de acompanhamento de uma tarefa.
  • Precisa ser uma string Unicode válida.
  • O tamanho máximo é de 64 caracteres.
  • Normalizado de acordo com o Formulário de normalização C do Unicode.
  • Não pode conter nenhum dos seguintes caracteres ASCII: "/", ":", "?", "," ou "#".
estimatedArrivalTime optional
Tipo:Date optional
A hora estimada 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 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 da tarefa.
state optional
Tipo:string optional
O estado de execução atual da tarefa.
targetTimeWindow optional
Tipo:TimeWindow optional
O período 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
O horário em que o resultado da tarefa foi definido pelo provedor.

Interface Trip

Interface google.maps.journeySharing.Trip

Os detalhes de uma viagem retornada pelo 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, sem incluir o motorista.
remainingWaypoints
Uma matriz de pontos de parada que indica o trajeto 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 a viagem.
actualDropOffLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente foi deixado.
actualPickupLocation optional
Tipo:LatLngLiteral optional
Local de embarque do cliente.
dropOffTime optional
Tipo:Date optional
O horário estimado de desembarque dos passageiros ou o horário real em que eles desembarcaram.
latestVehicleLocationUpdate optional
Tipo:VehicleLocationUpdate optional
Informações específicas sobre a última atualização de local.
pickupTime optional
Tipo:Date optional
O horário estimado de embarque dos passageiros ou o horário real em que eles foram embarcados.
plannedDropOffLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente indica que vai desembarcar.
plannedPickupLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente indica que vai ser buscado.

Interface DeliveryVehicle

Interface google.maps.journeySharing.DeliveryVehicle

Os detalhes de um veículo de entrega retornados pelo 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 atual da navegação do veículo.
remainingDistanceMeters
Tipo:number
A distância restante do trajeto no segmento atual da rota, em metros.
remainingVehicleJourneySegments
Os trechos da viagem atribuídos a esse veículo de entrega, começando pela localização mais recente informada do veículo. Isso só é preenchido quando o objeto de dados DeliveryVehicle é fornecido por FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:LatLngLiteral optional
O local onde o segmento de rota 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 rota atual, em milissegundos.

Interface DeliveryVehicleStop

Interface google.maps.journeySharing.DeliveryVehicleStop

Tipo DeliveryVehicleStop

tasks
A lista de tarefas a serem realizadas nessa parada.
  • id: o ID da tarefa.
  • extraDurationMillis: o tempo extra necessário para realizar a tarefa, em milissegundos.
plannedLocation optional
Tipo:LatLngLiteral optional
O local da parada.
state optional
O estado da parada.

Constantes DeliveryVehicleStopState

Constantes de google.maps.journeySharing.DeliveryVehicleStopState

O estado atual de um DeliveryVehicleStop.

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

ARRIVED Chegou à parada. Supõe que, quando o veículo está traçando a rota para a próxima parada, todas as paradas anteriores foram concluídas.
ENROUTE Atribuído e roteando ativamente.
NEW Criado, mas não roteando ativamente.
UNSPECIFIED Desconhecido.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegment

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

Interface VehicleLocationUpdate

Interface google.maps.journeySharing.VehicleLocationUpdate

Tipo 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
O momento em que essa atualização foi recebida do veículo.

Interface VehicleWaypoint

Interface google.maps.journeySharing.VehicleWaypoint

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

Interface do veículo

Interface google.maps.journeySharing.Vehicle

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

attributes
Tipo:Object<string, *>
Atributos personalizados do veículo.
name
Tipo:string
No formato "providers/{provider_id}/vehicles/{vehicle_id}". O vehicle_id precisa ser um identificador exclusivo.
navigationStatus
O status atual da navegação do veículo.
remainingDistanceMeters
Tipo:number
A distância restante do trajeto no segmento atual da rota, em metros.
vehicleState
O estado do veículo.
vehicleType
O tipo do veículo.
currentRouteSegmentEndPoint optional
Tipo:TripWaypoint optional
O ponto de referência em que o segmento de rota atual termina.
currentRouteSegmentVersion optional
Tipo:Date optional
Hora em que o segmento de rota atual foi definido.
currentTrips optional
Tipo:Array<string> optional
Lista de IDs de viagens atribuídas ao veículo.
etaToFirstWaypoint optional
Tipo:Date optional
A ETA para a primeira entrada no campo "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 o veículo pode transportar. 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 pontos de parada restantes atribuídos a este veículo.
waypointsVersion optional
Tipo:Date optional
Última vez que o campo "pontos de parada" foi atualizado.

Constantes VehicleNavigationStatus

Constantes de google.maps.journeySharing.VehicleNavigationStatus

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

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

ARRIVED_AT_DESTINATION O veículo está a aproximadamente 50 metros do destino.
ENROUTE_TO_DESTINATION A navegação guiada está disponível, e a navegação do app Driver entrou no modo GUIDED_NAV.
NO_GUIDANCE A navegação do app Driver 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 de google.maps.journeySharing.VehicleState

O estado atual de um Vehicle.

Acesse ligando para 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.

Constantes VehicleType

Constantes de google.maps.journeySharing.VehicleType

É o tipo de Vehicle.

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

AUTO Um automóvel.
TAXI Qualquer veículo que funcione como um táxi (normalmente licenciado ou regulamentado).
TRUCK Um veículo com grande capacidade de armazenamento.
TWO_WHEELER Uma motocicleta, um ciclomotor ou outro veículo de duas rodas.
UNKNOWN Tipo de veículo desconhecido.

Constantes TripType

Constantes de google.maps.journeySharing.TripType

Tipos de viagem aceitos por um Vehicle.

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

EXCLUSIVE A viagem é exclusiva de um veículo.
SHARED A viagem pode compartilhar um veículo com outras viagens.
UNKNOWN_TRIP_TYPE Tipo de viagem desconhecido.

Interface TripWaypoint

Interface google.maps.journeySharing.TripWaypoint

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

Constantes WaypointType

Constantes de google.maps.journeySharing.WaypointType

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

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

DROP_OFF_WAYPOINT_TYPE Waypoints para deixar 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 parada para pegar passageiros.
UNKNOWN_WAYPOINT_TYPE Tipo de ponto de referência desconhecido.

Interface TimeWindow

Interface google.maps.journeySharing.TimeWindow

Um período.

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 (incluso).

Constantes de velocidade

Constantes de google.maps.journeySharing.Speed

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

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

NORMAL Velocidade normal, sem lentidão detectada.
SLOW Foi detectado um congestionamento, mas não um engarrafamento.
TRAFFIC_JAM Congestionamento detectado.

Interface SpeedReadingInterval

Interface google.maps.journeySharing.SpeedReadingInterval

Indicador de intensidade do trânsito em um trecho de via contíguo. O intervalo define os pontos inicial e final do segmento usando os índices deles.

endPolylinePointIndex
Tipo:number
O índice baseado em zero do ponto final do intervalo no caminho.
speed
Tipo:Speed
Velocidade do trânsito neste intervalo.
startPolylinePointIndex
Tipo:number
O índice baseado em zero do ponto inicial do intervalo no caminho.