Package maps.fleetengine.v1

BatteryStatus

Estado de la batería, ya sea que esté completa o en carga, etc.

PowerSource

Es el estado de la fuente de alimentación de la batería.

float

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

SpeedReadingInterval

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

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

string

Es obligatorio. Es el ID único del viaje. Sujeto a las siguientes restricciones:

• Debe ser una cadena Unicode válida.
• Se limita a una longitud máxima de 64 caracteres.
• Se normaliza según la forma C de normalización de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: "/", ":", "?", "," o "#".

Trip

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

Cuando crees un viaje, se deben completar los siguientes campos:

• trip_type
• pickup_point

Se usan 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 Trip. 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 para el vehículo. De lo contrario, el orden de los puntos de referencia no se determinará.

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 los de ningún otro viaje.

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

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

string

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

• Debe ser una cadena Unicode válida.
• Se limita a una longitud máxima de 64 caracteres.
• Se normaliza según la forma C de normalización de Unicode.
• No puede contener ninguno de los siguientes caracteres ASCII: "/", ":", "?", "," o "#".

Vehicle

Es obligatorio. Es la entidad Vehicle que se creará. Cuando se crea un vehículo, se deben completar 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.

RequestHeader

Opcional. Es el encabezado de solicitud estándar de Fleet Engine.

string

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

RequestHeader

Opcional. Es el encabezado de solicitud estándar de Fleet Engine.

string

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

LocationPowerSaveMode

Cómo 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 está en un estado interactivo.

BatteryInfo

Es información sobre el estado de la batería.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

TripView

Es el subconjunto de campos de Trip que se deben devolver y su interpretación.

Timestamp

Indica la marca de tiempo mínima (exclusiva) para la que se recuperan los datos de Trip.route o Trip.current_route_segment. Si los datos de la ruta no cambiaron desde esta marca de tiempo, el campo de la ruta no se establece en la respuesta. Si no se especifica un mínimo, siempre se recuperan los datos de la ruta.

Timestamp

Obsoleto: Los Trip.remaining_waypoints siempre se recuperan. Usa remaining_waypoints_route_version para controlar cuándo se recuperan los datos de Trip.remaining_waypoints.traffic_to_waypoint y Trip.remaining_waypoints.path_to_waypoint.

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 cambiaron desde esta marca de tiempo, el campo current_route_segment_traffic no se establece en la respuesta. Si no se especifica un mínimo, siempre se recuperan los datos de tráfico. 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 cambiaron desde esta marca de tiempo, los campos anteriores no se configuran en la respuesta. Si no se especifica remaining_waypoints_route_version, siempre se recuperan el tráfico y la ruta.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

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

Es obligatorio. Es el código de país o región de CLDR. Por ejemplo, US para Estados Unidos o IN para India.

string

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

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

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

int32

Es la cantidad máxima de vehículos que se devolverán. El valor predeterminado es 100.

string

Es 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 criterios de filtro de la llamada anterior a ListVehicles.

Int32Value

Especifica la capacidad mínima requerida del vehículo. Todos los vehículos que se devuelvan tendrán un maximum_capacity mayor o igual que este valor. Si se configura, 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 del período especificado. Los vehículos detenidos que siguen transmitiendo su ubicación no se consideran obsoletos. Si está presente, debe ser una duración positiva válida.

Category

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

string

Las entidades que llaman pueden formar operaciones lógicas complejas con cualquier combinación de los campos required_attributes, required_one_of_attributes y required_one_of_attribute_sets.

required_attributes es una lista; required_one_of_attributes usa un mensaje que permite una lista de listas. En combinación, los dos campos permiten componer 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/AND. Se permite un máximo de 50 required_attributes. 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 que tienen 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 de disyunción inclusiva/OR en cada VehicleAttributeList y una operación de conjunción/AND en la colección de VehicleAttributeList. Cada cadena repetida debe tener el formato "clave1:valor1|clave2:valor2|clave3:valor3".

string

required_one_of_attribute_sets proporciona funcionalidad adicional.

Al igual que required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas, lo que permite expresiones como esta:

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

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

VehicleState

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

bool

Solo se muestran los vehículos con viajes en curso.

string

Opcional. Es una consulta de filtro que se aplica cuando se enumeran 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 un valor no vacío aquí, 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 las que se realizan sobre atributos del vehículo (por ejemplo, attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). La cantidad máxima de restricciones permitidas en una consulta de filtro es de 50.

Además, todos los atributos se almacenan como cadenas, por lo que las únicas comparaciones admitidas con los atributos son las comparaciones de cadenas. Para comparar con valores numéricos o booleanos, los valores deben estar 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 se encontraba en el área rectangular definida por la ventana gráfica.

Vehicle

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

string

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

int64

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

string

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

string

Es obligatorio. Es el código de país de dos letras en el que 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 directamente relacionados con el viaje del que se informa. Por lo general, son IDs (por ejemplo, IDs de sesión) de operaciones previas a la reserva que se realizan antes de que esté disponible el ID del viaje. La cantidad de related_ids está limitada a 50.

SolutionType

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

string

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

string

Es obligatorio. Es el código de región de CLDR de la región en la que se origina la solicitud. Ejemplo de valor del campo: US.

string

Es la versión del SDK de llamada, si corresponde. El formato de la versión es “principal.secundaria.parche”, por ejemplo, 1.1.2.

string

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

string

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 SDK de Maps de la que depende el SDK de llamada, si corresponde. El formato de la versión es “principal.secundaria.parche”, por ejemplo, 5.2.1.

string

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

Platform

Es la plataforma del SDK de llamada.

string

Fabricante del dispositivo Android desde el SDK de llamada, solo aplicable para los SDKs de Android. Ejemplo de valor del campo: Samsung.

int32

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

string

Es un ID opcional que se puede proporcionar para fines de registro y para identificar la solicitud.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

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

string

Establece este parámetro en un valor que se haya mostrado anteriormente en SearchTripsResponse para continuar con los resultados anteriores.

Duration

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

Trip

Es la lista de viajes del vehículo solicitado.

string

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

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

TerminalLocation

Es obligatorio. Es el punto de retiro cerca del cual se realizará la búsqueda.

TerminalLocation

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

int32

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

int32

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

int32

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

TripType

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

Duration

Restringe la búsqueda solo a los vehículos que enviaron actualizaciones de ubicación a Fleet Engine dentro del período especificado. Los vehículos detenidos que siguen transmitiendo su ubicación no se consideran obsoletos. Si no se establece este campo, el servidor usa cinco minutos como valor predeterminado.

VehicleType

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

VehicleAttribute

Las entidades que llaman pueden formar operaciones lógicas complejas con cualquier combinación de los campos required_attributes, required_one_of_attributes y required_one_of_attribute_sets.

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

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

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

VehicleAttributeList

Restringe la búsqueda solo a los vehículos que tienen 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 de disyunción inclusiva/OR en cada VehicleAttributeList y una operación de conjunción/AND en la colección de VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets proporciona funcionalidad adicional.

Al igual que required_one_of_attributes, required_one_of_attribute_sets usa un mensaje que permite una lista de listas, lo que permite expresiones como esta:

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

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

VehicleMatchOrder

Es obligatorio. Especifica el criterio de ordenamiento deseado para los resultados.

bool

Indica si los vehículos con un solo viaje activo son aptos para esta búsqueda. Este campo solo se usa cuando no se especifica current_trips_present. Cuando no se especifica current_trips_present y este campo es false, los vehículos con viajes asignados se excluyen de los resultados de la búsqueda. Cuando no se especifica current_trips_present y este campo es true, los resultados de la búsqueda pueden incluir vehículos con un viaje activo que 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. Debe establecerse en un valor que no sea CURRENT_TRIPS_PRESENT_UNSPECIFIED si trip_type incluye SHARED.

string

Opcional. Es una consulta de filtro que se aplica cuando se buscan vehículos. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis 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 un valor no vacío aquí, 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 las que se realizan sobre atributos del vehículo (por ejemplo, attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). La cantidad máxima de restricciones permitidas en una consulta de filtro es de 50.

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

VehicleMatch

Es una lista de vehículos que coinciden con los criterios de SearchVehiclesRequest, ordenada 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 estar propagado.

int32

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

Speed

Velocidad del tráfico en este intervalo.

LatLng

Es obligatorio. Denota la ubicación real.

Timestamp

Indica cuándo ocurrió la parada.

Timestamp

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

LatLng

Denota la LatLng exacta del punto de referencia. Se debe especificar point o place como entrada. Si se especifican ambos, se usará point para el enrutamiento y place para los metadatos. Si solo se especifica place como entrada, point se calculará a partir de place y se incluirá en el resultado.

string

Es el nombre del recurso del lugar que representa esta ubicación. El formato es places/{place_id}. Se debe especificar point o place como entrada. Si se especifican ambos, se usará point para el enrutamiento y place para los metadatos. place solo se incluye en el resultado si se incluyó en la entrada, lo que significa que no se realiza ninguna búsqueda de place desde LatLng.

Esta función se encuentra en fase experimental.

PointSource

Solo salida. Es la fuente del campo point.

TerminalPointId

Obsoleto: Especifica el campo place en su lugar.

string

Obsoleto: Especifica el campo place en su lugar.

string

Obsoleta.

WaypointType

Obsoleto: Vehicle.waypoint tendrá estos datos.

string

Obsoleta.

string

Obsoleta.

string

Obsoleta.

VisualTrafficReportPolylineRendering

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

string

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

string

ID del vehículo que realiza este viaje.

TripStatus

Es el estado actual del viaje.

TripType

Es el tipo de viaje.

TerminalLocation

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

StopLocation

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

StopLocation

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

Timestamp

Solo salida. Es la hora futura estimada en la que se recogerá al pasajero o la hora real en la que se lo recogió.

TerminalLocation

Son las paradas intermedias en el orden en que se solicitan los viajes (además de la recogida y la llegada). Inicialmente, no se admitirá para 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 a continuación. 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, este campo se ignora.

StopLocation

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

StopLocation

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

TerminalLocation

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

StopLocation

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

Timestamp

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

TripWaypoint

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

TripWaypoint

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

LatLng

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

string

Solo salida. Es una ruta codificada hacia el siguiente punto de referencia.

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

Solo salida. Indica la última vez que se modificó el objeto 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. Es la parada en la que 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 se asigna a un vehículo o si se completa o cancela.

Timestamp

Solo salida. Es la ETA al próximo punto de ruta (la primera entrada en el campo remaining_waypoints). El valor no se especifica si el viaje no se asigna a un vehículo o si el viaje está inactivo (completado o cancelado).

Duration

Solo salida. Es la duración desde el momento en que se devuelven los datos del viaje hasta el momento en Trip.eta_to_first_waypoint. El valor no se especifica si el viaje no se asigna a un vehículo o si el viaje está inactivo (completado 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 devolverse 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 al current_route_segment. Es falso si no existe last_location o current_route_segment. Fleet Engine lo calcula. Se ignorará cualquier actualización de los clientes.

TripView

Es el subconjunto de campos de Trip que se completan y cómo se deben interpretar.

TripAttribute

Es una lista de atributos de viaje personalizados. Cada atributo debe tener una clave única.

string

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

string

Es el valor del atributo escrito como cadena.

bool

Es el valor del atributo escrito booleano.

double

Es el valor del atributo escrito como doble.

TerminalLocation

Es la ubicación de este punto de ruta.

string

Es el viaje asociado a este punto de ruta.

WaypointType

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

LatLng

Es la ruta desde el punto de referencia anterior hasta el punto de referencia actual. Si este es el primer punto de ruta, la ruta es desde la ubicación actual del vehículo hasta el punto de ruta. Este campo solo se propaga cuando se solicita.

string

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

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

ConsumableTrafficPolyline

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

Int32Value

Es la distancia de la ruta desde la parada anterior hasta la parada actual. Si este es el primer punto de ruta, la distancia de la ruta es desde la ubicación actual del vehículo hasta el punto de ruta.

Timestamp

Es la hora estimada de llegada a este punto de ruta.

Duration

Es el tiempo de viaje desde la parada anterior hasta esta parada. Si este es el primer punto de referencia, el tiempo de viaje se calcula desde la ubicación actual del vehículo hasta el punto de referencia.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

Trip

Es obligatorio. Es 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 actualices 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 se determinará.

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 los de ningún otro viaje. Se usan los campos trip_id, waypoint_type y location, y se ignoran todos los demás campos TripWaypoint en vehicle_waypoints.

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

FieldMask

Es obligatorio. Es la máscara de campo que indica qué campos del viaje se deben actualizar. El objeto update_mask debe contener al menos un campo.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

VehicleAttribute

Es obligatorio. Son los atributos del vehículo que se actualizarán. Los atributos no mencionados no se alteran ni se quitan.

VehicleAttribute

Es obligatorio. Es la lista completa actualizada de atributos del vehículo, incluidos los atributos nuevos, modificados y sin cambios.

RequestHeader

Es el encabezado de solicitud estándar de Fleet Engine.

string

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

Vehicle

Es obligatorio. Son los valores de la 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, todos los atributos del vehículo se reemplazan por los atributos proporcionados en la solicitud. Si deseas actualizar solo algunos atributos, consulta el método UpdateVehicleAttributes.

Del mismo modo, se puede actualizar el campo waypoints, pero debe contener todos los puntos de ruta que se encuentran actualmente en el vehículo y ningún otro.

FieldMask

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

string

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

VehicleState

Es el estado del vehículo.

TripType

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

string

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

VehicleLocation

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

VehicleLocation

Solo entrada. Son las ubicaciones en las que estuvo este vehículo en el pasado y que aún no se informaron a Fleet Engine. Se usa en UpdateVehicleRequest para registrar las ubicaciones que no se pudieron enviar al servidor anteriormente. Por lo general, esto sucede cuando el vehículo no tiene conectividad a Internet.

int32

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

VehicleAttribute

Es la lista de atributos del vehículo. Un vehículo puede tener hasta 100 atributos, y cada atributo debe tener una clave única.

VehicleType

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

LicensePlate

Es la información de la matrícula del vehículo.

TerminalLocation

Obsoleto: Usa Vehicle.waypoints en su lugar.

string

Es la polilínea que especifica la ruta que la app para conductores pretende tomar hasta el próximo punto de ruta. 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 de Driver. Aún no se admite la decodificación.

TrafficPolylineData

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

Timestamp

Solo salida. Fecha y hora en que se estableció current_route_segment. El cliente puede almacenarlo y pasarlo en futuras solicitudes de GetVehicle para evitar que se devuelvan rutas que no cambiaron.

TripWaypoint

Es la parada en la que termina current_route_segment. Los conductores pueden proporcionar este valor en las 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 a un punto de ruta 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

Es la ETA para la primera entrada en el campo waypoints. El valor no se especifica si el campo waypoints o el campo Vehicle.current_route_segment están vacíos.

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

Int32Value

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

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

TripWaypoint

Son 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. Es información sobre la configuración del dispositivo móvil que usa el conductor.

Category

Categoría de tipo de vehículo

string

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

string

Es el valor del atributo.

string

Es el valor del atributo escrito como cadena.

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

bool

Es el valor del atributo escrito booleano.

double

Es el valor del atributo escrito como doble.

VehicleAttribute

Es una lista de atributos de esta colección.

LatLng

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

DoubleValue

Obsoleto: Usa latlng_accuracy en su lugar.

DoubleValue

Precisión de location en metros como radio.

Int32Value

Es la dirección en la que se mueve el vehículo, expresada en grados. El 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 WGS84.

DoubleValue

Obsoleto: Usa altitude_accuracy en su lugar.

DoubleValue

Precisión de altitude en metros.

Int32Value

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

DoubleValue

Velocidad del vehículo en metros por segundo

DoubleValue

Precisión de speed en metros por segundo.

Timestamp

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

Timestamp

Solo salida. Fecha y hora en 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 se ajustó a una ruta.

BoolValue

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

Int32Value

Solo entrada. Es el tiempo (en segundos) transcurrido desde que se envió esta ubicación al servidor por primera vez. Este valor será cero para la primera actualización. 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á desactualizada.

LatLng

Ubicación sin procesar del vehículo (sin procesar por el ajuste a la ruta).

Timestamp

Es la marca de tiempo asociada a la ubicación sin procesar.

LocationSensor

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

DoubleValue

Precisión de raw_location como radio, en metros.

LatLng

Es la ubicación del proveedor de ubicación combinada de Android.

Timestamp

Marca de tiempo de actualización de flp_location

DoubleValue

Precisión de flp_location en metros como radio.

Int32Value

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

LatLng

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

Timestamp

Es la marca de tiempo asociada a 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

Es obligatorio. Un vehículo que coincide con la solicitud.

Timestamp

Es la ETA de conducción del vehículo hasta el punto de partida especificado en la solicitud. Un valor vacío indica que no se pudo calcular la ETA 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. (La distancia entre el punto de destino de la navegación y el punto de partida solicitado suele ser pequeña). Un valor vacío indica un error en el cálculo de la distancia.

Int32Value

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

Timestamp

Es la hora estimada de llegada del vehículo completo al punto de entrega especificado en la solicitud. La ETA incluye las paradas en los puntos de referencia antes del dropoff_point especificado en la solicitud. El valor solo se propagará cuando se especifique un punto de entrega en la solicitud. Un valor vacío indica un error en el cálculo de la ETA.

Int32Value

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

TripType

Es obligatorio. Es el tipo de viaje de la solicitud que se usó para calcular la ETA al punto de partida.

Waypoint

Es la lista ordenada de puntos de referencia que se usa para calcular la ETA. La lista incluye la ubicación del vehículo, los puntos de retiro de los viajes activos del vehículo y los puntos de retiro proporcionados en la solicitud. Una lista vacía indica que no se pudo calcular la ETA del vehículo.

VehicleMatchType

Es el tipo de coincidencia del vehículo.

VehicleMatchOrder

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

VehicleMatchOrder

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

RoadStretch

Opcional. Son tramos de ruta que se deben renderizar a lo largo de la polilínea. Se garantiza que los tramos no se superponen y no necesariamente abarcan toda la ruta.

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

Style

Es obligatorio. Es el estilo que se aplicará.

int32

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

int32

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

LatLng

Es la ubicación de este punto de ruta.

Timestamp

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