REST Resource: providers.trips

Recurso: viagem

Metadados de viagem.

Representação JSON 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
Campos
name

string

Apenas saída. No formato "providers/{provider}/trips/{trip}".
vehicleId

string

ID do veículo que está fazendo esta viagem.
tripStatus

enum (TripStatus)

Status atual da viagem.
tripType

enum (TripType)

O tipo da viagem.
pickupPoint

object (TerminalLocation)

Local onde o cliente indica que será retirado.
actualPickupPoint

object (StopLocation)

Apenas entrada. O local real quando e onde o cliente foi retirado. Este campo serve para o fornecedor dar feedback sobre as informações de retirada reais.
actualPickupArrivalPoint

object (StopLocation)

Apenas entrada. A hora real e o local da chegada do motorista ao ponto de embarque. Este campo serve para o fornecedor fornecer feedback sobre as informações reais de chegada ao ponto de embarque.
pickupTime

string (Timestamp format)

Apenas saída. O horário futuro estimado de embarque ou o horário real de embarque dos passageiros.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

object (TerminalLocation)

Paradas intermediárias para que a viagem solicite (além dos embarques e desembarques). Inicialmente, esse recurso não estará disponível para viagens compartilhadas.
intermediateDestinationsVersion

string (Timestamp format)

Indica a última vez que o intermediateDestinations foi modificado. O servidor precisa armazenar esse valor em cache e transmiti-lo em UpdateTripRequest quando atualizar intermediateDestinationIndex para garantir que o intermediateDestinations não seja mudado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
intermediateDestinationIndex

integer

Quando TripStatus for ENROUTE_TO_INTERMEDIATE_DESTINATION, um número entre [0..N-1] que indica qual destino intermediário o veículo vai passar em seguida. Quando TripStatus for ARRIVED_AT_INTERMEDIATE_DESTINATION, um número entre [0..N-1] que indica em qual destino intermediário o veículo está. O provedor define esse valor. Se não houver intermediateDestinations, este campo será ignorado.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

Apenas entrada. O horário e o local da chegada do motorista a um destino intermediário. Este campo serve para o provedor dar feedback sobre informações reais de chegada em destinos intermediários.
actualIntermediateDestinations[]

object (StopLocation)

Apenas entrada. A hora e o local reais quando e onde o cliente foi retirado de um destino intermediário. Este campo serve para o provedor dar feedback sobre as informações reais de retirada em destinos intermediários.
dropoffPoint

object (TerminalLocation)

Local em que o cliente indica que será deixado.
actualDropoffPoint

object (StopLocation)

Apenas entrada. A hora e o local reais quando e onde o cliente foi deixado. Este campo serve para o provedor fornecer feedback sobre as informações reais de entrega.
dropoffTime

string (Timestamp format)

Apenas saída. O horário futuro estimado em que os passageiros chegarão ao destino final ou o horário real em que eles desembarcaram.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
remainingWaypoints[]

object (TripWaypoint)

Apenas saída. Caminho completo do local atual até o ponto de desembarque. Esse caminho pode incluir waypoints de outras viagens.
vehicleWaypoints[]

object (TripWaypoint)

Este campo é compatível com a ordem manual dos waypoints da viagem. Ele contém todos os waypoints restantes do veículo atribuído, bem como os waypoints de embarque e desembarque da viagem. Se a viagem não tiver sido atribuída a um veículo, o Fleet Engine ignorará este campo. Por motivos de privacidade, esse campo só é preenchido pelo servidor em chamadas trips.update e trips.create, NÃO em chamadas trips.get.
route[]

object (LatLng)

Apenas saída. Trajeto previsto para esta viagem até a primeira entrada em foundWaypoints. O primeiro waypoint pode pertencer a uma viagem diferente.
currentRouteSegment

string

Apenas saída. Um caminho codificado para o próximo waypoint.

Observação: esse campo é destinado somente para uso do SDK do Driver e do SDK de consumidor. A decodificação ainda não está disponível.
currentRouteSegmentVersion

string (Timestamp format)

Apenas saída. Indica a última vez que o trajeto foi modificado.

Observação: esse campo é destinado somente para uso do SDK do Driver e do SDK de consumidor.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Apenas saída. Indica as condições de trânsito ao longo da currentRouteSegment, quando elas estiverem disponíveis.

Observação: esse campo é destinado somente para uso do SDK do Driver e do SDK de consumidor.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Apenas saída. Indica a última vez que o currentRouteSegmentTraffic foi modificado.

Observação: esse campo é destinado somente para uso do SDK do Driver e do SDK de consumidor.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

Apenas saída. O waypoint em que currentRouteSegment termina.
remainingDistanceMeters

integer

Apenas saída. A distância de carro restante no campo currentRouteSegment. O valor não será especificado se a viagem não estiver atribuída a um veículo ou se ela for concluída ou cancelada.
etaToFirstWaypoint

string (Timestamp format)

Apenas saída. O HEC até o próximo waypoint (a primeira entrada no campo remainingWaypoints). O valor não será especificado se a viagem não estiver atribuída a um veículo ou se estiver inativa (concluída ou cancelada).

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
remainingTimeToFirstWaypoint

string (Duration format)

Apenas saída. A duração entre o momento em que os dados da viagem são retornados até o horário no Trip.eta_to_first_waypoint. O valor não será especificado se a viagem não estiver atribuída a um veículo ou se estiver inativa (concluída ou cancelada).

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

Apenas saída. Indica a última vez que remainingWaypoints foi alterado (um waypoint foi adicionado, removido ou modificado).

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Apenas saída. Indica a última vez que o remainingWaypoints.path_to_waypoint e o remainingWaypoints.traffic_to_waypoint foram modificados. O app cliente precisa armazenar esse valor em cache e transmiti-lo em GetTripRequest para garantir que os caminhos e o tráfego da remainingWaypoints só sejam retornados se forem atualizados.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
numberOfPassengers

integer

Imutável. Indica o número de passageiros nesta viagem e não inclui o motorista. Um veículo precisa ter capacidade disponível para ser retornado em uma resposta vehicles.search.
lastLocation

object (VehicleLocation)

Apenas saída. Indica o último local informado do veículo ao longo do trajeto.
lastLocationSnappable

boolean

Apenas saída. Indica se o lastLocation do veículo pode ser alinhado ao currentRouteSegment. Falso se lastLocation ou currentRouteSegment não existirem. Isso é calculado pelo Fleet Engine. Todas as atualizações de clientes serão ignoradas.
view

enum (TripView)

O subconjunto de campos "Viagem" que são preenchidos e como eles devem ser interpretados.

TripStatus

O status de uma viagem que indica sua progressão.

Enums
UNKNOWN_TRIP_STATUS Padrão, usado para status de viagem não especificado ou não reconhecido.
NEW Viagem recém-criada.
ENROUTE_TO_PICKUP O motorista está a caminho do ponto de embarque.
ARRIVED_AT_PICKUP O motorista chegou ao ponto de embarque.
ARRIVED_AT_INTERMEDIATE_DESTINATION O motorista chegou a um destino intermediário e está esperando o passageiro.
ENROUTE_TO_INTERMEDIATE_DESTINATION O motorista está a caminho de um destino intermediário (não o ponto de desembarque).
ENROUTE_TO_DROPOFF O motorista pegou o passageiro e está a caminho do próximo destino.
COMPLETE O passageiro desembarcou, e a viagem foi concluída.
CANCELED a viagem foi cancelada antes do embarque pelo motorista, passageiro ou provedor de transporte por aplicativo.

StopLocation

O local real em que uma parada (retirada/desembarque) aconteceu.

Representação JSON 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Campos
point

object (LatLng)

Obrigatório. Indica o local real.
timestamp

string (Timestamp format)

Indica quando ocorreu a parada.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
stopTime
(deprecated)

string (Timestamp format)

Somente entrada. Obsoleto. Use o campo "carimbo de data/hora".

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

TripView

Seletor para diferentes conjuntos de campos "Viagem" em uma resposta trips.get. Consulte AIP-157 para mais contexto. Outras vistas podem ser adicionadas.

Enums
TRIP_VIEW_UNSPECIFIED O valor padrão. Para oferecer compatibilidade com versões anteriores, a API usará como padrão uma visualização do SDK. Para garantir a estabilidade e o suporte, recomendamos que os clientes selecionem um TripView diferente de SDK.
SDK Inclui campos que podem não ser interpretáveis ou compatíveis com bibliotecas disponíveis publicamente.
JOURNEY_SHARING_V1S Os campos de viagem são preenchidos para o caso de uso de compartilhamento de jornada. Essa visualização é destinada às comunicações de servidor para servidor.

Métodos

create

 Cria uma viagem no Fleet Engine e retorna a nova viagem.

get

 Receba informações sobre uma única viagem.
Extrai todas as viagens de um veículo específico.

update

 Atualiza dados de viagens.