Package maps.fleetengine.v1

BatteryStatus

Estado de la batería (si está completa o en carga, etcétera)

PowerSource

Estado de la fuente de alimentación de la batería.

float

Porcentaje actual de batería [0-100].

SpeedReadingInterval

Es la velocidad del tráfico a lo largo de la ruta desde el punto de referencia anterior hasta el punto de referencia actual.

string

Es la ruta que el conductor toma desde el punto de referencia anterior hasta el punto de referencia actual. Esta ruta tiene puntos de referencia para que los clientes puedan mostrar marcadores de tráfico a lo largo de la ruta (consulta speed_reading_interval). Aún no se admite la decodificación.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}. 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.

string

Obligatorio. ID de viaje único. Sujeto a las siguientes restricciones:

• Debe ser una cadena Unicode válida.
• Tiene un límite de 64 caracteres.
• Se normalizó según el Formato de normalización C de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: '/', ':', '?', ',' o '#'.

Trip

Obligatorio. Es la entidad de viaje que se creará.

Cuando crees un viaje, deberás completar los siguientes campos:

• trip_type
• pickup_point

Se usarán los siguientes campos si los proporcionas:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Se ignoran todos los demás campos de viaje. Por ejemplo, todos los viajes comienzan con un trip_status de NEW, incluso si pasas un trip_status de CANCELED en la solicitud de creación.

Solo los viajes de EXCLUSIVE admiten intermediate_destinations.

Cuando se establece vehicle_id para un viaje compartido, debes proporcionar la lista de Trip.vehicle_waypoints para especificar el orden de los puntos de referencia restantes del vehículo. De lo contrario, el orden de los puntos de referencia será indeterminado.

Cuando especificas Trip.vehicle_waypoints, la lista debe contener todos los puntos de referencia restantes de los viajes del vehículo, sin puntos de referencia adicionales. Debes ordenar estos puntos de referencia de modo que, para un viaje determinado, el punto de partida esté antes de los destinos intermedios y todos los destinos intermedios estén antes del punto de destino. Los puntos de referencia de un viaje de EXCLUSIVE no deben intercalarse con ningún otro viaje.

Se usan los campos trip_id, waypoint_type y location, y se ignoran todos los demás campos de TripWaypoint en vehicle_waypoints.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}. 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.

string

Obligatorio. ID de vehículo único. Sujeto a las siguientes restricciones:

• Debe ser una cadena Unicode válida.
• Tiene un límite de 64 caracteres.
• Se normalizó según el Formato de normalización C de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: '/', ':', '?', ',' o '#'.

Vehicle

Obligatorio. La entidad Vehicle que se creará. Cuando crees un vehículo, se requerirán los siguientes campos:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Cuando se crea un vehículo, se ignoran los siguientes campos:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Todos los demás campos son opcionales y se usan si se proporcionan.

LocationPowerSaveMode

Cómo se configuran las funciones de ubicación para que se comporten en el dispositivo cuando el ahorro de batería está activado

bool

Indica si el dispositivo está en modo de ahorro de energía.

bool

Indica si el dispositivo está en un estado interactivo.

BatteryInfo

Información sobre el estado de la batería.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

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.

TripView

Es el subconjunto de campos de viaje que se deben mostrar y su interpretación.

Timestamp

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.

Timestamp

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 remaining_waypoints no se establecen en la respuesta. Si no se especifica este campo, siempre se recupera remaining_waypoints.

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.

Timestamp

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

Timestamp

Indica la marca de tiempo mínima (excluyente) 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 remaining_waypoints_route_version, el tráfico y la ruta de acceso siempre se recuperan.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}/vehicles/{vehicle}. 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.

Timestamp

Indica la marca de tiempo mínima (exclusiva) para la que se recupera Vehicle.current_route_segment. Si la ruta no cambia desde esta marca de tiempo, el campo current_route_segment no se establece en la respuesta. Si no se especifica un valor mínimo, siempre se recupera current_route_segment.

Timestamp

Indica la marca de tiempo mínima (exclusiva) para la que se recuperan los datos de Vehicle.waypoints. Si los puntos de referencia no se modificaron desde esta marca de tiempo, los datos de vehicle.waypoints no se establecen en la respuesta. Si no se especifica este campo, siempre se recupera vehicle.waypoints.

string

Obligatorio. Código de país o región de CLDR. Por ejemplo, US para Estados Unidos o IN para India.

string

El último dígito de la matrícula o "-1" para indicar que no hay un valor numérico en la matrícula.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}. 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.

int32

Es la cantidad máxima de vehículos que se mostrarán. Valor predeterminado: 100.

string

Es el valor de next_page_token que proporciona una llamada anterior a ListVehicles para que puedas paginar por grupos de vehículos. El valor no se define si los criterios de filtro de la solicitud no son los mismos que los criterios de filtro de la llamada anterior a ListVehicles.

Int32Value

Especifica la capacidad mínima requerida del vehículo. Todos los vehículos que se muestren tendrán un maximum_capacity mayor o igual que este valor. Si se establece, debe ser mayor o igual que 0.

TripType

Restringe la respuesta a los vehículos que admiten al menos uno de los tipos de viaje especificados.

Duration

Restringe la respuesta a los vehículos que enviaron actualizaciones de ubicación a Fleet Engine dentro de la duración especificada. Los vehículos detenidos que aún transmiten sus ubicaciones no se consideran inactivos. Si está presente, debe ser una duración positiva válida.

Category

Obligatorio. Restringe la respuesta a los vehículos con una de las categorías de tipo especificadas. No se permite UNKNOWN.

string

Los llamadores pueden formar operaciones lógicas complejas con cualquier combinación de los campos required_attributes, required_one_of_attributes y required_one_of_attribute_sets.

required_attributes es una lista; required_one_of_attributes usa un mensaje que permite una lista de listas. En conjunto, los dos campos permiten la composición de esta expresión:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Restringe la respuesta a los vehículos con los atributos especificados. Este campo es una operación de conjunción/Y. Se permite un máximo de 50 atributos obligatorios. Esto coincide con la cantidad máxima de atributos permitidos en un vehículo. Cada cadena repetida debe tener el formato "clave:valor".

string

Restringe la respuesta a los vehículos con al menos uno de los atributos especificados en cada VehicleAttributeList. Dentro de cada lista, un vehículo debe coincidir con al menos uno de los atributos. Este campo es una operación inclusiva de disyunción/O en cada VehicleAttributeList y una operación de conjunción/Y en toda la colección de VehicleAttributeList. Cada cadena repetida debe tener el formato "clave1:valor1|clave2:valor2|clave3:valor3".

string

required_one_of_attribute_sets proporciona funcionalidad adicional.

De manera similar a required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas, lo que permite expresiones como esta:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Restringe la respuesta a los vehículos que coinciden con todos los atributos de un VehicleAttributeList. Dentro de cada lista, un vehículo debe coincidir con todos los atributos. Este campo es una operación de conjunción/AND en cada VehicleAttributeList y una operación de disyunción/OR inclusiva en toda la colección de VehicleAttributeList. Cada cadena repetida debe tener el formato "clave1:valor1|clave2:valor2|clave3:valor3".

VehicleState

Restringe la respuesta a los vehículos que tienen este estado.

bool

Solo muestra los vehículos con viajes actuales.

string

Opcional. Es una consulta de filtro que se aplica cuando se crean fichas de vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis de filtro.

Este campo está diseñado para reemplazar los campos required_attributes, required_one_of_attributes y required_one_of_attributes_sets. Si se especifica un valor no vacío aquí, los siguientes campos deben estar en blanco: required_attributes, required_one_of_attributes y required_one_of_attributes_sets.

Este filtro funciona como una cláusula AND con otras restricciones, como vehicle_state o on_trip_only.

Ten en cuenta que las únicas consultas admitidas son sobre atributos de vehículos (por ejemplo, attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). La cantidad máxima de restricciones permitidas en una consulta de filtro es de 50.

Además, todos los atributos se almacenan como cadenas, por lo que las únicas comparaciones admitidas con los atributos son las comparaciones de cadenas. Para compararlos con valores numéricos o booleanos, los valores deben incluirse entre comillas de forma explícita para que se traten como cadenas (por ejemplo, attributes.<key> = "10" o attributes.<key> = "true").

Viewport

Opcional. Es un filtro que limita los vehículos que se muestran a aquellos cuya última ubicación conocida estaba en el área rectangular definida por el viewport.

Vehicle

Vehículos que coinciden con los criterios de la solicitud La cantidad máxima de vehículos que se muestra está determinada por el campo page_size de la solicitud.

string

Es un token para recuperar la siguiente página de vehículos o dejarlo vacío si no hay más vehículos que cumplan con los criterios de la solicitud.

int64

Obligatorio. Es la cantidad total de vehículos que coinciden con los criterios de la solicitud en todas las páginas.

string

Obligatorio. Debe tener el formato providers/{provider}/billableTrips/{billable_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.

string

Obligatorio. Código de país de dos letras del país donde se realiza el viaje. El precio se define según el código de país.

BillingPlatformIdentifier

La plataforma en la que se emitió la solicitud

string

Son los identificadores que se relacionan directamente con el viaje que se informa. Por lo general, son IDs (por ejemplo, IDs de sesión) de operaciones de reserva anticipada que se realizan antes de que el ID de viaje esté disponible. La cantidad de related_ids está limitada a 50.

SolutionType

Es el tipo de solución de productos de GMP (por ejemplo, ON_DEMAND_RIDESHARING_AND_DELIVERIES) que se usó para el viaje informado.

string

Es el código de idioma BCP-47, como en-US o sr-Latn. Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si no se especifica ninguno, la respuesta puede estar en cualquier idioma, con preferencia por el inglés si existe ese nombre. Ejemplo de valor de campo: en-US.

string

Obligatorio. Es el código de región de CLDR de la región donde se originó la solicitud. Ejemplo de valor de campo: US.

string

Es la versión del SDK de llamada, si corresponde. El formato de la versión es “major.minor.patch”, por ejemplo, 1.1.2.

string

Es la versión del sistema operativo en el que se ejecuta el SDK de llamada. Ejemplos de valores de campo: 4.4.1, 12.1.

string

Es el modelo del dispositivo en el que se ejecuta el SDK de llamada. Ejemplos de valores de campo: iPhone12,1, SM-G920F.

SdkType

Es el tipo de SDK que envía la solicitud.

string

Es la versión del MapSDK de la que depende el SDK de llamada, si corresponde. El formato de la versión es “major.minor.patch”, por ejemplo, 5.2.1.

string

Es la versión del NavSDK de la que depende el SDK de llamada, si corresponde. El formato de la versión es “major.minor.patch”, por ejemplo, 2.1.0.

Platform

Es la plataforma del SDK que realiza la llamada.

string

Es el fabricante del dispositivo Android desde el SDK de llamada. Solo se aplica a los SDK de Android. Ejemplo de valor de campo: Samsung.

int32

Es el nivel de API de Android del SDK que realiza la llamada, solo aplicable a los SDKs de Android. Ejemplo de valor de campo: 23.

string

Es un ID opcional que se puede proporcionar para registrar la solicitud y así identificarla.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}. 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.

string

Es el vehículo asociado con los viajes de la solicitud. Si no se especifica, los viajes que se muestran no contienen lo siguiente:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Si se establece como verdadero, la respuesta incluye los viajes que influyen en la ruta de un conductor.

int32

Si no se establece, el servidor decide la cantidad de resultados que se mostrarán.

string

Establece este valor en un valor que se haya mostrado anteriormente en SearchTripsResponse para continuar desde los resultados anteriores.

Duration

Si se especifica, muestra los viajes que no se actualizaron después de la hora (current - minimum_staleness).

Trip

Es la lista de viajes del vehículo solicitado.

string

Pasa este token en SearchTripsRequest para desplazarte por los resultados de la lista. La API muestra una lista de viajes en cada llamada y, cuando no quedan más resultados, la lista de viajes está vacía.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}. 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.

TerminalLocation

Obligatorio. El punto de partida cerca del que se debe realizar la búsqueda

TerminalLocation

La ubicación de destino del cliente El campo es obligatorio si trip_types contiene TripType.SHARED.

int32

Obligatorio. Define el radio de búsqueda de vehículos alrededor del punto de partida. Solo se mostrarán los vehículos dentro del radio de búsqueda. El valor debe estar entre 400 y 10,000 metros (inclusive).

int32

Obligatorio. Especifica la cantidad máxima de vehículos que se mostrarán. El valor debe estar entre 1 y 50 (inclusive).

int32

Obligatorio. Especifica la cantidad de pasajeros que se tienen en cuenta para un viaje. El valor debe ser mayor o igual que uno. El conductor no se considera en el valor de capacidad.

TripType

Obligatorio. Representa el tipo de viaje propuesto. Debe incluir exactamente un tipo. No se permite UNKNOWN_TRIP_TYPE. Restringe la búsqueda solo a los vehículos que admiten ese tipo de viaje.

Duration

Limita la búsqueda solo a los vehículos que hayan enviado actualizaciones de ubicación a Fleet Engine dentro del período especificado. Los vehículos detenidos que aún transmiten sus ubicaciones no se consideran inactivos. Si no se establece este campo, el servidor usa cinco minutos como valor predeterminado.

VehicleType

Obligatorio. Restringe la búsqueda a vehículos con uno de los tipos especificados. Se debe especificar al menos un tipo de vehículo. No se permiten VehicleTypes con una categoría de UNKNOWN.

VehicleAttribute

Los llamadores pueden formar operaciones lógicas complejas con cualquier combinación de los campos required_attributes, required_one_of_attributes y required_one_of_attribute_sets.

required_attributes es una lista; required_one_of_attributes usa un mensaje que permite una lista de listas. En conjunto, los dos campos permiten la composición de esta expresión:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Restringe la búsqueda solo a los vehículos con los atributos especificados. Este campo es una operación de conjunción/Y. Se permite un máximo de 50 atributos obligatorios. Esto coincide con la cantidad máxima de atributos permitidos en un vehículo.

VehicleAttributeList

Restringe la búsqueda solo a los vehículos con al menos uno de los atributos especificados en cada VehicleAttributeList. Dentro de cada lista, un vehículo debe coincidir con al menos uno de los atributos. Este campo es una operación inclusiva de disyunción/O en cada VehicleAttributeList y una operación de conjunción/Y en toda la colección de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets proporciona funcionalidad adicional.

De manera similar a required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas, lo que permite expresiones como esta:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Restringe la búsqueda solo a los vehículos con todos los atributos en un VehicleAttributeList. Dentro de cada lista, un vehículo debe coincidir con todos los atributos. Este campo es una operación de conjunción/AND en cada VehicleAttributeList y una operación de disyunción/OR inclusiva en toda la colección de VehicleAttributeList.

VehicleMatchOrder

Obligatorio. Especifica el criterio de ordenamiento deseado para los resultados.

bool

Indica si los vehículos con un solo viaje activo son aptos para esta búsqueda. Este campo solo se usa cuando no se especifica current_trips_present. Cuando no se especifica current_trips_present y este campo es false, los vehículos con viajes asignados se excluyen de los resultados de la búsqueda. Cuando no se especifica current_trips_present y este campo es true, los resultados de la búsqueda pueden incluir vehículos con un viaje activo que tiene el estado ENROUTE_TO_DROPOFF. Cuando se especifica current_trips_present, este campo no se puede establecer como verdadero.

El valor predeterminado es false.

string

Indica el viaje asociado con este SearchVehicleRequest.

CurrentTripsPresent

Indica si los vehículos con viajes activos son aptos para esta búsqueda. Se debe establecer en un valor que no sea CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type incluye SHARED.

string

Opcional. Es una consulta de filtro que se aplica cuando se buscan vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis de filtro.

Este campo está diseñado para reemplazar los campos required_attributes, required_one_of_attributes y required_one_of_attributes_sets. Si se especifica un valor no vacío aquí, los siguientes campos deben estar en blanco: required_attributes, required_one_of_attributes y required_one_of_attributes_sets.

Este filtro funciona como una cláusula AND con otras restricciones, como minimum_capacity o vehicle_types.

Ten en cuenta que las únicas consultas admitidas son sobre atributos de vehículos (por ejemplo, attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). La cantidad máxima de restricciones permitidas en una consulta de filtro es de 50.

Además, todos los atributos se almacenan como cadenas, por lo que las únicas comparaciones admitidas con los atributos son las comparaciones de cadenas. Para compararlos con valores numéricos o booleanos, los valores deben incluirse entre comillas de forma explícita para que se traten como cadenas (por ejemplo, attributes.<key> = "10" o attributes.<key> = "true").

VehicleMatch

Es la lista de vehículos que coinciden con los criterios de SearchVehiclesRequest, ordenados según el campo SearchVehiclesRequest.order_by.

int32

Es el índice inicial de este intervalo en la ruta. En JSON, cuando el índice es 0, el campo parece no estar propagado.

int32

Es el índice de finalización de este intervalo en la ruta. En JSON, cuando el índice es 0, el campo parece no estar propagado.

Speed

Velocidad del tráfico en este intervalo.

LatLng

Obligatorio. Indica la ubicación real.

Timestamp

Indica cuándo ocurrió la parada.

Timestamp

Solo entrada. Obsoleta. Usa el campo de marca de tiempo.

LatLng

Obligatorio. Indica la ubicación de un punto de referencia de un viaje.

TerminalPointId

Obsoleto: Especifica el campo point en su lugar.

string

Obsoleto: Especifica el campo point en su lugar.

string

Obsoleta.

WaypointType

Obsoleto: Vehicle.waypoint tendrá estos datos.

string

Obsoleta.

string

Obsoleta.

string

Obsoleta.

VisualTrafficReportPolylineRendering

Renderización de polilínea de la velocidad del tráfico en todas las regiones a lo largo de un tramo del viaje de un cliente.

string

Solo salida. En el formato "providers/{provider}/trips/{trip}"

string

Es el ID del vehículo que realiza este viaje.

TripStatus

Es el estado actual del viaje.

TripType

Es el tipo de viaje.

TerminalLocation

Es la ubicación en la que el cliente indica que lo recogerán.

StopLocation

Solo entrada. La ubicación real en la que se recogió al cliente Este campo es para que el proveedor proporcione comentarios sobre la información de partida real.

StopLocation

Solo entrada. La hora y la ubicación reales de la llegada del conductor al punto de partida Este campo es para que el proveedor proporcione comentarios sobre la información real de llegada al punto de partida.

Timestamp

Solo salida. La hora futura estimada en la que se recogerán a los pasajeros o la hora real en la que se los recogió.

TerminalLocation

Son las paradas intermedias que solicita el viaje (además de la recogida y la llegada). Inicialmente, esta función no se admitirá para los viajes compartidos.

Timestamp

Indica la última vez que se modificó intermediate_destinations. Tu servidor debe almacenar en caché este valor y pasarlo en UpdateTripRequest cuando actualice intermediate_destination_index para garantizar que no se cambie intermediate_destinations.

int32

Cuando TripStatus es ENROUTE_TO_INTERMEDIATE_DESTINATION, es un número entre [0..N-1] que indica qué destino intermedio cruzará el vehículo a continuación. Cuando TripStatus es ARRIVED_AT_INTERMEDIATE_DESTINATION, es un número entre [0..N-1] que indica en qué destino intermedio se encuentra el vehículo. El proveedor establece este valor. Si no hay intermediate_destinations, este campo se ignora.

StopLocation

Solo entrada. Es la hora y la ubicación reales de la llegada del conductor a un destino intermedio. Este campo es para que el proveedor proporcione comentarios sobre la información de llegada real en los destinos intermedios.

StopLocation

Solo entrada. La hora y la ubicación reales en las que se recogió al cliente desde un destino intermedio. Este campo es para que el proveedor proporcione comentarios sobre la información de partida real en los destinos intermedios.

TerminalLocation

Es la ubicación donde el cliente indica que lo dejarán.

StopLocation

Solo entrada. La hora y la ubicación reales en las que se dejó al cliente. Este campo es para que el proveedor proporcione comentarios sobre la información real de la entrega.

Timestamp

Solo salida. La hora futura estimada en la que se dejarán a los pasajeros en el destino final o la hora real en la que se los dejó.

TripWaypoint

Solo salida. Es la ruta completa desde la ubicación actual hasta el punto de destino inclusive. Esta ruta podría incluir puntos de referencia de otros viajes.

TripWaypoint

Este campo admite el ordenamiento manual de los puntos de referencia del viaje. Contiene todos los puntos de referencia restantes del vehículo asignado, así como los puntos de partida y destino de este viaje. Si el viaje no se asignó a un vehículo, Fleet Engine ignora este campo. Por motivos de privacidad, el servidor solo propaga este campo en las llamadas a UpdateTrip y CreateTrip, NO en las llamadas a GetTrip.

LatLng

Solo salida. Es la ruta anticipada de este viaje a la primera entrada de remaining_waypoints. Ten en cuenta que el primer punto de referencia puede pertenecer a un viaje diferente.

string

Solo salida. Es una ruta codificada al siguiente punto de referencia.

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. Aún no se admite la decodificación.

Timestamp

Solo salida. Indica la última vez que se modificó la ruta.

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer.

ConsumableTrafficPolyline

Solo salida. Indica las condiciones de tráfico a lo largo de la current_route_segment cuando están disponibles.

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer.

Timestamp

Solo salida. Indica la última vez que se modificó current_route_segment_traffic.

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer.

TripWaypoint

Solo salida. El punto de referencia donde finaliza current_route_segment.

Int32Value

Solo salida. Es la distancia de conducción restante en el campo current_route_segment. El valor no se especifica si el viaje no está asignado a un vehículo, o si se completó o canceló.

Timestamp

Solo salida. La hora de llegada estimada al siguiente punto de referencia (la primera entrada en el campo remaining_waypoints) El valor no se especifica si el viaje no está asignado a un vehículo o si está inactivo (completo o cancelado).

Duration

Solo salida. Es la duración desde el momento en que se muestran los datos del viaje hasta la hora en Trip.eta_to_first_waypoint. El valor no se especifica si el viaje no está asignado a un vehículo o si está inactivo (completo o cancelado).

Timestamp

Solo salida. Indica la última vez que se cambió remaining_waypoints (se agregó, quitó o cambió un punto de referencia).

Timestamp

Solo salida. Indica la última vez que se modificaron remaining_waypoints.path_to_waypoint y remaining_waypoints.traffic_to_waypoint. Tu app cliente debe almacenar en caché este valor y pasarlo en GetTripRequest para garantizar que las rutas y el tráfico de remaining_waypoints solo se devuelvan si se actualizan.

int32

Inmutable. Indica la cantidad de pasajeros en este viaje y no incluye al conductor. Un vehículo debe tener capacidad disponible para que se muestre en una respuesta SearchVehicles.

VehicleLocation

Solo salida. Indica la última ubicación registrada del vehículo a lo largo de la ruta.

bool

Solo salida. Indica si el last_location del vehículo se puede ajustar al current_route_segment. Es falso si last_location o current_route_segment no existen. Fleet Engine lo calcula. Se ignorarán las actualizaciones de los clientes.

TripView

Es el subconjunto de campos de viaje que se propagan y cómo se deben interpretar.

TerminalLocation

Es la ubicación de este punto de referencia.

string

Es el viaje asociado a este punto de referencia.

WaypointType

El rol que desempeña este punto de referencia en este viaje, como punto de partida o destino

LatLng

Es la ruta desde el punto de referencia anterior hasta el punto de referencia actual. No se define para el primer punto de referencia de una lista. Este campo solo se propaga cuando se solicita.

string

Es la ruta codificada desde el punto de referencia anterior hasta el punto de referencia actual.

Nota: Este campo solo está diseñado para que lo usen el SDK de Driver y el SDK de Consumer. Aún no se admite la decodificación.

ConsumableTrafficPolyline

Las condiciones de tráfico a lo largo de la ruta hacia este punto de referencia Ten en cuenta que el tráfico solo está disponible para los clientes de la solución de viajes y entregas de Google Maps Platform.

Int32Value

Es la distancia de la ruta desde el punto de referencia anterior hasta el punto de referencia actual. No se define para el primer punto de referencia de una lista.

Timestamp

Es la hora estimada de llegada a este punto de referencia. No se define para el primer punto de referencia de una lista.

Duration

Es el tiempo de viaje desde el punto de referencia anterior hasta este punto. No se define para el primer punto de referencia de una lista.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

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

Trip

Obligatorio. Es el viaje asociado con la actualización.

El motor de flotas mantiene los siguientes campos. No los actualices con Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Cuando actualizas el Trip.vehicle_id de un viaje compartido, debes proporcionar la lista de Trip.vehicle_waypoints para especificar el orden de los puntos de referencia restantes; de lo contrario, el orden será indeterminado.

Cuando especificas Trip.vehicle_waypoints, la lista debe contener todos los puntos de referencia restantes de los viajes del vehículo, sin puntos de referencia adicionales. Debes ordenar estos puntos de referencia de modo que, para un viaje determinado, el punto de partida esté antes de los destinos intermedios y todos los destinos intermedios estén antes del punto de destino. Los puntos de referencia de un viaje de EXCLUSIVE no deben intercalarse con ningún otro viaje. Se usan los campos trip_id, waypoint_type y location, y se ignoran todos los demás campos de TripWaypoint en vehicle_waypoints.

Para evitar una condición de carrera en los viajes con varios destinos, debes proporcionar Trip.intermediate_destinations_version cuando actualices el estado del viaje a ENROUTE_TO_INTERMEDIATE_DESTINATION. El Trip.intermediate_destinations_version que se pasa debe ser coherente con la versión de Fleet Engine. De lo contrario, la solicitud fallará.

FieldMask

Obligatorio. Es la máscara de campo que indica qué campos de Trip se deben actualizar. update_mask debe contener al menos un campo.

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}/vehicles/{vehicle}. 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.

VehicleAttribute

Obligatorio. Son los atributos del vehículo que se actualizarán. Los atributos que no se mencionan no se alteran ni se quitan.

VehicleAttribute

Obligatorio. La lista completa actualizada de los atributos de los vehículos, incluidos los atributos nuevos, alterados y sin cambios

RequestHeader

El encabezado de solicitud estándar de Fleet Engine.

string

Obligatorio. Debe tener el formato providers/{provider}/vehicles/{vehicle}. {provider} 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.

Vehicle

Obligatorio. Los valores de la entidad Vehicle que se aplicarán Cuando se actualiza un Vehicle, es posible que no se actualicen los siguientes campos, ya que el servidor los administra.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Si se actualiza el campo attributes, todos los atributos del vehículo se reemplazan por los atributos proporcionados en la solicitud. Si quieres actualizar solo algunos atributos, consulta el método UpdateVehicleAttributes.

Del mismo modo, el campo waypoints se puede actualizar, pero debe contener todos los puntos de referencia que se encuentran actualmente en el vehículo y no otros.

FieldMask

Obligatorio. Es una máscara de campo que indica qué campos de Vehicle se deben actualizar. Se debe proporcionar al menos un nombre de campo.

string

Solo salida. Es el nombre único de este vehículo. El formato es providers/{provider}/vehicles/{vehicle}.

VehicleState

Es el estado del vehículo.

TripType

Son los tipos de viajes que admite este vehículo.

string

Solo salida. Es la lista de trip_id de los viajes asignados actualmente a este vehículo.

VehicleLocation

Es la última ubicación informada del vehículo.

int32

Es la cantidad total de pasajeros que puede transportar el vehículo. El conductor no se considera en este valor. Este valor debe ser mayor o igual que uno.

VehicleAttribute

Es una lista de atributos del vehículo. Un vehículo puede tener un máximo de 100 atributos, y cada uno debe tener una clave única.

VehicleType

Obligatorio. Es el tipo de vehículo. Se puede usar para filtrar vehículos en los resultados de SearchVehicles. También influye en los cálculos de la hora de llegada estimada y la ruta.

LicensePlate

Información de la matrícula del vehículo.

TerminalLocation

Obsoleto: Usa Vehicle.waypoints en su lugar.

string

Es la polilínea que especifica la ruta que la app del conductor tiene la intención de tomar hasta el siguiente punto de referencia. Esta lista también se muestra en Trip.current_route_segment para todos los viajes activos asignados al vehículo.

Nota: Este campo solo está diseñado para que lo use el SDK del controlador. Aún no se admite la decodificación.

TrafficPolylineData

Solo entrada. Fleet Engine usa esta información para mejorar el uso compartido de viajes. Nota: Este campo solo está diseñado para que lo use el SDK del controlador.

Timestamp

Solo salida. Hora en la que se estableció current_route_segment. El cliente puede almacenarlo y pasarlo en solicitudes GetVehicle futuras para evitar que se muestren rutas que no hayan cambiado.

TripWaypoint

El punto de referencia donde finaliza current_route_segment. Los conductores pueden proporcionar esta información en las llamadas a UpdateVehicle, ya sea como un punto de referencia de viaje completo, un LatLng de punto de referencia o como el último LatLng de la current_route_segment. Luego, Fleet Engine hará todo lo posible para interpolar un punto de referencia real si no se especifica por completo. Este campo se ignora en las llamadas a UpdateVehicle, a menos que también se especifique current_route_segment.

Int32Value

Es la distancia de conducción restante para el current_route_segment. Este valor también se muestra en Trip.remaining_distance_meters para todos los viajes activos asignados al vehículo. El valor no se especifica si el campo current_route_segment está vacío.

Timestamp

La hora de llegada estimada a la primera entrada del campo waypoints. El valor no se especifica si el campo waypoints o el campo Vehicle.current_route_segment están vacíos.

Cuando se actualiza un vehículo, remaining_time_seconds tiene prioridad sobre eta_to_first_waypoint en la misma solicitud.

Int32Value

Solo entrada. Es el tiempo de conducción restante para el current_route_segment. El valor no se especifica si el campo waypoints o el campo Vehicle.current_route_segment están vacíos. Este valor debe coincidir con eta_to_first_waypoint - current_time si todas las partes usan el mismo reloj.

Cuando se actualiza un vehículo, remaining_time_seconds tiene prioridad sobre eta_to_first_waypoint en la misma solicitud.

TripWaypoint

Los puntos de referencia restantes asignados a este vehículo.

Timestamp

Solo salida. Es la última vez que se actualizó el campo waypoints. Los clientes deben almacenar en caché este valor y pasarlo en GetVehicleRequest para garantizar que el campo waypoints solo se muestre si se actualiza.

bool

Indica si el conductor acepta viajes consecutivos. Si es true, SearchVehicles puede incluir el vehículo, incluso si está asignado a un viaje. El valor predeterminado es false.

NavigationStatus

Es el estado de navegación del vehículo.

DeviceSettings

Solo entrada. Información sobre la configuración del dispositivo móvil que usa el conductor.

Category

Categoría de tipo de vehículo

string

Es la clave del atributo. Las claves no pueden contener el carácter dos puntos (:).

string

Es el valor del atributo.

string

Valor del atributo escrito como cadena.

Nota: Esto es idéntico al campo value, que eventualmente dejará de estar disponible. Para los métodos de creación o actualización, se puede usar cualquiera de los campos, pero se recomienda usar string_value. Si se configuran string_value y value, deben ser idénticos o se arrojará un error. Ambos campos se propagan en las respuestas.

bool

Valor de atributo escrito en formato booleano.

double

Valor de atributo escrito dos veces.

VehicleAttribute

Es una lista de los atributos de esta colección.

LatLng

Es la ubicación del vehículo. Cuando se envía a Fleet Engine, la ubicación del vehículo es una ubicación GPS. Cuando la recibes en una respuesta, la ubicación del vehículo puede ser una ubicación GPS, una ubicación complementaria o alguna otra ubicación estimada. La fuente se especifica en location_sensor.

DoubleValue

Obsoleto: Usa latlng_accuracy en su lugar.

DoubleValue

Precisión de location en metros como radio.

Int32Value

Es la dirección en la que se mueve el vehículo en grados. 0 representa el norte. El rango válido es [0,360).

DoubleValue

Obsoleto: Usa heading_accuracy en su lugar.

DoubleValue

Precisión de heading en grados.

DoubleValue

Es la altitud en metros sobre WGS84.

DoubleValue

Obsoleto: Usa altitude_accuracy en su lugar.

DoubleValue

Precisión de altitude en metros

Int32Value

Es la velocidad del vehículo en kilómetros por hora. Obsoleto: Usa speed en su lugar.

DoubleValue

Velocidad del vehículo en metros por segundo

DoubleValue

Precisión de speed en metros por segundo.

Timestamp

Es la hora en la que el sensor informó location según su reloj.

Timestamp

Solo salida. Es la hora en la que el servidor recibió la información de ubicación.

LocationSensor

Es el proveedor de datos de ubicación (por ejemplo, GPS).

BoolValue

Indica si location está ajustado a una ruta.

BoolValue

Solo entrada. Indica si el sensor de GPS está habilitado en el dispositivo móvil.

Int32Value

Solo entrada. Es el tiempo (en segundos) desde que se envió esta ubicación por primera vez al servidor. Este valor será cero para la primera actualización. Si la hora es desconocida (por ejemplo, cuando se reinicia la app), este valor se restablece a cero.

Int32Value

Solo entrada. Obsoleto: Ahora se usan otros indicadores para determinar si una ubicación está inactiva.

LatLng

Ubicación sin procesar del vehículo (sin procesar por el generador de imágenes de rutas)

Timestamp

Marca de tiempo asociada con la ubicación sin procesar.

LocationSensor

Es la fuente de la ubicación sin procesar. La configuración predeterminada es GPS.

DoubleValue

Precisión de raw_location como radio, en metros.

LatLng

Es la ubicación complementaria que proporciona la app de integración.

Timestamp

Marca de tiempo asociada con la ubicación complementaria.

LocationSensor

Es la fuente de la ubicación complementaria. La configuración predeterminada es CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Precisión de supplemental_location como radio, en metros.

bool

Obsoleto: Usa is_road_snapped en su lugar.

Vehicle

Obligatorio. Un vehículo que coincida con la solicitud

Timestamp

La hora de llegada estimada en automóvil del vehículo al punto de partida especificado en la solicitud. Un valor vacío indica que se produjo un error en el cálculo de la hora de llegada estimada del vehículo. Si SearchVehiclesRequest.include_back_to_back era true y este vehículo tiene un viaje activo, vehicle_pickup_eta incluye el tiempo necesario para completar el viaje activo actual.

Int32Value

Es la distancia entre la ubicación actual del vehículo y el punto de partida especificado en la solicitud, incluidos los puntos de partida o destino intermedios de los viajes existentes. Esta distancia comprende la distancia de conducción (ruta) calculada, más la distancia en línea recta entre el punto final de navegación y el punto de partida solicitado. (La distancia entre el punto de destino de la navegación y el punto de partida solicitado suele ser pequeña). Un valor vacío indica un error en el cálculo de la distancia.

Int32Value

Obligatorio. Es la distancia en línea recta entre el vehículo y el punto de partida especificado en la solicitud.

Timestamp

La hora de llegada estimada (ETA) en automóvil completa al punto de destino especificado en la solicitud. La hora de llegada estimada incluye las paradas en cualquier punto de referencia antes del dropoff_point especificado en la solicitud. El valor solo se propagará cuando se especifique un punto de entrega en la solicitud. Un valor vacío indica que se produjo un error al calcular la hora de llegada estimada.

Int32Value

Es la distancia de conducción (en metros) del vehículo desde el punto de partida hasta el punto de destino especificado en la solicitud. La distancia es solo entre los dos puntos y no incluye la ubicación del vehículo ni ningún otro punto que se deba visitar antes de que el vehículo visite el punto de partida o el de destino. El valor solo se propagará cuando se especifique un dropoff_point en la solicitud. Un valor vacío indica un error en el cálculo de la distancia del punto de partida al punto de destino especificado en la solicitud.

TripType

Obligatorio. Es el tipo de viaje de la solicitud que se usó para calcular la hora de llegada estimada al punto de partida.

Waypoint

Es la lista ordenada de puntos de referencia que se usa para calcular la hora de llegada estimada. La lista incluye la ubicación del vehículo, los puntos de partida de los viajes activos del vehículo y los puntos de partida proporcionados en la solicitud. Una lista vacía indica que se produjo un error en el cálculo de la hora de llegada estimada (ETA) del vehículo.

VehicleMatchType

Es el tipo de coincidencia de vehículo.

VehicleMatchOrder

Es el orden solicitado para ordenar las coincidencias de vehículos. Equivale a ordered_by.

VehicleMatchOrder

Es el orden solicitado para ordenar las coincidencias de vehículos. Equivale a requested_ordered_by.

RoadStretch

Opcional. Tramo de ruta que se debe renderizar a lo largo de la polilínea. Se garantiza que los tramos no se superpongan y no necesariamente abarcan toda la ruta.

Si no hay un tramo de ruta para aplicarle diseño, el cliente debe aplicar el predeterminado de la ruta.

Style

Obligatorio. Es el estilo que se aplicará.

int32

Obligatorio. El estilo se debe aplicar entre [offset_meters, offset_meters + length_meters).

int32

Obligatorio. Es la longitud de la ruta en la que se aplicará el estilo.

LatLng

Es la ubicación de este punto de referencia.

Timestamp

Es la hora estimada a la que el vehículo llegará a este punto de referencia.