Method: providers.trips.get

Receber 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 em que a conta de serviço que faz a chamada é membro.

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 de viagem que precisam 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 da rota não tiverem mudado desde esse carimbo de data/hora, o campo de rota não será definido na resposta. Se um mínimo não for especificado, os dados da rota serão sempre recuperados.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
remainingWaypointsVersion
(deprecated)

string (Timestamp format)

Descontinuado: Trip.remaining_waypoints são sempre recuperados. Use remainingWaypointsRouteVersion para controlar quando os dados Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint são recuperados.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
routeFormatType

enum (PolylineFormatType)

O formato da rota atual retornada, 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 tiverem mudado 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 só está disponível para clientes da solução de viagens e entregas sob demanda.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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.