Fleet Engine Entities

Interface Task

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 que ainda precisam ser concluídos para esta 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 de conclusão estimado da tarefa.
latestVehicleLocationUpdate optional
Tipo:VehicleLocationUpdate optional
Informações específicas da ú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 definidor 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
Janela de tempo em que a tarefa precisa ser concluída.
trackingId optional
Tipo:string optional
O código de rastreamento do envio.
vehicleId optional
Tipo:string optional
O ID do veículo que está realizando essa tarefa.

Interface TaskInfo

Interface google.maps.journeySharing.TaskInfo

Tipo TaskInfo, usado por DeliveryVehicleStop.
extraDurationMillis optional
Tipo:number optional
O tempo extra que leva para realizar a tarefa, em milissegundos.
id optional
Tipo:string optional
O ID da tarefa.
targetTimeWindow optional
Tipo:TimeWindow optional
Janela de tempo em que a tarefa precisa 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 rastreamento 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 de normalização C do Unicode.
  • Não pode conter nenhum dos 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 de conclusão estimado de uma tarefa.
latestVehicleLocationUpdate optional
Tipo:VehicleLocationUpdate optional
Informações específicas da ú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 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
Janela de tempo em que a tarefa precisa 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. Não inclui o motorista.
remainingWaypoints
Uma matriz de pontos de passagem que indicam o caminho do local atual até o ponto de entrega.
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
ID do veículo que está fazendo essa viagem.
actualDropOffLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente foi deixado.
actualPickupLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente foi buscado.
dropOffTime optional
Tipo:Date optional
O horário futuro estimado em que os passageiros serão deixados ou o horário real em que foram deixados.
latestVehicleLocationUpdate optional
Tipo:VehicleLocationUpdate optional
Informações específicas da última atualização de local.
pickupTime optional
Tipo:Date optional
O horário futuro estimado em que os passageiros serão buscados ou o horário real em que foram buscados.
plannedDropOffLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente indica que será deixado.
plannedPickupLocation optional
Tipo:LatLngLiteral optional
Local onde o cliente indica que será atendido.

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 de veículos de entrega personalizados.
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 do percurso no segmento de rota atual, em metros.
remainingVehicleJourneySegments
Os segmentos de viagem atribuídos a esse veículo de entrega, começando pelo local mais recente informado. Esse campo só é preenchido quando o objeto de dados DeliveryVehicle é fornecido por FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:LatLngLiteral optional
O local em que 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 da viagem no segmento de rota atual, em milissegundos.

Interface DeliveryVehicleStop

Interface google.maps.journeySharing.DeliveryVehicleStop

Tipo de DeliveryVehicleStop
tasks
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 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 ao ponto. Assume que, quando o veículo está roteando para a próxima parada, todas as paradas anteriores foram concluídas.
ENROUTE Atribuído e roteamento ativo.
NEW Criado, mas não roteando ativamente.
UNSPECIFIED Desconhecido.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo de segmento de percurso do veículo
drivingDistanceMeters optional
Tipo:number optional
A distância percorrida da parada anterior até essa parada, em metros.
drivingDurationMillis optional
Tipo:number optional
O tempo de viagem da parada anterior até essa parada, em milissegundos.
path optional
Tipo:Array<LatLngLiteral> optional
O caminho da parada anterior (ou do local atual do veículo, se essa parada for a primeira na lista) até essa 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, 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 ponto de passagem do veículo.
distanceMeters optional
Tipo:number optional
A distância do caminho entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro da lista) até esse waypoint em metros.
durationMillis optional
Tipo:number optional
Tempo de viagem entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro da lista) e esse waypoint em milissegundos.
location optional
Tipo:LatLngLiteral optional
O local do ponto de passagem.
path optional
Tipo:Array<LatLngLiteral> optional
O caminho do waypoint anterior (ou do local atual do veículo, se esse waypoint for o primeiro da lista) até esse waypoint.
speedReadingIntervals optional
A lista de velocidades de trânsito ao longo do caminho do waypoint anterior (ou do local do veículo) até o waypoint atual. Cada intervalo na lista descreve o tráfego em um segmento contínuo no caminho. O intervalo define os pontos inicial e final do segmento pelos í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 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 vehicle_id precisa ser um identificador exclusivo.
navigationStatus
O status de navegação atual do veículo.
remainingDistanceMeters
Tipo:number
A distância restante do percurso no segmento de rota atual, em metros.
vehicleState
O estado do veículo.
vehicleType
O tipo do veículo.
currentRouteSegmentEndPoint optional
Tipo:TripWaypoint optional
O ponto de passagem onde 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 das viagens atualmente atribuídas a este veículo.
etaToFirstWaypoint optional
Tipo:Date optional
O ETA para a primeira entrada no campo de pontos de passagem.
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 driver não é considerado neste 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 pontos de passagem foi atualizado.

Constantes VehicleNavigationStatus

Constantes google.maps.journeySharing.VehicleNavigationStatus

O status de navegação atual de uma 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 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 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 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 funcione como táxi (normalmente licenciado ou regulamentado).
TRUCK Um veículo com grande capacidade de armazenamento.
TWO_WHEELER Motocicleta, ciclomotor ou outro veículo de duas rodas.
UNKNOWN Tipo de veículo desconhecido.

Constantes de 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 viagens.
UNKNOWN_TRIP_TYPE Tipo de viagem desconhecido.

Interface TripWaypoint

Interface google.maps.journeySharing.TripWaypoint

Tipo de ponto de parada da viagem.
distanceMeters optional
Tipo:number optional
A distância do caminho entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro da lista) até esse waypoint em metros.
durationMillis optional
Tipo:number optional
Tempo de viagem entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro da lista) e esse waypoint em milissegundos.
location optional
Tipo:LatLng optional
O local do ponto de passagem.
path optional
Tipo:Array<LatLng> optional
O caminho da parada anterior (ou do local atual do veículo, se essa parada for a primeira na lista) até essa parada.
speedReadingIntervals optional
A lista de velocidades de trânsito ao longo do caminho do waypoint anterior (ou do local do veículo) até o waypoint atual. Cada intervalo na lista descreve o tráfego em um segmento contínuo no caminho. O intervalo define os pontos inicial e final do segmento pelos índices. Consulte a definição de SpeedReadingInterval para mais detalhes.
tripId optional
Tipo:string optional
A viagem associada a esse ponto de passagem.
waypointType optional
Tipo:WaypointType optional
A função desse ponto de passagem na viagem, como coleta ou entrega.

Constantes WaypointType

Constantes google.maps.journeySharing.WaypointType

Tipos de ponto de referência aceitos por Vehicle.

Acesse chamando const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Waypoints para deixar os passageiros.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoints para destinos intermediários em uma viagem com vários destinos.
PICKUP_WAYPOINT_TYPE Waypoints para buscar passageiros.
UNKNOWN_WAYPOINT_TYPE Tipo de ponto de passagem 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
Horário de início do período.

Velocidade constantes

Constantes google.maps.journeySharing.Speed

Classificação da velocidade da poligonal com base nos dados de tráfego.

Acesse chamando const {Speed} = await google.maps.importLibrary("journeySharing"). Consulte Bibliotecas na API Maps JavaScript.
NORMAL Velocidade normal, nenhuma lentidão foi detectada.
SLOW Lentidão detectada, mas nenhum engarrafamento formado.
TRAFFIC_JAM Congestionamento detectado.

Interface SpeedReadingInterval

Interface google.maps.journeySharing.SpeedReadingInterval

Indicador de densidade de tráfego em um segmento de caminho contíguo. O intervalo define os pontos inicial e final do segmento pelos índices.
endPolylinePointIndex
Tipo:number
O índice com base em zero do ponto final do intervalo no caminho.
speed
Tipo:Speed
Velocidade do trânsito nesse intervalo.
startPolylinePointIndex
Tipo:number
O índice baseado em zero do ponto inicial do intervalo no caminho.