Recurso: viagem
Metadados de viagem.
Representação JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Campos | |
---|---|
name |
Apenas saída. No formato "providers/{provider}/trips/{trip}". |
vehicleId |
ID do veículo que está fazendo esta viagem. |
tripStatus |
Status atual da viagem. |
tripType |
O tipo da viagem. |
pickupPoint |
Local onde o cliente indica que será retirado. |
actualPickupPoint |
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 |
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 |
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: |
intermediateDestinations[] |
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 |
Indica a última vez que o Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
intermediateDestinationIndex |
Quando |
actualIntermediateDestinationArrivalPoints[] |
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[] |
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 |
Local em que o cliente indica que será deixado. |
actualDropoffPoint |
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 |
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: |
remainingWaypoints[] |
Apenas saída. Caminho completo do local atual até o ponto de desembarque. Esse caminho pode incluir waypoints de outras viagens. |
vehicleWaypoints[] |
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 |
route[] |
Apenas saída. Trajeto previsto para esta viagem até a primeira entrada em foundWaypoints. O primeiro waypoint pode pertencer a uma viagem diferente. |
currentRouteSegment |
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 |
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: |
currentRouteSegmentTraffic |
Apenas saída. Indica as condições de trânsito ao longo da Observação: esse campo é destinado somente para uso do SDK do Driver e do SDK de consumidor. |
currentRouteSegmentTrafficVersion |
Apenas saída. Indica a última vez que o 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: |
currentRouteSegmentEndPoint |
Apenas saída. O waypoint em que |
remainingDistanceMeters |
Apenas saída. A distância de carro restante no campo |
etaToFirstWaypoint |
Apenas saída. O HEC até o próximo waypoint (a primeira entrada no campo Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
remainingTimeToFirstWaypoint |
Apenas saída. A duração entre o momento em que os dados da viagem são retornados até o horário no Duração em segundos com até nove dígitos fracionários, terminando em " |
remainingWaypointsVersion |
Apenas saída. Indica a última vez que Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
remainingWaypointsRouteVersion |
Apenas saída. Indica a última vez que o Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
numberOfPassengers |
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 |
lastLocation |
Apenas saída. Indica o último local informado do veículo ao longo do trajeto. |
lastLocationSnappable |
Apenas saída. Indica se o |
view |
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 ( |
Campos | |
---|---|
point |
Obrigatório. Indica o local real. |
timestamp |
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: |
stopTime |
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: |
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 |
|
---|---|
|
Cria uma viagem no Fleet Engine e retorna a nova viagem. |
|
Receba informações sobre uma única viagem. |
|
Extrai todas as viagens de um veículo específico. |
|
Atualiza dados de viagens. |