Method: providers.trips.get

Obtén información sobre un solo viaje.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Debe tener el formato providers/{provider}/trips/{trip}. El proveedor debe ser el ID del proyecto (por ejemplo, sample-cloud-project) del proyecto de Google Cloud del que pertenece la cuenta de servicio que realiza esta llamada.

Parámetros de consulta

Parámetros
header

object (RequestHeader)

El encabezado de solicitud estándar de Fleet Engine.

view

enum (TripView)

El subconjunto de campos de Viaje que se debe mostrar y su interpretación.

currentRouteSegmentVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) para la que se recuperan los datos de Trip.route o Trip.current_route_segment. Si los datos de ruta no se modifican desde esta marca de tiempo, el campo de ruta no se establece en la respuesta. Si no se especifica un mínimo, los datos de la ruta se recuperan siempre.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

remainingWaypointsVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) para la que se recuperan los Trip.remaining_waypoints. Si no se modifican desde esta marca de tiempo, las remainingWaypoints no se establecen en la respuesta. Si no se especifica este campo, siempre se recupera remainingWaypoints.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

routeFormatType

enum (PolylineFormatType)

El formato de la ruta actual que se muestra: LAT_LNG_LIST_TYPE (en Trip.route) o ENCODED_POLYLINE_TYPE (en Trip.current_route_segment). El valor predeterminado es LAT_LNG_LIST_TYPE.

currentRouteSegmentTrafficVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) para la que se recupera Trip.current_route_segment_traffic. Si los datos de tráfico no se modifican desde esta marca de tiempo, el campo currentRouteSegmentTraffic no se establece en la respuesta. Si no se especifica un mínimo, los datos de tráfico siempre se recuperan. Ten en cuenta que el tráfico solo está disponible para los clientes de la solución On-Demand Rides & Deliveries.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

remainingWaypointsRouteVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) para la que se recuperan los datos de Trip.remaining_waypoints.traffic_to_waypoint y Trip.remaining_waypoints.path_to_waypoint. Si los datos no se modifican desde esta marca de tiempo, los campos anteriores no se establecen en la respuesta. Si no se especifica remainingWaypointsRouteVersion, el tráfico y la ruta de acceso siempre se recuperan.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Trip.

PolylineFormatType

Es el tipo de formato de polilínea.

Enumeraciones
UNKNOWN_FORMAT_TYPE El formato no se especifica o es desconocido.
LAT_LNG_LIST_TYPE Una lista de google.type.LatLng.
ENCODED_POLYLINE_TYPE Polilínea codificada con un algoritmo de compresión de polilíneas. Aún no se admite la decodificación.