Package maps.fleetengine.v1

BatteryStatus

Estado de la batería, ya sea completa o cargándose, 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 al actual.

string

La ruta que sigue el conductor desde el punto de referencia anterior hasta el actual. Esta ruta contiene 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 pertenece 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 una longitud máxima de 64 caracteres.
• Se normalizó de acuerdo con el formulario C de normalización de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: “/”, “:”, “?”, “,” o “'#'”.

Trip

Obligatorio. Entidad de viaje que se creará.

Cuando se crea un Viaje, se deben 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 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 se admiten intermediate_destinations viajes en EXCLUSIVE.

Cuando se configura vehicle_id para un viaje compartido, debes proporcionar la lista de Trip.vehicle_waypoints para especificar el orden de los puntos de referencia restantes para el vehículo; de lo contrario, el orden de estos puntos no será determinado.

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 se encuentre antes de los destinos intermedios y todos los destinos intermedios antecedan al punto de llegada. Los puntos de referencia de un viaje EXCLUSIVE no deben intercalarse con ningún otro viaje.

Se usarán los campos trip_id, waypoint_type y location, y se ignorará el resto de los campos TripWaypoint de 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 pertenece la cuenta de servicio que realiza esta llamada.

string

Obligatorio. Es el ID único del vehículo. Sujeto a las siguientes restricciones:

• Debe ser una cadena Unicode válida.
• Tiene una longitud máxima de 64 caracteres.
• Se normalizó de acuerdo con el formulario C de normalización de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: “/”, “:”, “?”, “,” o “'#'”.

Vehicle

Obligatorio. La entidad Vehículo que se creará. Cuando creas un vehículo, debes completar los siguientes campos:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Cuando creas 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

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

bool

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

bool

Indica si el dispositivo se encuentra en 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 pertenece la cuenta de servicio que realiza esta llamada.

TripView

El subconjunto de campos de Viaje que se debe 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 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.

Timestamp

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

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.

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 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 (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 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 pertenece 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 cambió desde esta marca de tiempo, el campo current_route_segment no se establece en la respuesta. Si no se especifica un 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 modifican 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. Es el 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 la matrícula no contiene ningún valor numérico.

• “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 pertenece la cuenta de servicio que realiza esta llamada.

int32

La cantidad máxima de vehículos que se devolverán. Valor predeterminado: 100.

string

El valor de next_page_token proporcionado por una llamada anterior a ListVehicles para que puedas paginar grupos de vehículos El valor no está definido si los criterios de filtro de la solicitud no son los mismos que los 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 estacionarios 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 tipos especificadas. No se permite UNKNOWN.

string

Los emisores pueden realizar 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 crear una lista de listas. En combinación, 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 conjunción/operación AND. 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 "key:value".

string

Restringe la respuesta a los vehículos con al menos uno de los atributos especificados en cada VehicleAttributeList. En cada lista, un vehículo debe coincidir con al menos uno de los atributos. Este campo es una operación OR de disyunción inclusiva en cada VehicleAttributeList y una operación AND en toda la colección de VehicleAttributeList. Cada cadena repetida debe tener el formato "key1:value1|key2:value2|key3:value3".

string

required_one_of_attribute_sets proporciona funciones adicionales.

Al igual que required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas y 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 en una VehicleAttributeList. En cada lista, un vehículo debe coincidir con todos los atributos. Este campo es una conjunción/operación AND en cada VehicleAttributeList y una operación de disyunción/OR inclusiva en la colección de VehicleAttributeList. Cada cadena repetida debe tener el formato "key1:value1|key2:value2|key3:value3".

VehicleState

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

bool

Solo devuelve los vehículos con los viajes actuales.

string

Opcional. Una búsqueda de filtro para aplicar cuando se publican vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis del filtro.

Este campo se diseñó para reemplazar los campos required_attributes, required_one_of_attributes y required_one_of_attributes_sets. Si se especifica aquí un valor que no esté vacío, los siguientes campos deben estar vacíos: 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 permitida en una consulta de filtro es de 50.

Además, todos los atributos se almacenan como cadenas, por lo que las únicas comparaciones admitidas para los atributos son las comparaciones de cadenas. Para comparar con valores numéricos o booleanos, los valores se deben entrecomillar de forma explícita para que se los trate como strings (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 fue en el área rectangular definida por el viewport.

Vehicle

Vehículos que coinciden con los criterios de la solicitud El campo page_size de la solicitud determina la cantidad máxima de vehículos que se muestran.

string

Token para recuperar la página siguiente de vehículos o vaciar si no hay más vehículos que cumplan con los criterios de la solicitud.

int64

Obligatorio. Cantidad total de vehículos que coinciden con los criterios de 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 pertenece la cuenta de servicio que realiza esta llamada.

string

Obligatorio. Es el 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

Es 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 los IDs (por ejemplo, los IDs de sesión) de las operaciones de reserva previa que se realizaron 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 usa para el viaje informado.

string

El código de idioma según la norma 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 para el inglés (si existe tal nombre). Ejemplo de valor de campo: en-US.

string

Obligatorio. Código regional de CLDR de la región donde se origina 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", ejemplo: 1.1.2.

string

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

string

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

SdkType

El tipo de SDK que envía la solicitud.

string

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

string

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

Platform

Plataforma del SDK que realiza la llamada.

string

Fabricante del dispositivo Android del SDK de llamada; solo se aplica a los SDK de Android. Ejemplo de valor de campo: Samsung.

int32

Nivel de API de Android del SDK de llamada, solo aplicable a los SDK de Android. Ejemplo de valor de campo: 23.

string

ID opcional que se puede proporcionar con fines de registro para identificar la solicitud.

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 pertenece la cuenta de servicio que realiza esta llamada.

string

El vehículo asociado con los viajes en la solicitud. Si no se especifica, los viajes devueltos no contendrán lo siguiente:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Si la estableces como verdadera, la respuesta incluirá los Viajes que influyen en la ruta del conductor.

int32

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

string

Establece esto en un valor que se mostró anteriormente en el SearchTripsResponse para continuar desde los resultados anteriores.

Duration

Si se especifica, muestra los viajes que no se actualizaron después del horario (current - minimum_staleness).

Trip

La lista de viajes del vehículo solicitado.

string

Pasa este token en SearchTripsRequest para navegar 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 queda 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 pertenece la cuenta de servicio que realiza esta llamada.

TerminalLocation

Obligatorio. El punto de partida para buscar.

TerminalLocation

El lugar de destino previsto del cliente. El campo es obligatorio si trip_types contiene TripType.SHARED.

int32

Obligatorio. Define el radio de búsqueda del vehículo alrededor del punto de partida. Solo se mostrarán 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 devolverán. El valor debe ser de 1 a 50 (inclusive).

int32

Obligatorio. Especifica la cantidad de pasajeros que se consideran para un viaje. El valor debe ser mayor o igual que uno. No se considera al controlador 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 a los vehículos que admiten ese tipo de viaje.

Duration

Restringe la búsqueda solo a aquellos vehículos que enviaron actualizaciones de ubicación a Fleet Engine dentro del período de duración especificado. Los vehículos estacionarios 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 la categoría UNKNOWN.

VehicleAttribute

Los emisores pueden realizar 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 crear una lista de listas. En combinación, 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 a los vehículos con los atributos especificados. Este campo es una conjunción/operación AND. 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 únicamente a los vehículos con al menos uno de los atributos especificados en cada VehicleAttributeList. En cada lista, un vehículo debe coincidir con al menos uno de los atributos. Este campo es una operación OR inclusiva en cada VehicleAttributeList y una operación AND en toda la colección de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets proporciona funciones adicionales.

De manera similar a required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas y 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 a los vehículos con todos los atributos en un VehicleAttributeList. En cada lista, un vehículo debe coincidir con todos los atributos. Este campo es una conjunción/operación AND en cada VehicleAttributeList y una operación de disyunción/OR inclusiva en la colección de VehicleAttributeList.

VehicleMatchOrder

Obligatorio. Especifica el criterio de orden 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. Si 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. Si no se especifica current_trips_present y el campo tiene el valor true, los resultados de la búsqueda pueden incluir vehículos con un viaje activo que tenga 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 un valor distinto de CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type incluye SHARED.

string

Opcional. Una búsqueda de filtro para aplicar cuando se buscan vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis del filtro.

Este campo se diseñó para reemplazar los campos required_attributes, required_one_of_attributes y required_one_of_attributes_sets. Si se especifica aquí un valor que no esté vacío, los siguientes campos deben estar vacíos: 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 permitida en una consulta de filtro es de 50.

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

VehicleMatch

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

int32

El índice inicial de este intervalo en la ruta. En JSON, cuando el índice es 0, el campo parecerá no propagado.

int32

El índice final de este intervalo en la ruta. En JSON, cuando el índice es 0, el campo parecerá no propagado.

Speed

La velocidad del tráfico en este intervalo.

LatLng

Obligatorio. Indica la ubicación real.

Timestamp

Indica cuándo se produjo 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 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

Una renderización de polilíneas que indica qué tan rápido es el tráfico para todas las regiones a lo largo de un tramo de viaje de un cliente.

string

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

string

ID del vehículo que realiza este viaje.

TripStatus

Estado actual del viaje.

TripType

El tipo de viaje.

TerminalLocation

Ubicación en la que el cliente indica que lo retirarán.

StopLocation

Solo entrada. La ubicación real del momento y el lugar en el que se recogió al cliente. Este campo permite que el proveedor proporcione comentarios sobre la información real de retiro.

StopLocation

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

Timestamp

Solo salida. Puede ser la hora estimada en el futuro a la que se recogerá a los pasajeros o la hora real en la que se buscaron.

TerminalLocation

Paradas intermedias en función de las solicitudes del viaje (además de los puntos de partida y destino). En un principio, esto no será compatible con los viajes compartidos.

Timestamp

Indica la última vez que se modificó el objeto 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, un número entre [0..N-1] que indica qué destino intermedio cruzará el vehículo. Cuando TripStatus es ARRIVED_AT_INTERMEDIATE_DESTINATION, 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, se ignora este campo.

StopLocation

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

StopLocation

Solo entrada. Indica la hora y la ubicación reales en que se recogió al cliente en un destino intermedio. Este campo permite que el proveedor proporcione comentarios sobre la información real de retiro en destinos intermedios.

TerminalLocation

Ubicación en la que el cliente indica que se bajará.

StopLocation

Solo entrada. La hora y la ubicación reales en que cuándo y dónde llegó al cliente. Este campo permite que el proveedor proporcione comentarios sobre la información real sobre el destino.

Timestamp

Solo salida. Puede ser la hora estimada en el futuro a la que se bajarán los pasajeros en el destino final o la hora real en la que se bajarán.

TripWaypoint

Solo salida. La ruta completa desde la ubicación actual hasta el punto de destino, inclusive. Esta ruta puede incluir puntos de referencia de otros viajes.

TripWaypoint

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

LatLng

Solo salida. Ruta prevista para este viaje a la primera entrada en otros puntos de referencia. Ten en cuenta que el primer punto de referencia puede pertenecer a un viaje diferente.

string

Solo salida. Una ruta codificada al siguiente punto de referencia.

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

Timestamp

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

Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores.

ConsumableTrafficPolyline

Solo salida. Indica las condiciones de tráfico en el current_route_segment cuando están disponibles.

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

Timestamp

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

Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores.

TripWaypoint

Solo salida. El punto de referencia donde termina current_route_segment.

Int32Value

Solo salida. La distancia en automóvil restante en el campo current_route_segment. El valor no se especifica si el viaje no está asignado a un vehículo o si el viaje se completa o se cancela.

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 el viaje está inactivo (completado o cancelado).

Duration

Solo salida. Es la duración desde 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 el viaje está inactivo (completado o cancelado).

Timestamp

Solo salida. Indica la última vez que se modificó remaining_waypoints (se agregó, se quitó o se 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 muestren si se actualizan.

int32

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

VehicleLocation

Solo salida. Indica la última ubicación informada 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. Falso si last_location o current_route_segment no existen. Fleet Engine lo calcula. Se ignorarán las actualizaciones de los clientes.

TripView

Subconjunto de campos de Viaje que se completan y cómo deben interpretarse.

TerminalLocation

Es la ubicación de este punto de referencia.

string

El viaje asociado con este punto de referencia.

WaypointType

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

LatLng

La ruta desde el punto de referencia anterior al actual. No definido para el primer punto de referencia de una lista. Este campo solo se completa cuando se solicita.

string

La ruta codificada desde el punto de referencia anterior al punto de referencia actual.

Nota: Este campo está diseñado solo para que lo usen el SDK del controlador y el SDK para consumidores. 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 Rides and Deliveries de Google Maps Platform.

Int32Value

La distancia de la ruta desde el punto de referencia anterior al actual. No definido para el primer punto de referencia de una lista.

Timestamp

La hora estimada de llegada a este punto de referencia. No definido para el primer punto de referencia de una lista.

Duration

La duración del viaje desde el punto de referencia anterior hasta este punto. No definido 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 pertenece la cuenta de servicio que realiza esta llamada.

Trip

Obligatorio. El viaje asociado con la actualización.

Fleet Engine mantiene los siguientes campos. No las 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 no será determinado.

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 se encuentre antes de los destinos intermedios y todos los destinos intermedios antecedan al punto de llegada. Los puntos de referencia de un viaje EXCLUSIVE no deben intercalarse con ningún otro viaje. Se usarán los campos trip_id, waypoint_type y location, y se ignorará el resto de los campos TripWaypoint de vehicle_waypoints.

Si deseas evitar una condición de carrera para 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 pase debe ser coherente con la versión de Fleet Engine. Si no es así, la solicitud falla.

FieldMask

Obligatorio. Es la máscara de campo que indica qué campos del viaje 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 pertenece la cuenta de servicio que realiza esta llamada.

VehicleAttribute

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

VehicleAttribute

Obligatorio. La lista completa actualizada de los atributos del vehículo, incluidos los nuevos, los alterados y los que no se modificaron.

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 pertenece la cuenta de servicio que realiza esta llamada.

Vehicle

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

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Si se actualiza el campo attributes, se reemplazarán todos los atributos del vehículo por los 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 ningún otro.

FieldMask

Obligatorio. 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. El nombre único de este vehículo. El formato es providers/{provider}/vehicles/{vehicle}.

VehicleState

El estado del vehículo.

TripType

Tipos de viaje admitidos en este vehículo.

string

Solo salida. Lista de trip_id para los viajes asignados actualmente a este vehículo.

VehicleLocation

Última ubicación informada del vehículo.

int32

La cantidad total de pasajeros que puede transportar este vehículo. No se considera el controlador en este valor. Este valor debe ser mayor o igual que uno.

VehicleAttribute

Lista de atributos del vehículo. Un vehículo puede tener como máximo 100 atributos, y cada uno de ellos debe tener una clave única.

VehicleType

Obligatorio. 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 y la ruta.

LicensePlate

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

TerminalLocation

Obsoleto: usa Vehicle.waypoints en su lugar.

string

La polilínea que especifica la ruta que la app de conductor intenta 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 está diseñado únicamente 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 los recorridos compartidos. Nota: Este campo está diseñado únicamente para que lo use el SDK del controlador.

Timestamp

Solo salida. Hora a la que se configuró el current_route_segment. El cliente puede almacenarla y pasarla en solicitudes GetVehicle futuras para evitar que se devuelvan rutas que no hayan cambiado.

TripWaypoint

El punto de referencia donde termina current_route_segment. Los conductores pueden proporcionarlo en llamadas a UpdateVehicle como un punto de referencia de viaje completo, un punto de referencia LatLng o como el último LatLng de la current_route_segment. Fleet Engine luego hará todo lo posible para interpolar un punto de referencia real si no está especificado por completo. Este campo se ignora en las llamadas UpdateVehicle, a menos que también se especifique current_route_segment.

Int32Value

La distancia en automóvil 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

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

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

Int32Value

Solo entrada. Tiempo de conducción restante: current_route_segment. El valor no se especifica si el campo waypoints o Vehicle.current_route_segment está vacío. Este valor debe coincidir con eta_to_first_waypoint y current_time si todos los grupos usan el mismo reloj.

Cuando actualizas 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. Ú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

El estado de navegación del vehículo.

DeviceSettings

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

Category

Categoría del tipo de vehículo

string

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

string

Es el valor del atributo.

string

Valor del atributo de tipo de cadena.

Nota: 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 cualquier campo, pero es muy recomendable usar string_value. Si se configuran string_value y value, deben ser idénticos; de lo contrario, se mostrará un error. Ambos campos se propagan en las respuestas.

bool

Valor de atributo de tipo booleano.

double

Valor de atributo de doble tipo.

VehicleAttribute

Una lista de atributos en esta colección.

LatLng

La ubicación del vehículo. Cuando se envía a Fleet Engine, la ubicación del vehículo es una ubicación de GPS. Cuando la recibes en una respuesta, la ubicación del vehículo puede ser una ubicación de 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

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

Altitud en metros sobre el 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/segundo

DoubleValue

Precisión de speed en metros/segundo.

Timestamp

La hora a la que el sensor informó location según su reloj.

Timestamp

Solo salida. Indica la hora a la que el servidor recibió la información de ubicación.

LocationSensor

Proveedor de datos de ubicación (por ejemplo, GPS).

BoolValue

Indica si location se ajusta a una ruta.

BoolValue

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

Int32Value

Solo entrada. Tiempo (en segundos) desde que esta ubicación se envió por primera vez al servidor. En la primera actualización, este valor será cero. Si se desconoce la hora (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 pargos).

Timestamp

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

LocationSensor

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

DoubleValue

Precisión de raw_location como radio, en metros

LatLng

Ubicación complementaria proporcionada por la app integrada.

Timestamp

Marca de tiempo asociada con la ubicación complementaria.

LocationSensor

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 coincide con la solicitud.

Timestamp

La hora de llegada estimada del vehículo al punto de partida especificado en la solicitud Un valor vacío indica 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 desde la ubicación actual del Vehículo hasta el punto de partida especificado en la solicitud, incluidos los puntos de partida o destino intermedios para los viajes existentes. Esta distancia comprende la distancia calculada en automóvil (ruta) más la distancia en línea recta entre el punto de destino de la navegación y el punto de partida solicitado. (Por lo general, la distancia entre el extremo de navegación y el punto de partida solicitado es pequeño). 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 completa del vehículo al punto de llegada especificado en la solicitud. El ETA incluye 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 llegada en la solicitud. Un valor vacío indica un error al calcular la hora de llegada estimada.

Int32Value

La distancia en automóvil (en metros) del vehículo desde el punto de partida hasta el punto de llegada especificado en la solicitud. La distancia solo es entre los dos puntos y no incluye la ubicación del vehículo ni ningún otro punto que deba visitarse antes de que el vehículo visite el punto de partida o 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 desde el punto de partida hasta el punto de llegada 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

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

VehicleMatchType

Tipo de coincidencia del vehículo.

VehicleMatchOrder

El orden solicitado para clasificar coincidencias de vehículos.

VehicleMatchOrder

El pedido real que se usó para este vehículo. Normalmente, esto coincidirá con "order_by" de la solicitud. Sin embargo, en determinadas circunstancias, como un error interno del servidor, se puede usar un método diferente (como PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

Opcional. Tramos de ruta que deben representarse a lo largo de la polilínea Se garantiza que los estiramientos no se superpongan y no abarquen necesariamente toda la ruta.

Ante la ausencia de un tramo de ruta para aplicar diseño, el cliente debe aplicar el valor predeterminado para la ruta.

Style

Obligatorio. Es el estilo que se aplicará.

int32

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

int32

Obligatorio. Es la longitud de la ruta en la que se aplicará el diseño.

LatLng

Es la ubicación de este punto de referencia.

Timestamp

La hora estimada a la que el vehículo llegará al punto de referencia.