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 forma parte 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 deben mostrar y su interpretación.

currentRouteSegmentVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) de 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 siempre se recuperan.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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) de la que se recuperan Trip.remaining_waypoints. Si no se modifican desde esta marca de tiempo, los remainingWaypoints no se establecen en la respuesta. Si no se especifica este campo, siempre se recuperará remainingWaypoints.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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) de 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 establecerá 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 las soluciones On-Demand Rides y Deliveries.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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) de 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 siempre se recuperan.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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.

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