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 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 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 uma entrega.
estimatedCompletionTime
opcional
Tipo: Date optional
O carimbo de data/hora do tempo estimado de conclusão da tarefa.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Informações específicas sobre a última atualização do local.
outcome
opcional
Tipo: string optional
O resultado da tarefa.
outcomeLocation
opcional
Tipo: LatLngLiteral optional
O local onde a tarefa foi concluída (do provedor).
outcomeLocationSource
opcional
Tipo: string optional
O definidor do local do resultado da tarefa ('PROVIDER' ou 'LAST_VEHICLE_LOCATION').
outcomeTime
opcional
Tipo: Date optional
O carimbo de data/hora de quando o resultado da tarefa foi definido (pelo provedor).
plannedLocation
opcional
Tipo: LatLngLiteral optional
O local onde a tarefa deve ser concluída.
targetTimeWindow
opcional
Tipo: TimeWindow optional
A janela de tempo em que a tarefa precisa ser concluída.
trackingId
opcional
Tipo: string optional
O ID de rastreamento do envio.
vehicleId
opcional
Tipo: string optional
O ID do veículo que está realizando a tarefa.

Interface TaskInfo

Interface google.maps.journeySharing.TaskInfo

Tipo TaskInfo, usado por DeliveryVehicleStop.

extraDurationMillis
opcional
Tipo: number optional
O tempo extra necessário para realizar a tarefa, em milissegundos.
id
opcional
Tipo: string optional
O ID da tarefa.
targetTimeWindow
opcional
Tipo: TimeWindow optional
A 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 Unicode C.
  • Não pode conter nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.
estimatedArrivalTime
opcional
Tipo: Date optional
O horário de chegada previsto ao local da parada.
estimatedTaskCompletionTime
opcional
Tipo: Date optional
O tempo estimado de conclusão de uma tarefa.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Informações específicas sobre a última atualização do local.
plannedLocation
opcional
Tipo: LatLng optional
O local onde a tarefa será concluída.
remainingDrivingDistanceMeters
opcional
Tipo: number optional
A distância total restante em metros até o VehicleStop de interesse.
remainingStopCount
opcional
Tipo: number optional
Indica o número de paradas que o veículo ainda precisa fazer até chegar à parada da tarefa, incluindo essa parada. Por exemplo, se a próxima parada do veículo for a parada da tarefa, o valor será 1.
routePolylinePoints
opcional
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
opcional
Tipo: string optional
O estado de execução atual da tarefa.
targetTimeWindow
opcional
Tipo: TimeWindow optional
A janela de tempo em que a tarefa precisa ser concluída.
taskOutcome
opcional
Tipo: string optional
O resultado da tentativa de executar uma tarefa.
taskOutcomeTime
opcional
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 retornados 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 na viagem, sem incluir o motorista.
remainingWaypoints
Uma matriz de waypoints que indica 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 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
opcional
Tipo: LatLngLiteral optional
Local onde o cliente foi deixado.
actualPickupLocation
opcional
Tipo: LatLngLiteral optional
Local onde o cliente foi buscado.
dropOffTime
opcional
Tipo: Date optional
O horário futuro estimado em que os passageiros vão ser deixados no destino ou o horário real em que foram deixados.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
Informações específicas sobre a última atualização do local.
pickupTime
opcional
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
opcional
Tipo: LatLngLiteral optional
Local onde o cliente indica que vai desembarcar.
plannedPickupLocation
opcional
Tipo: LatLngLiteral optional
Local onde o cliente indica que será retirado.

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 de navegação atual do veículo.
remainingDistanceMeters
Tipo: number
A distância restante do trajeto no trecho atual da rota, em metros.
remainingVehicleJourneySegments
Os trechos da jornada atribuídos a esse veículo de entrega, começando pelo local mais recente informado. Isso só é preenchido quando o objeto de dados DeliveryVehicle é fornecido por FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint
opcional
Tipo: LatLngLiteral optional
O local onde o segmento de trajeto atual termina.
latestVehicleLocationUpdate
opcional
Tipo: VehicleLocationUpdate optional
O último local informado do veículo de entrega.
remainingDurationMillis
opcional
Tipo: number optional
A duração restante do trajeto no segmento 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
opcional
Tipo: LatLngLiteral optional
O local da parada.
state
opcional
O estado da parada.

Constantes de DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState biblioteca de constantes
"journeySharing"

O estado atual de um DeliveryVehicleStop.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");
ARRIVED Chegou à parada. Presume que, quando o veículo está indo para a próxima parada, todas as paradas anteriores foram concluídas.
ENROUTE Atribuído e roteando ativamente.
NEW Criado, mas não está roteando ativamente.
UNSPECIFIED Desconhecido.

Interface VehicleJourneySegment

Interface google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegment

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

Interface VehicleLocationUpdate

Interface google.maps.journeySharing.VehicleLocationUpdate

Tipo VehicleLocationUpdate

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

Interface VehicleWaypoint

Interface google.maps.journeySharing.VehicleWaypoint

Tipo VehicleWaypoint.

distanceMeters
opcional
Tipo: number optional
A distância do trajeto entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro na lista de waypoints) e esse waypoint, em metros.
durationMillis
opcional
Tipo: number optional
Tempo de viagem entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro na lista) e este waypoint, em milissegundos.
location
opcional
Tipo: LatLngLiteral optional
O local do waypoint.
path
opcional
Tipo: Array<LatLngLiteral> optional
O caminho do waypoint anterior (ou do local atual do veículo, se esse for o primeiro waypoint na lista) até este waypoint.
speedReadingIntervals
opcional
Tipo: Array<SpeedReadingInterval> optional
A lista de velocidades do trânsito ao longo do trajeto do waypoint anterior (ou local do veículo) até o waypoint atual. Cada intervalo na lista descreve o trânsito em um segmento contíguo no trajeto. O intervalo define os pontos de início e fim 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 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 de navegação atual do veículo.
remainingDistanceMeters
Tipo: number
A distância restante do trajeto no trecho atual da rota, em metros.
vehicleState
O estado do veículo.
vehicleType
O tipo do veículo.
currentRouteSegmentEndPoint
opcional
Tipo: TripWaypoint optional
O waypoint onde o trecho de rota atual termina.
currentRouteSegmentVersion
opcional
Tipo: Date optional
Hora em que o segmento de rota atual foi definido.
currentTrips
opcional
Tipo: Array<string> optional
Lista de IDs de viagens atribuídas ao veículo.
etaToFirstWaypoint
opcional
Tipo: Date optional
O HEC para a primeira entrada no campo de waypoints.
latestLocation
opcional
Tipo: VehicleLocationUpdate optional
A última localização informada do veículo.
maximumCapacity
opcional
Tipo: number optional
O número total de passageiros que o veículo pode transportar. O motorista não é considerado nesse valor.
supportedTripTypes
opcional
Tipo: Array<TripType> optional
Tipos de viagem aceitos por este veículo.
waypoints
opcional
Tipo: Array<TripWaypoint> optional
Os waypoints restantes atribuídos a este veículo.
waypointsVersion
opcional
Tipo: Date optional
Última vez que o campo de waypoints foi atualizado.

Constantes de VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus biblioteca de constantes
"journeySharing"

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

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo VehicleNavigationStatusString.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");
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

google.maps.journeySharing.VehicleState biblioteca de constantes
"journeySharing"

O estado atual de um Vehicle.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");
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

google.maps.journeySharing.VehicleType biblioteca de constantes
"journeySharing"

É o tipo de Vehicle.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");
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 motocicleta, ciclomotor ou outro veículo de duas rodas.
UNKNOWN Tipo de veículo desconhecido.

Constantes TripType

google.maps.journeySharing.TripType biblioteca de constantes
"journeySharing"

Tipos de viagem aceitos por um Vehicle.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");
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
opcional
Tipo: number optional
A distância do trajeto entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro na lista de waypoints) e esse waypoint, em metros.
durationMillis
opcional
Tipo: number optional
Tempo de viagem entre o waypoint anterior (ou o local atual do veículo, se esse waypoint for o primeiro na lista) e este waypoint, em milissegundos.
location
opcional
Tipo: LatLng optional
O local do waypoint.
path
opcional
Tipo: Array<LatLng> optional
O trajeto da parada anterior (ou do local atual do veículo, se essa for a primeira parada da lista) até essa parada.
speedReadingIntervals
opcional
Tipo: Array<SpeedReadingInterval> optional
A lista de velocidades do trânsito ao longo do trajeto do waypoint anterior (ou local do veículo) até o waypoint atual. Cada intervalo na lista descreve o trânsito em um segmento contíguo no trajeto. O intervalo define os pontos de início e fim do segmento pelos índices. Consulte a definição de SpeedReadingInterval para mais detalhes.
tripId
opcional
Tipo: string optional
A viagem associada a esse ponto de referência.
waypointType
opcional
Tipo: WaypointType optional
A função que esse waypoint desempenha na viagem, como retirada ou entrega.

Constantes de WaypointType

google.maps.journeySharing.WaypointType biblioteca de constantes
"journeySharing"

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

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");
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 Waypoints para buscar passageiros.
UNKNOWN_WAYPOINT_TYPE Tipo de waypoint 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 (inclusivo).

Constantes de velocidade

google.maps.journeySharing.Speed biblioteca de constantes
"journeySharing"

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

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");
NORMAL Velocidade normal, nenhuma lentidão foi detectada.
SLOW Lentidão detectada, mas sem congestionamento.
TRAFFIC_JAM Congestionamento detectado.

Interface SpeedReadingInterval

Interface google.maps.journeySharing.SpeedReadingInterval

Indicador de densidade de tráfego em um segmento de trajeto contíguo. O intervalo define os pontos de início e término do segmento pelos índices.

endPolylinePointIndex
Tipo: number
O índice baseado 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 de partida do intervalo no caminho.