Recurso: viagem
Metadados de viagem.
Representação JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Campos | |
---|---|
name |
Apenas saída. Use o formato "providers/{provider}/trips/{trip}". |
vehicleId |
ID do veículo que faz essa viagem. |
tripStatus |
Status atual da viagem. |
tripType |
O tipo de viagem. |
pickupPoint |
Local onde o cliente indica que ele será retirado. |
actualPickupPoint |
Somente entrada. O local real quando e onde o cliente foi retirado. Este campo serve para o fornecedor enviar feedback sobre as informações de retirada. |
actualPickupArrivalPoint |
Somente entrada. A hora e o local reais de chegada do motorista no ponto de embarque. Este campo serve para o fornecedor enviar feedback sobre informações reais de chegada ao ponto de embarque. |
pickupTime |
Apenas saída. A hora futura estimada em que os passageiros embarcarão ou a hora real em que eles foram embarcados. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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, não haverá suporte para viagens compartilhadas. |
intermediateDestinationsVersion |
Indica a última vez que o Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
intermediateDestinationIndex |
Quando |
actualIntermediateDestinationArrivalPoints[] |
Somente entrada. A hora e o local reais de chegada do motorista em um destino intermediário. Este campo serve para o provedor fornecer feedback sobre informações reais de chegada em destinos intermediários. |
actualIntermediateDestinations[] |
Somente 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 enviar feedback sobre informações reais de embarque em destinos intermediários. |
dropoffPoint |
Local onde o cliente indica que será deixado. |
actualDropoffPoint |
Somente 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 desembarque. |
dropoffTime |
Apenas saída. A hora futura estimada em que os passageiros desembarcam no destino final ou a hora real em que desembarcam. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
remainingWaypoints[] |
Apenas saída. O caminho completo do local atual até o ponto de desembarque, inclusive. Esse caminho pode incluir waypoints de outras viagens. |
vehicleWaypoints[] |
Este campo permite a ordenação manual dos waypoints da viagem. Ele contém todos os waypoints restantes do veículo atribuído, além dos waypoints de embarque e desembarque dessa viagem. Se a viagem não tiver sido atribuída a um veículo, o Fleet Engine vai ignorar esse campo. Por motivos de privacidade, esse campo só é preenchido pelo servidor nas chamadas |
route[] |
Apenas saída. Trajeto previsto para esta viagem até a primeira entrada nos Waypoints restantes. O primeiro waypoint pode pertencer a uma viagem diferente. |
currentRouteSegment |
Apenas saída. Um caminho codificado para o próximo ponto de referência. Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor. Ainda não há suporte para decodificação. |
currentRouteSegmentVersion |
Apenas saída. Indica a última vez que o trajeto foi modificado. Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor. |
currentRouteSegmentTrafficVersion |
Apenas saída. Indica a última vez que o Observação: este campo é destinado apenas para uso do SDK do Driver e do SDK do consumidor. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
currentRouteSegmentEndPoint |
Apenas saída. O waypoint onde |
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 RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
remainingTimeToFirstWaypoint |
Apenas saída. A duração do retorno dos dados de viagem ao horário em 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 RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
remainingWaypointsRouteVersion |
Apenas saída. Indica a última vez que Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 relatado do veículo ao longo do trajeto. |
lastLocationSnappable |
Apenas saída. Indica se o |
view |
O subconjunto de campos "Viagem" preenchidos e como eles devem ser interpretados. |
TripStatus
O status de uma viagem que indica sua progressão.
Enums | |
---|---|
UNKNOWN_TRIP_STATUS |
Padrão, usada 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 do ponto de desembarque). |
ENROUTE_TO_DROPOFF |
O motorista pegou o passageiro e está a caminho do próximo destino. |
COMPLETE |
O passageiro foi desembarcado 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 ocorreu uma parada (embarque/desembarque).
Representação JSON |
---|
{
"point": {
object ( |
Campos | |
---|---|
point |
Obrigatório. Indica o local real. |
timestamp |
Indica quando a parada aconteceu. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
stopTime |
Somente entrada. Obsoleto. Use o campo de carimbo de data/hora. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
TripView
Seletor de diferentes conjuntos de campos "Viagem" em uma resposta trips.get
. Consulte o contexto em AIP-157 (em inglês). Outras visualizações provavelmente serão incluídas.
Enums | |
---|---|
TRIP_VIEW_UNSPECIFIED |
O valor padrão. Para compatibilidade com versões anteriores, a API usará uma visualização do SDK por padrão. Para garantir a estabilidade e o suporte, aconselhamos os clientes a selecionar um TripView diferente de SDK . |
SDK |
Inclui campos que podem não ser interpretáveis ou compatíveis com o uso de bibliotecas disponíveis publicamente. |
JOURNEY_SHARING_V1S |
Os campos de viagem são preenchidos para o caso de uso do Compartilhamento de jornada. Essa visualização é destinada a comunicações de servidor para servidor. |
Métodos |
|
---|---|
|
Cria uma viagem no Fleet Engine e a retorna. |
|
Veja informações sobre uma única viagem. |
|
Confira todas as viagens de um veículo específico. |
|
Atualiza os dados da viagem. |