Method: providers.trips.get

Receba informações sobre uma única viagem.

Solicitação HTTP

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Precisa estar no formato providers/{provider}/trips/{trip}. O provedor precisa ser o ID do projeto (por exemplo, sample-cloud-project) do projeto do Google Cloud de que a conta de serviço que está fazendo a chamada faz parte.

Parâmetros de consulta

Parâmetros
header

object (RequestHeader)

O cabeçalho de solicitação padrão do Fleet Engine.
view

enum (TripView)

O subconjunto de campos "Trip" que devem ser retornados e a interpretação deles.
currentRouteSegmentVersion

string (Timestamp format)

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados de Trip.route ou Trip.current_route_segment são recuperados. Se os dados do trajeto não foram alterados desde o carimbo de data/hora, o campo "route" não é definido na resposta. Se um mínimo não for especificado, os dados do trajeto serão sempre recuperados.

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".
remainingWaypointsVersion

string (Timestamp format)

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Trip.remaining_waypoints é recuperado. Se eles não forem alterados desde esse carimbo de data/hora, os remainingWaypoints não serão definidos na resposta. Se esse campo não for especificado, remainingWaypoints será sempre recuperado.

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".
routeFormatType

enum (PolylineFormatType)

O formato do trajeto atual retornado, LAT_LNG_LIST_TYPE (em Trip.route) ou ENCODED_POLYLINE_TYPE (em Trip.current_route_segment). O padrão é LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Indica o carimbo de data/hora mínimo (exclusivo) para o qual Trip.current_route_segment_traffic é recuperado. Se os dados de tráfego não forem alterados desde esse carimbo de data/hora, o campo currentRouteSegmentTraffic não será definido na resposta. Se um mínimo não for especificado, os dados de tráfego serão sempre recuperados. O tráfego está disponível somente para clientes da solução de viagens e entregas sob demanda.

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)

Indica o carimbo de data/hora mínimo (exclusivo) para o qual os dados de Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint são recuperados. Se os dados não forem alterados desde o carimbo de data/hora, os campos acima não serão definidos na resposta. Se remainingWaypointsRouteVersion não for especificado, o tráfego e o caminho serão sempre recuperados.

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".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Trip.

PolylineFormatType

O tipo de formato de polilinha.

Enums
UNKNOWN_FORMAT_TYPE O formato não foi especificado ou é desconhecido.
LAT_LNG_LIST_TYPE Uma lista de google.type.LatLng.
ENCODED_POLYLINE_TYPE Uma polilinha codificada com um algoritmo de compactação de polilinhas. A decodificação ainda não está disponível.