Índice
DeliveryService
(interfaz)BatchCreateTasksRequest
(mensaje)BatchCreateTasksResponse
(mensaje)CreateDeliveryVehicleRequest
(mensaje)CreateTaskRequest
(mensaje)DeliveryRequestHeader
(mensaje)DeliveryRequestHeader.Platform
(enumeración)DeliveryRequestHeader.SdkType
(enumeración)DeliveryVehicle
(mensaje)DeliveryVehicle.DeliveryVehicleType
(enumeración)DeliveryVehicleAttribute
(mensaje)DeliveryVehicleLocation
(mensaje)DeliveryVehicleLocationSensor
(enumeración)DeliveryVehicleNavigationStatus
(enumeración)GetDeliveryVehicleRequest
(mensaje)GetTaskRequest
(mensaje)GetTaskTrackingInfoRequest
(mensaje)ListDeliveryVehiclesRequest
(mensaje)ListDeliveryVehiclesResponse
(mensaje)ListTasksRequest
(mensaje)ListTasksResponse
(mensaje)LocationInfo
(mensaje)Task
(mensaje)Task.JourneySharingInfo
(mensaje)Task.State
(enumeración)Task.TaskOutcome
(enumeración)Task.TaskOutcomeLocationSource
(enumeración)Task.Type
(enumeración)TaskAttribute
(mensaje)TaskTrackingInfo
(mensaje)TaskTrackingViewConfig
(mensaje)TaskTrackingViewConfig.VisibilityOption
(mensaje)TimeWindow
(mensaje)UpdateDeliveryVehicleRequest
(mensaje)UpdateTaskRequest
(mensaje)VehicleJourneySegment
(mensaje)VehicleStop
(mensaje)VehicleStop.State
(enumeración)VehicleStop.TaskInfo
(mensaje)
DeliveryService
El servicio de entrega de Last Mile.
BatchCreateTasks |
---|
Crea y muestra un lote de objetos |
CreateDeliveryVehicle |
---|
Crea y muestra un |
CreateTask |
---|
Crea y muestra un objeto |
GetDeliveryVehicle |
---|
Muestra la instancia |
GetTask |
---|
Obtiene información sobre un |
GetTaskTrackingInfo |
---|
Muestra la instancia |
ListDeliveryVehicles |
---|
Obtiene todos los |
ListTasks |
---|
Obtiene todos los |
UpdateDeliveryVehicle |
---|
Escribe datos actualizados de |
UpdateTask |
---|
Actualiza los datos de |
BatchCreateTasksRequest
El mensaje de solicitud BatchCreateTask
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. Nota: Si estableces este campo, el campo de encabezado de los mensajes |
parent |
Obligatorio. El recurso superior compartido por todas las tareas. Este valor debe tener el formato |
requests[] |
Obligatorio. El mensaje de solicitud que especifica los recursos que se crearán. Nota: Puedes crear un máximo de 500 tareas por lote. |
BatchCreateTasksResponse
El mensaje de respuesta BatchCreateTask
.
Campos | |
---|---|
tasks[] |
Las tareas creadas. |
CreateDeliveryVehicleRequest
El mensaje de solicitud CreateDeliveryVehicle
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
parent |
Obligatorio. Debe tener el formato |
delivery_vehicle_id |
Obligatorio. El ID del vehículo de entrega debe ser único y estar sujeto a las siguientes restricciones:
|
delivery_vehicle |
Obligatorio. La entidad
Nota: Se ignora el campo |
CreateTaskRequest
El mensaje de solicitud CreateTask
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
parent |
Obligatorio. Debe tener el formato |
task_id |
Obligatorio. El ID de tarea debe ser único, pero no debe ser un ID de seguimiento de envío. Para almacenar un ID de seguimiento de envío, usa el campo
|
task |
Obligatorio. La entidad Task que se creará. Cuando se crea una tarea, se requieren los siguientes campos:
Nota: Se ignora el campo |
DeliveryRequestHeader
Un RequestHeader contiene campos comunes a todas las solicitudes de RPC de entrega.
Campos | |
---|---|
language_code |
Es el código de idioma según la norma BCP-47, como en-US o sr-Latn. Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si no se especifica ninguno, la respuesta puede estar en cualquier idioma, con preferencia en inglés si ese nombre existe. Ejemplo de valor de campo: |
region_code |
Obligatorio. Es el código regional de CLDR de la región donde se origina la solicitud. Ejemplo de valor de campo: |
sdk_version |
Es la versión del SDK que realiza la llamada, si corresponde. El formato de la versión es "major.minor.patch", por ejemplo: |
os_version |
Es la versión del sistema operativo en el que se ejecuta el SDK de llamada. Ejemplos de valores de campo: |
device_model |
Es el modelo del dispositivo en el que se ejecuta el SDK de llamada. Ejemplos de valores de campo: |
sdk_type |
Es el tipo de SDK que envía la solicitud. |
maps_sdk_version |
Es la versión del SDK de Map del que depende el SDK de llamada, si corresponde. El formato de la versión es "major.minor.patch", por ejemplo: |
nav_sdk_version |
Es la versión del NavSDK del que depende el SDK de llamada, si corresponde. El formato de la versión es "major.minor.patch", por ejemplo: |
platform |
Plataforma del SDK que realiza la llamada. |
manufacturer |
Fabricante del dispositivo Android del SDK que realiza la llamada, solo aplicable para los SDK de Android. Ejemplo de valor de campo: |
android_api_level |
Nivel de API de Android del SDK de llamada, solo aplicable para los SDK de Android. Ejemplo de valor de campo: |
trace_id |
ID opcional que se puede proporcionar con fines de registro para identificar la solicitud. |
Plataforma
Es la plataforma del SDK que realiza la llamada.
Enumeradores | |
---|---|
PLATFORM_UNSPECIFIED |
Es el valor predeterminado. Este valor se usa si se omite la plataforma. |
ANDROID |
La solicitud proviene de Android. |
IOS |
La solicitud proviene de iOS. |
WEB |
La solicitud proviene de la Web. |
SdkType
Posibles tipos de SDK.
Enumeradores | |
---|---|
SDK_TYPE_UNSPECIFIED |
Es el valor predeterminado. Este valor se usa si se omite sdk_type . |
CONSUMER |
El SDK que realiza la llamada es Consumer. |
DRIVER |
El SDK que realiza la llamada es el controlador. |
JAVASCRIPT |
El SDK que realiza la llamada es JavaScript. |
DeliveryVehicle
El mensaje DeliveryVehicle
Un vehículo de reparto transporta envíos desde un depósito a una ubicación de entrega y desde una ubicación de retiro hasta el depósito. En algunos casos, los vehículos de entrega también transportan los envíos directamente desde la ubicación de retiro hasta la ubicación de entrega.
Nota: Las APIs de REST y gRPC usan diferentes convenciones de nombres de campos. Por ejemplo, el campo DeliveryVehicle.current_route_segment
en la API de gRPC y el campo DeliveryVehicle.currentRouteSegment
en la API de REST hacen referencia al mismo campo.
Campos | |
---|---|
name |
Es el nombre único de este vehículo de entrega. El formato es |
last_location |
Es la última ubicación informada del vehículo de entregas. |
navigation_status |
Estado de navegación del vehículo de entrega |
current_route_segment |
La polilínea codificada que especifica la ruta que la navegación recomienda tomar al siguiente punto de referencia. La app del conductor actualiza esta información cuando se llega a una parada o pasa por ella, y cuando se redirige la navegación. Estos Hay algunos casos en los que es posible que este campo no se use para propagar
En estos casos, Fleet Engine propaga este campo con una ruta desde la última opción VehicleStop que se pasó a VehicleStop para garantizar que el consumidor de este campo tenga la mejor información disponible sobre la ruta actual del vehículo de entrega. |
current_route_segment_end_point |
Es la ubicación donde termina el Se ignora este campo en las llamadas |
remaining_distance_meters |
La distancia restante en automóvil para Fleet Engine ignorará este campo en |
remaining_duration |
El tiempo de conducción restante para el Fleet Engine ignorará este campo en |
remaining_vehicle_journey_segments[] |
Son los tramos de viaje asignados a este vehículo de entregas, comenzando por la ubicación del vehículo que se informó más recientemente. Este campo no se propagará en la respuesta de |
attributes[] |
Una lista de atributos personalizados del vehículo de entrega. Un vehículo de entregas puede tener 100 atributos como máximo, y cada uno de ellos debe tener una clave única. |
type |
El tipo de este vehículo de entrega. Si no la estableces, el valor predeterminado será |
DeliveryVehicleType
El tipo de vehículo de entrega.
Enumeradores | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
El valor no está en uso. |
AUTO |
Un automóvil. |
TWO_WHEELER |
Una motocicleta, un ciclomotor u otro vehículo de dos ruedas |
BICYCLE |
Transporte impulsado por seres humanos. |
PEDESTRIAN |
Un transportador humano, generalmente caminando o corriendo, que viaja por senderos peatonales. |
DeliveryVehicleAttribute
Describe un atributo de vehículo como un par clave-valor. La longitud de la cadena "key:value" no puede superar los 256 caracteres.
Campos | |
---|---|
key |
La clave del atributo. |
value |
El valor del atributo. |
Campo de unión delivery_vehicle_attribute_value . El valor del atributo puede ser de tipo string, bool o doble. Las direcciones (delivery_vehicle_attribute_value ) solo pueden ser una de las siguientes opciones: |
|
string_value |
Valor del atributo con tipo de cadena. Nota: Esto es idéntico al campo |
bool_value |
Valor del atributo de tipo booleano. |
number_value |
Valor del atributo de tipo doble. |
DeliveryVehicleLocation
Es la ubicación, velocidad y rumbo de un vehículo en un momento determinado.
Campos | |
---|---|
location |
Es la ubicación del vehículo. Cuando se envía a Fleet Engine, la ubicación del vehículo es GPS. Cuando la recibes en una respuesta, la ubicación del vehículo puede ser una ubicación GPS, complementaria o alguna otra ubicación aproximada. La fuente se especifica en |
horizontal_accuracy |
Obsoleto: usa |
latlng_accuracy |
Precisión de |
heading |
Dirección en la que se mueve el vehículo en grados. 0 representa el norte. El rango válido es [0,360). |
bearing_accuracy |
Obsoleto: usa |
heading_accuracy |
Precisión de |
altitude |
Altitud en metros sobre WGS84. |
vertical_accuracy |
Obsoleto: usa |
altitude_accuracy |
Precisión de |
speed_kmph |
Velocidad del vehículo en kilómetros por hora. Obsoleto: usa |
speed |
Velocidad del vehículo en metros/segundo |
speed_accuracy |
Precisión de |
update_time |
La hora a la que el sensor informó |
server_time |
Solo salida. Es la hora a la que el servidor recibió la información de ubicación. |
location_sensor |
Proveedor de datos de ubicación (por ejemplo, |
is_road_snapped |
Indica si |
is_gps_sensor_enabled |
Solo entrada. Indica si el sensor GPS está habilitado en el dispositivo móvil. |
time_since_update |
Solo entrada. Tiempo (en segundos) transcurridos desde que esta ubicación se envió al servidor por primera vez. Este valor será cero para la primera actualización. Si la hora es desconocida (por ejemplo, cuando se reinicia la app), este valor se restablece a cero. |
num_stale_updates |
Solo entrada. Obsoleto: Ahora se usan otros indicadores para determinar si una ubicación está inactiva. |
raw_location |
Ubicación del vehículo sin procesar (no procesada por el pargo). |
raw_location_time |
Marca de tiempo asociada con la ubicación sin procesar. |
raw_location_sensor |
Fuente de la ubicación sin procesar. La configuración predeterminada es |
raw_location_accuracy |
Precisión de |
supplemental_location |
Es la ubicación complementaria que proporciona la app integrada. |
supplemental_location_time |
Marca de tiempo asociada con la ubicación complementaria. |
supplemental_location_sensor |
La fuente de la ubicación complementaria. La configuración predeterminada es |
supplemental_location_accuracy |
Precisión de |
road_snapped |
Obsoleto: usa |
DeliveryVehicleLocationSensor
Es el sensor o la metodología que se usa para determinar la ubicación.
Enumeradores | |
---|---|
UNKNOWN_SENSOR |
No se especificó el sensor o se desconoce. |
GPS |
GPS o GPS asistido. |
NETWORK |
GPS asistido, ID de torres de telefonía celular o punto de acceso Wi-Fi. |
PASSIVE |
ID de torre de telefonía celular o punto de acceso Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
Es una ubicación determinada por el dispositivo móvil como la posición más probable en la ruta. |
CUSTOMER_SUPPLIED_LOCATION |
Una ubicación de una fuente independiente proporcionada por el cliente. Por lo general, este valor se usa para una ubicación proporcionada desde fuentes distintas del dispositivo móvil que ejecuta el SDK de Driver. Si uno de los otros valores de enumeración describe la fuente original, usa ese valor. Las ubicaciones marcadas como CUSTOMER_SUPPLIED_LOCATION suelen proporcionarse mediante un last_location.supplemental_location_sensor de DeliveryVehicle. |
FLEET_ENGINE_LOCATION |
Una ubicación calculada por Fleet Engine según los indicadores disponibles para ella. Solo salida. Este valor se rechazará si se recibe en una solicitud. |
FUSED_LOCATION_PROVIDER |
Proveedor de ubicación combinada de Android |
CORE_LOCATION |
Es el proveedor de ubicación en los sistemas operativos de Apple. |
GetDeliveryVehicleRequest
El mensaje de solicitud GetDeliveryVehicle
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
name |
Obligatorio. Debe tener el formato |
GetTaskRequest
El mensaje de solicitud GetTask
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
name |
Obligatorio. Debe tener el formato |
GetTaskTrackingInfoRequest
El mensaje de solicitud GetTaskTrackingInfoRequest
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
name |
Obligatorio. Debe tener el formato |
ListDeliveryVehiclesRequest
El mensaje de solicitud ListDeliveryVehicles
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
parent |
Obligatorio. Debe tener el formato |
page_size |
Opcional. La cantidad máxima de vehículos que se mostrará. El servicio puede devolver menos que este número. Si no especificas este número, el servidor determina la cantidad de resultados que se mostrarán. |
page_token |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Una consulta de filtro que se aplicará cuando se muestre una lista de vehículos de entrega. Consulta http://aip.dev/160 para ver ejemplos de la sintaxis del filtro. Si no especificas un valor o si especificas una cadena vacía para el filtro, se mostrarán todos los vehículos de entrega. Ten en cuenta que las únicas búsquedas admitidas para La cantidad máxima de restricciones permitida en una consulta de filtro es de 50. Una restricción es una parte de la consulta con el formato |
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 el viewport. |
ListDeliveryVehiclesResponse
El mensaje de respuesta ListDeliveryVehicles
.
Campos | |
---|---|
delivery_vehicles[] |
Es el conjunto de vehículos de entrega que cumplen con los criterios de filtrado solicitados. Cuando no se especifica ningún filtro, la solicitud muestra todos los vehículos de entrega. Una respuesta correcta también puede estar vacía. Si la respuesta está vacía, significa que no se encontraron vehículos de entrega que cumplan con los criterios de filtro solicitados. |
next_page_token |
Puedes pasar este token en |
total_size |
La cantidad total de vehículos de entrega que coinciden con los criterios de la solicitud en todas las páginas. |
ListTasksRequest
El mensaje de solicitud ListTasks
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
parent |
Obligatorio. Debe tener el formato |
page_size |
Opcional. La cantidad máxima de tareas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica este valor, el servidor determina la cantidad de resultados que se mostrarán. |
page_token |
Opcional. Un token de página recibido de una llamada anterior a Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Una consulta de filtro para aplicar cuando se enumere Tasks. Consulta http://aip.dev/160 para ver ejemplos de sintaxis de filtros. Si no especificas un valor o si filtras con una string vacía, se mostrarán todas las tareas. Para obtener información sobre las propiedades de la tarea que puedes filtrar, consulta Lista de tareas. |
ListTasksResponse
La respuesta ListTasks
, que contiene el conjunto de tareas que cumplen con los criterios de filtro en ListTasksRequest
.
Campos | |
---|---|
tasks[] |
Es el conjunto de tareas que cumplen con los criterios de filtrado solicitados. Cuando no se especifica ningún filtro, la solicitud muestra todas las tareas. Una respuesta correcta también puede estar vacía. Una respuesta vacía indica que no se encontraron tareas que cumplan con los criterios de filtro solicitados. |
next_page_token |
Pasa este token en |
total_size |
La cantidad total de tareas que coinciden con los criterios de la solicitud en todas las páginas. |
LocationInfo
Una ubicación con identificadores adicionales.
Campos | |
---|---|
point |
Coordenadas de la ubicación |
Tarea
En la API de Delivery, una tarea representa una sola acción a la que le puedes hacer un seguimiento. En general, hay una distinción entre las tareas relacionadas con el envío y las tareas de desglose. Un envío puede tener varias tareas asociadas. Por ejemplo, podría haber una tarea para el punto de partida y otra para el destino o el transbordo. Además, vehículos diferentes pueden manejar las distintas Tasks para un envío determinado. Por ejemplo, un vehículo podría encargarse del retiro y conducir el envío al centro, mientras que otro vehículo realiza el mismo envío desde el centro hasta la ubicación de llegada.
Nota: Las APIs de REST y gRPC usan diferentes convenciones de nombres de campos. Por ejemplo, el campo Task.journey_sharing_info
en la API de gRPC y el campo Task.journeySharingInfo
en la API de REST hacen referencia al mismo campo.
Campos | |
---|---|
name |
Debe tener el formato |
type |
Obligatorio. Inmutable. Define el tipo de Task. Por ejemplo, una pausa o un envío. |
state |
Obligatorio. El estado actual de la ejecución de la Task. |
task_outcome |
El resultado de la Task. |
task_outcome_time |
Es la marca de tiempo que indica cuándo el proveedor configuró el resultado de |
task_outcome_location |
La ubicación en la que se estableció el resultado de |
task_outcome_location_source |
Indica de dónde provino el valor de |
tracking_id |
Inmutable. Este campo facilita el almacenamiento de un ID para que no tengas que usar una asignación complicada. No puedes configurar
|
delivery_vehicle_id |
Solo salida. El ID del vehículo que ejecuta esta tarea. Los IDs de vehículos de entrega están sujetos a las siguientes restricciones:
|
planned_location |
Inmutable. Es la ubicación en la que se completará la tarea. Opcional para las tareas de |
task_duration |
Obligatorio. Inmutable. El tiempo necesario para ejecutar una Task en esta ubicación. |
target_time_window |
Es el período durante el cual se debe completar la tarea. |
journey_sharing_info |
Solo salida. Campos específicos del recorrido compartido. No se propaga cuando el estado es |
task_tracking_view_config |
Es la configuración del seguimiento de tareas que especifica qué elementos de datos son visibles para los usuarios finales y en qué circunstancias. |
attributes[] |
Una lista de atributos personalizados de Tasks. Cada atributo debe tener una clave única. |
JourneySharingInfo
Recorrido que comparte campos específicos
Campos | |
---|---|
remaining_vehicle_journey_segments[] |
Información de seguimiento para las paradas que realizará el vehículo asignado antes de completar esta Tarea. Ten en cuenta que esta lista puede contener paradas de otras tareas. El primer segmento, |
last_location |
Indica la ubicación más reciente que se informó del vehículo asignado. |
last_location_snappable |
Indica si la última ubicación del vehículo se puede ajustar a |
Estado
Es el estado de una tarea. Indica el progreso de las tareas.
Enumeradores | |
---|---|
STATE_UNSPECIFIED |
Predeterminado. Se usa para un estado de tarea no especificado o no reconocido. |
OPEN |
Es posible que la tarea aún no se asigne a un vehículo de entrega o que este vehículo aún no haya pasado por la parada asignada por el Task . |
CLOSED |
Cuando el vehículo pase por la parada del vehículo para realizar esta tarea. |
TaskOutcome
El resultado de intentar ejecutar una Task. Cuando se cierra TaskState
, TaskOutcome
indica si se completó correctamente.
Enumeradores | |
---|---|
TASK_OUTCOME_UNSPECIFIED |
El resultado de Task antes de que se establezca su valor. |
SUCCEEDED |
La tarea se completó correctamente. |
FAILED |
La tarea no se pudo completar o se canceló. |
TaskOutcomeLocationSource
La identidad de la fuente que propagó el task_outcome_location
.
Enumeradores | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
El resultado de la tarea antes de que se establezca. |
PROVIDER |
El proveedor especificó el task_outcome_location . |
LAST_VEHICLE_LOCATION |
El proveedor no especificó el task_outcome_location , por lo que Fleet Engine usó la ubicación más reciente del vehículo. |
Tipo
Es el tipo de Task.
Enumeradores | |
---|---|
TYPE_UNSPECIFIED |
De forma predeterminada, se desconoce el tipo de tarea. |
PICKUP |
Una tarea de retiro es la acción que se realiza para recoger un envío de un cliente. Las recogidas de vehículos desde plataformas o alimentadores deben usar el tipo SCHEDULED_STOP . |
DELIVERY |
Una tarea de entrega es la acción que se realiza para entregar un envío a un cliente final. Los destinos de vehículos todoterreno o depósito deben usar el tipo SCHEDULED_STOP . |
SCHEDULED_STOP |
Una Task de parada programada se utiliza con fines de planificación. Por ejemplo, podría representar la recogida o devolución de envíos de vehículos o depósitos de alimentación. No debe usarse para envíos que recoge o deja un cliente final. |
UNAVAILABLE |
Una Tarea que significa que el Vehículo no está disponible para su mantenimiento. Por ejemplo, esto puede ocurrir cuando el conductor se toma un descanso o cuando se está recargando el combustible del vehículo. |
TaskAttribute
Describe un atributo de tarea como un par clave-valor. La longitud de la cadena "key:value" no puede superar los 256 caracteres.
Campos | |
---|---|
key |
La clave del atributo. Las claves no pueden contener el carácter de dos puntos (:). |
Campo de unión task_attribute_value . El valor del atributo puede ser de tipo string, bool o doble. Si no se establece ninguno, el valor string_value de TaskAttribute se almacenará como la string vacía "". task_attribute_value solo puede ser una de las siguientes opciones: |
|
string_value |
Valor del atributo con tipo de cadena. |
bool_value |
Valor del atributo de tipo booleano. |
number_value |
Valor del atributo de tipo doble. |
TaskTrackingInfo
El mensaje TaskTrackingInfo
El mensaje contiene información de seguimiento de tareas que se utilizará para mostrarlo. Si un ID de seguimiento está asociado con varias tareas, Fleet Engine utiliza una heurística para decidir qué campo TaskTrackingInfo de la tarea seleccionar.
Campos | |
---|---|
name |
Debe tener el formato |
tracking_id |
Inmutable. El ID de seguimiento de una Task. * Debe ser una string Unicode válida. * Limitado a una longitud máxima de 64 caracteres. * Normalizada según el Formulario C de normalización de Unicode. * No puede contener ninguno de los siguientes caracteres ASCII: “/”, “:”, “?”, “,” o '#'. |
vehicle_location |
Indica la última ubicación del vehículo. |
route_polyline_points[] |
Una lista de puntos que, cuando se conectan, forman una polilínea de la ruta esperada del vehículo hacia la ubicación de esta tarea. |
remaining_stop_count |
Indica la cantidad de paradas que quedan en el vehículo hasta llegar a la parada de tareas, incluida la parada de tareas. Por ejemplo, si la siguiente parada del vehículo es la parada de tareas, el valor será 1. |
remaining_driving_distance_meters |
La distancia total restante en metros al |
estimated_arrival_time |
La marca de tiempo que indica la hora estimada de llegada a la ubicación de la parada. |
estimated_task_completion_time |
La marca de tiempo que indica la hora estimada de finalización de una tarea. |
state |
El estado actual de la ejecución de la Task. |
task_outcome |
El resultado de intentar ejecutar una Task. |
task_outcome_time |
La marca de tiempo que indica cuándo el proveedor estableció el resultado de la tarea. |
planned_location |
Inmutable. Es la ubicación en la que se completará la tarea. |
target_time_window |
Es el período durante el cual se debe completar la tarea. |
attributes[] |
Los atributos personalizados establecidos en la tarea. |
TaskTrackingViewConfig
Es el mensaje de configuración que define cuándo debe ser visible un elemento de datos de una tarea para los usuarios finales.
Campos | |
---|---|
route_polyline_points_visibility |
Es el campo que especifica cuándo se pueden ver los puntos de polilínea de la ruta. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
estimated_arrival_time_visibility |
El campo que especifica cuándo puede mostrarse la hora de llegada estimada. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
estimated_task_completion_time_visibility |
Campo que especifica cuándo se puede visualizar el tiempo estimado de finalización de la tarea. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
remaining_driving_distance_visibility |
Puede verse el campo que especifica el momento en que se puede recorrer el área restante en automóvil. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
remaining_stop_count_visibility |
El campo que especifica cuándo puede estar visible el recuento de paradas restante. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
vehicle_location_visibility |
Es el campo que especifica cuándo puede ser visible la ubicación del vehículo. Si no se especifica este campo, se usará la configuración de visibilidad predeterminada a nivel de proyecto para estos datos. |
VisibilityOption
Es el mensaje de opción que define cuándo un elemento de datos debe ser visible para los usuarios finales.
Campos | |
---|---|
Campo de unión visibility_option . La opción de visibilidad específica elegida. Las direcciones (visibility_option ) solo pueden ser una de las siguientes opciones: |
|
remaining_stop_count_threshold |
Este elemento de datos es visible para los usuarios finales si el recuento de paradas restante es inferior o igual a remanente_stop_count_threshold. |
duration_until_estimated_arrival_time_threshold |
Este elemento de datos es visible para los usuarios finales si la hora de llegada estimada a la parada <= duration_until_estimated_arrival_time_threshold. |
remaining_driving_distance_meters_threshold |
Este elemento de datos es visible para los usuarios finales si la distancia restante en metros es inferior o igual a la cantidad restante_driving_distance_meters_threshold. |
always |
Si se configura como true, este elemento de datos siempre es visible para los usuarios finales sin umbrales. Este campo no se puede establecer como falso. |
never |
Si se configura como true, este elemento de datos siempre está oculto para los usuarios finales sin umbrales. Este campo no se puede establecer como falso. |
TimeWindow
Un intervalo de tiempo.
Campos | |
---|---|
start_time |
Obligatorio. Indica la hora de inicio del período (inclusive). |
end_time |
Obligatorio. Indica la hora de finalización del período (inclusive). |
UpdateDeliveryVehicleRequest
El mensaje de solicitud UpdateDeliveryVehicle
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
delivery_vehicle |
Obligatorio. La actualización de entidad |
update_mask |
Obligatorio. Una máscara de campo que indica qué campos de Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
UpdateTaskRequest
El mensaje de solicitud UpdateTask
.
Campos | |
---|---|
header |
Opcional. El encabezado de la solicitud a la API de Delivery estándar. |
task |
Obligatorio. La tarea asociada con la actualización. Fleet Engine mantiene los siguientes campos. No las actualices con
Nota: No puedes cambiar el valor de Si la tarea se asignó a un vehículo de entrega, no establezcas el estado de la tarea como CERRADA mediante |
update_mask |
Obligatorio. La máscara de campo que indica qué campos de la tarea se deben actualizar. Nota: Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
VehicleJourneySegment
Representa el tramo de viaje de un vehículo, desde su parada anterior hasta la parada actual. Si es la primera parada activa, es desde la ubicación actual del vehículo hasta esta parada.
Campos | |
---|---|
stop |
Especifica la ubicación de la parada, junto con los |
driving_distance_meters |
Solo salida. La distancia de viaje desde la parada anterior hasta esta parada. Si la parada actual es la primera de la lista de tramos de viaje, el punto de partida es la ubicación del vehículo registrada cuando se agregó esta parada a la lista. Es posible que este campo no esté presente si este segmento de recorrido forma parte de |
driving_duration |
Solo salida. Indica la duración de viaje desde la parada anterior hasta esta parada. Si la parada actual es la primera de la lista de tramos de viaje, el punto de partida es la ubicación del vehículo registrada cuando se agregó esta parada a la lista. Si este campo se define en la ruta de acceso |
path[] |
Solo salida. El recorrido desde la parada anterior hasta esta parada. Si la parada actual es la primera de la lista de tramos de viaje, esta es la ruta desde la ubicación actual del vehículo hasta esta parada en el momento en que la parada se agregó a la lista. Es posible que este campo no esté presente si este segmento de recorrido forma parte de Si este campo se define en la ruta de acceso |
VehicleStop
Describe un punto en el que se detiene un vehículo para realizar uno o más Task
.
Campos | |
---|---|
planned_location |
Obligatorio. Es la ubicación de la parada. Ten en cuenta que las ubicaciones en los objetos |
tasks[] |
Es la lista de |
state |
El estado de |
Estado
El estado actual de un VehicleStop
.
Enumeradores | |
---|---|
STATE_UNSPECIFIED |
Desconocido. |
NEW |
Se creó, pero no se enrutó de forma activa. |
ENROUTE |
Asignado y enrutando activamente. |
ARRIVED |
Llegaste a la parada. Supone que, cuando el vehículo va a la siguiente parada, se completaron todas las paradas anteriores. |
TaskInfo
Información adicional sobre la tarea realizada en esta parada.
Campos | |
---|---|
task_id |
El ID de tarea. Este campo no se completará en la respuesta de una llamada a
|
task_duration |
Solo salida. El tiempo necesario para realizar la tarea. |
target_time_window |
Solo salida. Es el período durante el cual se debe completar la tarea. Esto solo se establece en la respuesta de |