Method: providers.trips.get

Veja 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 Trip.route ou Trip.current_route_segment são recuperados. Se os dados do trajeto não tiverem sido alterados desde esse carimbo de data/hora, o campo do trajeto não será definido na resposta. Se um mínimo não for especificado, os dados de trajeto serão sempre recuperados.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 são recuperados. Se eles não tiverem sido 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 RFC3339 UTC "Zulu", 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 foram alterados desde esse carimbo de data/hora, o campo currentRouteSegmentTraffic não é definido na resposta. Se um mínimo não for especificado, os dados de tráfego serão sempre recuperados. O tráfego só está disponível para clientes da solução de viagens e entregas sob demanda.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint são recuperados. Se os dados não tiverem sido alterados desde esse 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 RFC3339 UTC "Zulu", 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 polilinha. Ainda não há suporte para decodificação.