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 es miembro 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)

Es 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) para la que se recuperan los datos de Trip.route o Trip.current_route_segment. Si los datos de la ruta no se modifican desde esta marca de tiempo, el campo de ruta no se establece en la respuesta. Si no se especifica un valor mínimo, los datos de la ruta siempre se recuperan.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

remainingWaypointsVersion

string (Timestamp format)

Indica la marca de tiempo mínima (exclusiva) para 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 recupera remainingWaypoints.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

routeFormatType

enum (PolylineFormatType)

Es 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) 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 valor 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.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 Es una polilínea codificada con un algoritmo de compresión de polilíneas. Aún no se admite la decodificación.