Package maps.fleetengine.v1

BatteryStatus

Estado de la batería, ya sea llena o cargando, etc.

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 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 un límite 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. Es la 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 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 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 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ó según el Formato de normalización C de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: “/”, “:”, “?”, “,” o “'#'”.

Vehicle

Obligatorio. La entidad Vehículo 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

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

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 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 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 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 cambia 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 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. 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 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 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 tipo 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 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 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 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 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/una operación AND en cada VehicleAttributeList y una operación de disyunción/O inclusiva en 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 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 búsqueda 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 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 forma parte 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

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 del viaje esté disponible. La cantidad de related_ids está limitada a 50.

SolutionType

Indica el tipo de solución de productos de GMP (por ejemplo, ON_DEMAND_RIDESHARING_AND_DELIVERIES) que se utiliza 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

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

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 que realiza la 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 que realiza la llamada, si corresponde. El formato de la versión es “major.minor.patch”, por 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

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 pertenece 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 la estableces como verdadera, la respuesta incluirá los Viajes que influyen en la ruta del 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

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

TerminalLocation

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

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 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 devolverán. El valor debe estar entre 1 y 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 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 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 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 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 ú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 de disyunción 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.

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 búsqueda solo a los vehículos con todos los atributos de un VehicleAttributeList. Dentro de 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 en un valor que no sea CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type incluye SHARED.

string

Opcional. Una búsqueda de filtro para aplicar cuando se busquen vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis del 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 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 búsqueda 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 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

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

Una renderización de polilíneas que indica qué tan rápido es el tráfico en 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 en la 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 es para que el proveedor proporcione comentarios sobre la información de llegada real 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

Paradas intermedias en función de las solicitudes de 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, 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, 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 y dónde 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

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 se dejó al cliente. Este campo es para que el proveedor proporcione comentarios sobre la información real del lugar de destino.

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. 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 del 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, el servidor solo propaga este campo en las llamadas UpdateTrip y CreateTrip, NO en las llamadas 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 está diseñado solo para que lo usen el SDK de Driver 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 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 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ó 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 termina current_route_segment.

Int32Value

Solo salida. 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 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 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 informada del vehículo a lo largo de la ruta.

bool

Solo salida. Indica si el last_location del vehículo se puede ajustar a 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

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

El viaje asociado con 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 completa cuando se solicita.

string

Es la ruta de acceso 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 Rides and Deliveries de Google Maps Platform.

Int32Value

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

Timestamp

La hora estimada de llegada a este punto de referencia. No se define 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 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 no será determinado.

Cuando especificas Trip.vehicle_waypoints, la lista debe contener todos los puntos de ida y vuelta restantes de los viajes del vehículo, sin puntos de ida y vuelta 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 de 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 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 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 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, se reemplazarán todos los atributos del vehículo por los proporcionados en la solicitud. Si deseas 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. Es el nombre único de este vehículo. El formato es providers/{provider}/vehicles/{vehicle}.

VehicleState

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

Última ubicación informada del vehículo.

int32

La cantidad total de pasajeros que puede transportar este 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 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 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 recorrido compartido. Nota: Este campo solo está diseñado para que lo use el SDK del controlador.

Timestamp

Solo salida. Hora a la que se configuró el 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 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. 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 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 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 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. 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

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 o se arrojará 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

Es 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 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

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

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

Timestamp

Es la 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 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 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 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. (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. 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 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 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 del vehículo.

VehicleMatchType

Tipo de coincidencia del vehículo.

VehicleMatchOrder

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

VehicleMatchOrder

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

RoadStretch

Opcional. Son tramos de ruta que se deben 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 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.