Package google.maps.routeoptimization.v1

int32

Cantidad de envíos realizados. Ten en cuenta que un par de recogida y entrega solo se cuenta una vez.

Duration

Es la duración total del viaje de una ruta o una solución.

Duration

Es la duración total de espera de una ruta o una solución.

Duration

Es la duración total de la demora de una ruta o una solución.

Duration

Es la duración total de la pausa de una ruta o una solución.

Duration

Es la duración total de la visita de una ruta o una solución.

Duration

La duración total debe ser igual a la suma de todas las duraciones anteriores. En el caso de las rutas, también corresponde a lo siguiente:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Es la distancia total de viaje de una ruta o una solución.

map<string, VehicleLoad>

Carga máxima alcanzada en toda la ruta (resp., solución), para cada una de las cantidades de esta ruta (resp., solución), calculada como el máximo de todos los Transition.vehicle_loads (resp., ShipmentRoute.metrics.max_loads.

string

Obligatorio. Proyecto de destino y ubicación para realizar una llamada.

Formato: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Si no se especifica una ubicación, se elegirá una región automáticamente.

AsyncModelConfig

Obligatorio. Información de entrada y salida de cada modelo de compra, como rutas de acceso a archivos y formatos de datos

string

Opcional. Es el nombre del modelo definido por el usuario, que los usuarios pueden usar como alias para hacer un seguimiento de los modelos.

InputConfig

Obligatorio. Información sobre el modelo de entrada.

OutputConfig

Obligatorio. La información de la ubicación de salida deseada

BreakRequest

Es la secuencia de pausas. Consulta el mensaje BreakRequest.

FrequencyConstraint

Es posible que se apliquen varios FrequencyConstraint. Todas deben satisfacer los BreakRequest de este BreakRule. Consulta FrequencyConstraint.

Timestamp

Obligatorio. Límite inferior (inclusive) del inicio de la pausa.

Timestamp

Obligatorio. Es el límite superior (inclusivo) del inicio de la pausa.

Duration

Obligatorio. Es la duración mínima de la pausa. Debe ser positivo.

Duration

Obligatorio. Es la duración mínima de la pausa para esta restricción. No negativo. Consulta la descripción de FrequencyConstraint.

Duration

Obligatorio. Es la duración máxima permitida de cualquier intervalo de tiempo en la ruta que no incluya, al menos de forma parcial, una pausa de duration >= min_break_duration. Debe ser positivo.

int64

Es un límite estricto que restringe la distancia a un máximo de max_meters. El límite no debe ser negativo.

int64

Un límite flexible no aplica un límite de distancia máxima, pero cuando se incumple, genera un costo que se suma a otros costos definidos en el modelo, con la misma unidad.

Si se define, soft_max_meters debe ser inferior a max_meters y no debe ser un valor negativo.

double

El costo por kilómetro incurrido aumenta hasta soft_max_meters con la siguiente fórmula:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Este costo no se admite en route_distance_limit.

double

Se genera un costo por kilómetro si la distancia supera el límite de soft_max_meters. El costo adicional es 0 si la distancia está por debajo del límite. De lo contrario, la fórmula que se usa para calcular el costo es la siguiente:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

El costo no debe ser negativo.

string

Obligatorio. URI de Google Cloud Storage

string

Obligatorio. Es el URI de un objeto de Google Cloud Storage con el formato gs://bucket/path/to/object.

ShipmentRoute

Son las rutas de la solución que se insertarán. Es posible que se omitan algunas rutas de la solución original. Las rutas y los envíos omitidos deben satisfacer las suposiciones de validez básicas que se enumeran para injected_first_solution_routes.

SkippedShipment

Se omitieron los envíos de la solución para insertar. Es posible que se omitan algunos de la solución original. Consulta el campo routes.

ConstraintRelaxation

Para cero o más grupos de vehículos, especifica cuándo y en qué medida se deben relajar las restricciones. Si este campo está vacío, todas las rutas de vehículos que no estén vacías estarán completamente restringidas.

Relaxation

Todas las relajaciones de las restricciones de visitas que se aplicarán a las visitas en rutas con vehículos en vehicle_indices.

int32

Especifica los índices de vehículos a los que se aplica la restricción de visita relaxations. Si está vacío, se considera el valor predeterminado y el relaxations se aplica a todos los vehículos que no se especifican en otros constraint_relaxations. Puede haber como máximo un valor predeterminado, es decir, se permite un campo de relajación de restricciones vacío vehicle_indices. Un índice de vehículo solo se puede incluir una vez, incluso dentro de varios constraint_relaxations.

Un índice de vehículo se asigna de la misma manera que ShipmentRoute.vehicle_index si interpret_injected_solutions_using_labels es verdadero (consulta el comentario fields).

Level

Es el nivel de relajación de restricciones que se aplica cuando se cumplen las condiciones en threshold_time o después de threshold_time Y al menos threshold_visit_count.

Timestamp

Es la hora en la que se puede aplicar la relajación level o después de ella.

int32

Es la cantidad de visitas en las que se puede aplicar la relajación level o después de ellas. Si threshold_visit_count es 0 (o no se establece), se puede aplicar level directamente al inicio del vehículo.

Si es route.visits_size() + 1, level solo se puede aplicar al extremo del vehículo. Si es mayor que route.visits_size() + 1, no se aplica level para esa ruta.

DataFormat

Obligatorio. El formato de los datos de entrada.

GcsSource

Una ubicación de Google Cloud Storage Debe ser un solo objeto (archivo).

LatLng

Son las coordenadas geográficas del punto de referencia.

int32

Es el rumbo de la brújula asociado con la dirección del flujo de tráfico. Este valor se usa para especificar el lado de la ruta que se usará para la partida y la llegada. Los valores de rumbo pueden ser de 0 a 360, en los que 0 especifica un rumbo hacia el norte, 90 especifica un rumbo hacia el este, etcétera.

string

Obligatorio. Proyecto o ubicación de destino para realizar una llamada.

Formato: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Si no se especifica una ubicación, se elegirá una región automáticamente.

Duration

Si se establece este tiempo de espera, el servidor muestra una respuesta antes de que transcurra el período de tiempo de espera o se alcance la fecha límite del servidor para las solicitudes síncronas, lo que ocurra primero.

En el caso de las solicitudes asíncronas, el servidor generará una solución (si es posible) antes de que transcurra el tiempo de espera.

ShipmentModel

Modelo de envío para resolver.

SolvingMode

De forma predeterminada, el modo de resolución es DEFAULT_SOLVE (0).

SearchMode

Es el modo de búsqueda que se usa para resolver la solicitud.

ShipmentRoute

Guía al algoritmo de optimización para que encuentre una primera solución que sea similar a una solución anterior.

El modelo se ve limitado cuando se compila la primera solución. Los envíos que no se realizan en una ruta se omiten de forma implícita en la primera solución, pero se pueden realizar en soluciones sucesivas.

La solución debe satisfacer algunas suposiciones básicas de validez:

• para todas las rutas, vehicle_index debe estar dentro del rango y no debe duplicarse.
• para todas las visitas, shipment_index y visit_request_index deben estar dentro del rango.
• Solo se puede hacer referencia a un envío en una ruta.
• la recolección de un envío con recolección y entrega debe realizarse antes de la entrega.
• No se puede realizar más de una alternativa de retiro o entrega de un envío.
• para todas las rutas, los tiempos aumentan (es decir, vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• Los envíos solo se pueden realizar en vehículos permitidos. Se permite un vehículo si Shipment.allowed_vehicle_indices está vacío o si su vehicle_index se incluye en Shipment.allowed_vehicle_indices.

Si la solución insertada no es factible, no se muestra necesariamente un error de validación, sino que se puede mostrar un error que indica que no es factible.

InjectedSolutionConstraint

Limita el algoritmo de optimización para encontrar una solución final que sea similar a una solución anterior. Por ejemplo, se puede usar para inmovilizar partes de rutas que ya se completaron o que se completarán, pero que no se deben modificar.

Si la solución insertada no es factible, no se muestra necesariamente un error de validación, sino que se puede mostrar un error que indica que no es factible.

ShipmentRoute

Si no están vacías, se actualizarán las rutas determinadas sin modificar su secuencia subyacente de visitas o tiempos de viaje; solo se actualizarán otros detalles. Esto no resuelve el modelo.

A partir de noviembre de 2020, solo se propagan los polilíneas de las rutas no vacías y se requiere que populate_polylines sea verdadero.

Es posible que los campos route_polyline de las rutas pasadas no sean coherentes con la ruta transitions.

Este campo no se debe usar junto con injected_first_solution_routes o injected_solution_constraint.

Shipment.ignore y Vehicle.ignore no tienen efecto en el comportamiento. Las polilíneas se siguen propagando entre todas las visitas en todas las rutas que no están vacías, independientemente de si se ignoran los envíos o los vehículos relacionados.

bool

Si es verdadero, haz lo siguiente:

• Usa ShipmentRoute.vehicle_label en lugar de vehicle_index para hacer coincidir las rutas de una solución insertada con los vehículos de la solicitud. Vuelve a usar la asignación de ShipmentRoute.vehicle_index original a ShipmentRoute.vehicle_index nuevo para actualizar ConstraintRelaxation.vehicle_indices si no está vacía, pero la asignación debe ser inequívoca (es decir, varios ShipmentRoute no deben compartir el mismo vehicle_index original).
• usa ShipmentRoute.Visit.shipment_label en lugar de shipment_index para hacer coincidir las visitas en una solución insertada con los envíos en la solicitud.
• usa SkippedShipment.label en lugar de SkippedShipment.index para hacer coincidir los envíos omitidos en la solución insertada con los envíos de solicitud.

Esta interpretación se aplica a los campos injected_first_solution_routes, injected_solution_constraint y refresh_details_routes. Se puede usar cuando los índices de envíos o vehículos de la solicitud cambiaron desde que se creó la solución, quizás porque se quitaron o agregaron envíos o vehículos a la solicitud.

Si es verdadero, las etiquetas de las siguientes categorías deben aparecer como máximo una vez en su categoría:

• Vehicle.label en la solicitud
• Shipment.label en la solicitud
• ShipmentRoute.vehicle_label en la solución insertada
• SkippedShipment.label y ShipmentRoute.Visit.shipment_label en la solución insertada (excepto los pares de visitas de retiro o entrega, cuyo shipment_label debe aparecer dos veces).

Si un vehicle_label en la solución insertada no corresponde a un vehículo de solicitud, la ruta correspondiente se quita de la solución junto con sus visitas. Si un shipment_label en la solución insertada no corresponde a un envío de solicitud, se quita la visita correspondiente de la solución. Si un SkippedShipment.label en la solución inyectada no corresponde a un envío de solicitud, se quita el SkippedShipment de la solución.

Quitar visitas a rutas o rutas completas de una solución insertada puede tener un efecto en las restricciones implícitas, lo que puede provocar cambios en la solución, errores de validación o inviabilidad.

NOTA: El llamador debe asegurarse de que cada Vehicle.label (resp. Shipment.label) identifica de forma exclusiva una entidad de vehículo (o envío) que se usa en las dos solicitudes relevantes: la solicitud anterior que produjo el OptimizeToursResponse que se usa en la solución insertada y la solicitud actual que incluye la solución insertada. Las verificaciones de unicidad que se describieron anteriormente no son suficientes para garantizar este requisito.

bool

Ten en cuenta la estimación de tráfico cuando calcules los campos ShipmentRoute Transition.travel_duration, Visit.start_time y vehicle_end_time; cuando configures el campo ShipmentRoute.has_traffic_infeasibilities y cuando calcules el campo OptimizeToursResponse.total_cost.

bool

Si es verdadero, se propagarán los polilíneas en las ShipmentRoute de respuesta.

bool

Si es verdadero, los polilíneas y los tokens de ruta se propagarán en la respuesta ShipmentRoute.transitions.

bool

Si se establece, la solicitud puede tener una fecha límite (consulta https://grpc.io/blog/deadlines) de hasta 60 minutos. De lo contrario, el plazo máximo es de solo 30 minutos. Ten en cuenta que las solicitudes de larga duración tienen un riesgo de interrupción mucho mayor (pero aún pequeño).

bool

Si es verdadero, las distancias de viaje se calcularán con distancias geodésicas en lugar de distancias de Google Maps, y los tiempos de viaje se calcularán con distancias geodésicas con una velocidad definida por geodesic_meters_per_second.

string

Etiqueta que se puede usar para identificar esta solicitud, que se informa en OptimizeToursResponse.request_label.

double

Cuando use_geodesic_distances es verdadero, se debe configurar este campo y define la velocidad que se aplica para calcular los tiempos de viaje. Su valor debe ser de al menos 1.0 metros por segundo.

int32

Trunca la cantidad de errores de validación que se muestran. Por lo general, estos errores se adjuntan a una carga útil de error INVALID_ARGUMENT como un detalle de error BadRequest (https://cloud.google.com/apis/design/errors#error_details), a menos que solving_mode=VALIDATE_ONLY: consulta el campo OptimizeToursResponse.validation_errors. El valor predeterminado es 100 y tiene un límite de 10,000.

ShipmentRoute

Son las rutas calculadas para cada vehículo. La ruta i corresponde al vehículo i en el modelo.

string

Es una copia de OptimizeToursRequest.label si se especificó una etiqueta en la solicitud.

SkippedShipment

La lista de todos los envíos omitidos

OptimizeToursValidationError

Es la lista de todos los errores de validación que pudimos detectar de forma independiente. Consulta la explicación de "MULTIPLE ERRORS" para el mensaje OptimizeToursValidationError. En lugar de errores, se incluirán advertencias en el caso de que solving_mode sea DEFAULT_SOLVE.

Metrics

Métricas de duración, distancia y uso de esta solución.

AggregatedMetrics

Se agregan en las rutas. Cada métrica es la suma (o el máximo, para las cargas) de todos los campos ShipmentRoute.metrics con el mismo nombre.

int32

Cantidad de envíos obligatorios omitidos.

int32

Es la cantidad de vehículos utilizados. Nota: Si la ruta de un vehículo está vacía y Vehicle.used_if_route_is_empty es verdadero, se considera que el vehículo está en uso.

Timestamp

Es la hora de inicio más antigua de un vehículo usado, calculada como el mínimo de todos los vehículos usados de ShipmentRoute.vehicle_start_time.

Timestamp

Es la hora de finalización más reciente de un vehículo usado, calculada como el máximo de todos los vehículos usados de ShipmentRoute.vehicle_end_time.

map<string, double>

Es el costo de la solución, desglosado por campos de solicitud relacionados con el costo. Las claves son rutas de proto, en relación con la entrada OptimizeToursRequest, p.ej., "model.shipments.pickups.cost", y los valores son el costo total generado por el campo de costo correspondiente, agregado en toda la solución. En otras palabras, costs["model.shipments.pickups.cost"] es la suma de todos los costos de retiro de la solución. Todos los costos definidos en el modelo se registran en detalle aquí, a excepción de los costos relacionados con TransitionAttributes, que solo se registran de forma agregada a partir de 1/2022.

double

Es el costo total de la solución. Es la suma de todos los valores del mapa de costos.

int32

Un error de validación se define por el par (code, display_name) que siempre está presente.

Los campos que siguen a esta sección proporcionan más contexto sobre el error.

MULTIPLE ERRORS: Cuando hay varios errores, el proceso de validación intenta mostrar varios de ellos. Al igual que un compilador, este es un proceso imperfecto. Algunos errores de validación serán "irreparables", lo que significa que detienen todo el proceso de validación. Este es el caso de los errores de display_name="UNSPECIFIED", entre otros. Algunos errores pueden hacer que el proceso de validación omita otros errores.

ESTABILIDAD: code y display_name deben ser muy estables. Sin embargo, es posible que aparezcan códigos y nombres visibles nuevos con el tiempo, lo que puede hacer que una solicitud determinada (no válida) genere un par diferente (code, display_name) porque el error nuevo ocultó el anterior. Por ejemplo, consulta “MULTIPLE ERRORS”.

string

El nombre visible del error.

FieldReference

Un contexto de error puede incluir 0, 1 (la mayoría de las veces) o más campos. Por ejemplo, para hacer referencia al vehículo n° 4 y a la primera recolección del envío n° 2, puedes hacerlo de la siguiente manera:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Sin embargo, ten en cuenta que la cardinalidad de fields no debe cambiar para un código de error determinado.

string

Es una cadena legible que describe el error. Hay una asignación de uno a uno entre code y error_message (cuando code != "UNSPECIFIED").

ESTABILIDAD: No es estable: el mensaje de error asociado a un code determinado puede cambiar (con suerte, para aclararlo) con el tiempo. En su lugar, usa display_name y code.

string

Puede contener los valores de los campos. Esta opción no siempre está disponible. No debes confiar en él y solo debes usarlo para la depuración manual de modelos.

string

Es el nombre del campo, p.ej., "vehicles".

FieldReference

Subcampo anidado de forma recursiva, si es necesario

int32

Es el índice del campo si se repite.

string

Es clave si el campo es un mapa.

DataFormat

Obligatorio. El formato de los datos de salida.

GcsDestination

La ubicación de Google Cloud Storage en la que se escribirá el resultado.

bool

Especifica si se deben evitar las rutas con peaje cuando sea razonable. Se dará preferencia a las rutas que no contengan rutas con peaje. Solo se aplica a los modos de viaje motorizados.

bool

Especifica si se deben evitar las autopistas cuando sea razonable. Se dará preferencia a las rutas que no contengan autopistas. Solo se aplica a los modos de viaje motorizados.

bool

Especifica si se deben evitar los ferris cuando sea razonable. Se dará preferencia a las rutas que no incluyan viajes en transbordadores. Solo se aplica a los modos de viaje motorizados.

bool

Opcional. Especifica si se debe evitar navegar en interiores cuando sea razonable. Se dará preferencia a las rutas que no contengan navegación en interiores. Solo se aplica al modo de viaje WALKING.

string

Es el nombre visible del envío definido por el usuario. Puede tener hasta 63 caracteres y puede usar caracteres UTF-8.

VisitRequest

Es un conjunto de alternativas de retiro asociadas al envío. Si no se especifica, el vehículo solo debe visitar una ubicación que corresponda a las entregas.

VisitRequest

Es el conjunto de alternativas de entrega asociadas al envío. Si no se especifica, el vehículo solo debe visitar una ubicación que corresponda a los puntos de partida.

map<string, Load>

Cargas del envío (por ejemplo, peso, volumen, cantidad de palés, etcétera) Las claves del mapa deben ser identificadores que describan el tipo de carga correspondiente, lo ideal es que también incluyan las unidades. Por ejemplo: "weight_kg", "volume_gallons", "pallet_count", etc. Si una clave determinada no aparece en el mapa, la carga correspondiente se considera nula.

int32

Es el conjunto de vehículos que pueden realizar este envío. Si está vacío, todos los vehículos pueden realizarlo. Los vehículos se indican por su índice en la lista vehicles de ShipmentModel.

double

Especifica el costo que se genera cuando cada vehículo entrega este envío. Si se especifica, debe tener UNO de los siguientes elementos:

• la misma cantidad de elementos que costs_per_vehicle_indices. costs_per_vehicle[i] corresponde al vehículo costs_per_vehicle_indices[i] del modelo.
• la misma cantidad de elementos que hay vehículos en el modelo. El elemento i corresponde al vehículo n° i del modelo.

Estos costos deben estar en la misma unidad que penalty_cost y no deben ser negativos. Deja este campo vacío si no hay costos de este tipo.

int32

Índices de los vehículos a los que se aplica costs_per_vehicle. Si no está vacío, debe tener la misma cantidad de elementos que costs_per_vehicle. No se puede especificar un índice de vehículo más de una vez. Si se excluye un vehículo de costs_per_vehicle_indices, su costo es cero.

Duration

Especifica el tiempo máximo de desvío absoluto en comparación con la ruta más corta desde la partida hasta la entrega. Si se especifica, debe ser un número no negativo, y el envío debe contener al menos una recogida y una entrega.

Por ejemplo, supongamos que t es el tiempo más corto que se tarda en ir de la alternativa de retiro seleccionada directamente a la alternativa de entrega seleccionada. Luego, la configuración de pickup_to_delivery_absolute_detour_limit aplica lo siguiente:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Si se especifican los límites relativos y absolutos en el mismo envío, se usa el límite más restrictivo para cada par de recolección y entrega posibles. A partir de octubre de 2017, solo se admiten desvíos cuando las duraciones de viaje no dependen de los vehículos.

Duration

Especifica la duración máxima desde el inicio del retiro hasta el inicio de la entrega de un envío. Si se especifica, debe ser un número no negativo, y el envío debe contener al menos una recolección y una entrega. Esto no depende de las alternativas seleccionadas para el retiro y la entrega ni de la velocidad del vehículo. Esto se puede especificar junto con las restricciones de desvío máximo: la solución respetará ambas especificaciones.

string

Es una cadena no vacía que especifica un “tipo” para este envío. Esta función se puede usar para definir incompatibilidades o requisitos entre shipment_types (consulta shipment_type_incompatibilities y shipment_type_requirements en ShipmentModel).

Se diferencia de visit_types, que se especifica para una sola visita: Todas las entregas o retiros que pertenecen al mismo envío comparten el mismo shipment_type.

string

Especifica una etiqueta para este envío. Esta etiqueta se informa en la respuesta en el shipment_label del ShipmentRoute.Visit correspondiente.

bool

Si es verdadero, omite este envío, pero no apliques un penalty_cost.

Si se ignora un envío, se produce un error de validación cuando hay algún shipment_type_requirements en el modelo.

Se permite ignorar un envío que se realiza en injected_first_solution_routes o injected_solution_constraint. El solucionador quita las visitas de retiro o entrega relacionadas de la ruta de ejecución. También se ignorarán los precedence_rules que hagan referencia a envíos ignorados.

double

Si no se completa el envío, esta penalización se agrega al costo general de las rutas. Un envío se considera completado si se visita una de sus alternativas de retiro y entrega. El costo se puede expresar en la misma unidad que se usa para todos los demás campos relacionados con el costo en el modelo y debe ser positivo.

IMPORTANTE: Si no se especifica esta penalización, se considera infinita, es decir, el envío debe completarse.

double

Especifica el tiempo máximo de desvío relativo en comparación con la ruta más corta desde la recogida hasta la entrega. Si se especifica, debe ser un número no negativo, y el envío debe contener al menos una recolección y una entrega.

Por ejemplo, supongamos que t es el tiempo más corto que se tarda en ir de la alternativa de retiro seleccionada directamente a la alternativa de entrega seleccionada. Luego, la configuración de pickup_to_delivery_relative_detour_limit aplica lo siguiente:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Si se especifican los límites relativos y absolutos en el mismo envío, se usa el límite más restrictivo para cada par de recolección y entrega posibles. A partir de octubre de 2017, solo se admiten desvíos cuando las duraciones de viaje no dependen de los vehículos.

int64

Es el importe en el que variará la carga del vehículo que realiza la visita correspondiente. Dado que es un número entero, se recomienda a los usuarios que elijan una unidad adecuada para evitar la pérdida de precisión. Debe ser ≥ 0.

LatLng

Es la ubicación geográfica a la que llega el vehículo cuando realiza esta VisitRequest. Si el modelo de envío tiene matrices de distancia de duración, no se debe especificar arrival_location.

Waypoint

El punto de referencia al que llega el vehículo cuando realiza esta VisitRequest. Si el modelo de envío tiene matrices de distancia de duración, no se debe especificar arrival_waypoint.

LatLng

Es la geolocalización desde la que sale el vehículo después de completar este VisitRequest. Se puede omitir si es igual a arrival_location. Si el modelo de envío tiene matrices de distancia de duración, no se debe especificar departure_location.

Waypoint

Es el punto de referencia desde el que sale el vehículo después de completar este VisitRequest. Se puede omitir si es igual a arrival_waypoint. Si el modelo de envío tiene matrices de distancia de duración, no se debe especificar departure_waypoint.

string

Especifica las etiquetas adjuntas a la solicitud de visita. No se permiten cadenas vacías ni duplicadas.

TimeWindow

Son períodos que limitan la hora de llegada en una visita. Ten en cuenta que un vehículo puede salir fuera del período de la hora de llegada, es decir, la hora de llegada y la duración no tienen que estar dentro de un período. Esto puede generar un tiempo de espera si el vehículo llega antes de TimeWindow.start_time.

La ausencia de TimeWindow significa que el vehículo puede realizar esta visita en cualquier momento.

Las ventanas de tiempo deben ser disjuntas, es decir, ninguna debe superponerse con otra ni estar adyacente a ella, y deben estar en orden creciente.

cost_per_hour_after_soft_end_time y soft_end_time solo se pueden configurar si hay un solo período.

Duration

Es la duración de la visita, es decir, el tiempo que el vehículo pasa entre la llegada y la salida (se debe agregar al tiempo de espera posible; consulta time_windows).

double

Es el costo de atender esta solicitud de visita en una ruta del vehículo. Esto se puede usar para pagar diferentes costos por cada retiro o entrega alternativa de un envío. Este costo debe estar en la misma unidad que Shipment.penalty_cost y no debe ser negativo.

map<string, Load>

Carga las demandas de esta solicitud de visita. Es similar al campo Shipment.load_demands, excepto que solo se aplica a este VisitRequest en lugar de a todo el Shipment. Las demandas que se indican aquí se agregan a las que se indican en Shipment.load_demands.

string

Especifica los tipos de visita. Se puede usar para asignar el tiempo adicional necesario para que un vehículo complete esta visita (consulta Vehicle.extra_visit_duration_for_visit_type).

Un tipo solo puede aparecer una vez.

string

Especifica una etiqueta para este VisitRequest. Esta etiqueta se informa en la respuesta como visit_label en el ShipmentRoute.Visit correspondiente.

Shipment

Es el conjunto de envíos que se deben realizar en el modelo.

Vehicle

Es un conjunto de vehículos que se pueden usar para realizar visitas.

Timestamp

Horas de inicio y finalización globales del modelo: No se pueden considerar válidas las horas fuera de este rango.

El período del modelo debe ser inferior a un año, es decir, global_end_time y global_start_time deben estar dentro de un período de 31,536,000 segundos.

Cuando uses campos cost_per_*hour, te recomendamos que configures este período en un intervalo más pequeño para aumentar el rendimiento (p. ej., si modelas un solo día, debes establecer los límites de tiempo globales para ese día). Si no se establece, se usa de forma predeterminada el 1 de enero de 1970 a las 00:00:00 UTC (es decir, segundos: 0, nanos: 0).

Timestamp

Si no se establece, se usa de forma predeterminada el valor 00:00:00 UTC del 1 de enero de 1971 (es decir, segundos: 31536000, nanos: 0).

double

La "duración global" del plan general es la diferencia entre la hora de inicio efectiva más temprana y la hora de finalización efectiva más reciente de todos los vehículos. Los usuarios pueden asignar un costo por hora a esa cantidad para intentar optimizar la finalización de la tarea lo antes posible, por ejemplo. Este costo debe estar en la misma unidad que Shipment.penalty_cost.

DurationDistanceMatrix

Especifica las matrices de duración y distancia que se usan en el modelo. Si este campo está vacío, se usarán Google Maps o distancias geodésicas, según el valor del campo use_geodesic_distances. Si no está vacío, use_geodesic_distances no puede ser verdadero y ni duration_distance_matrix_src_tags ni duration_distance_matrix_dst_tags pueden estar vacíos.

Ejemplos de uso:

• Hay dos ubicaciones: locA y locB.
• 1 vehículo que inicia su ruta en locA y la finaliza en locA.
• 1 solicitud de visita de retiro en locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Hay tres ubicaciones: locA, locB y locC.
• 1 vehículo que inicia su ruta en locA y la finaliza en locB, con la matriz "rápida".
• 1 vehículo que inicia su ruta en locB y la finaliza en locB, con la matriz "lenta".
• 1 vehículo que inicia su ruta en locB y la finaliza en locB, con la matriz "rápida".
• 1 solicitud de visita de retiro en locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Etiquetas que definen las fuentes de las matrices de duración y distancia. duration_distance_matrices(i).rows(j) define las duraciones y las distancias de las visitas con la etiqueta duration_distance_matrix_src_tags(j) a otras visitas en la matriz i.

Las etiquetas corresponden a VisitRequest.tags o Vehicle.start_tags. Un VisitRequest o Vehicle determinado debe coincidir exactamente con una etiqueta en este campo. Ten en cuenta que las etiquetas de origen, destino y matriz de un Vehicle pueden ser las mismas. Del mismo modo, las etiquetas de origen y destino de un VisitRequest pueden ser las mismas. Todas las etiquetas deben ser diferentes y no pueden ser cadenas vacías. Si este campo no está vacío, duration_distance_matrices tampoco debe estarlo.

string

Etiquetas que definen los destinos de las matrices de duración y distancia; duration_distance_matrices(i).rows(j).durations(k) (resp. duration_distance_matrices(i).rows(j).meters(k)) define la duración (o la distancia) del viaje de las visitas con la etiqueta duration_distance_matrix_src_tags(j) a las visitas con la etiqueta duration_distance_matrix_dst_tags(k) en la matriz i.

Las etiquetas corresponden a VisitRequest.tags o Vehicle.start_tags. Un VisitRequest o Vehicle determinado debe coincidir exactamente con una etiqueta en este campo. Ten en cuenta que las etiquetas de origen, destino y matriz de un Vehicle pueden ser las mismas. Del mismo modo, las etiquetas de origen y destino de un VisitRequest pueden ser las mismas. Todas las etiquetas deben ser diferentes y no pueden ser cadenas vacías. Si este campo no está vacío, duration_distance_matrices tampoco debe estarlo.

TransitionAttributes

Atributos de transición agregados al modelo.

ShipmentTypeIncompatibility

Conjuntos de shipment_types incompatibles (consulta ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Conjuntos de requisitos de shipment_type (consulta ShipmentTypeRequirement).

PrecedenceRule

Es un conjunto de reglas de prioridad que se deben aplicar en el modelo.

int32

Limita la cantidad máxima de vehículos activos. Un vehículo está activo si su ruta realiza al menos un envío. Esto se puede usar para limitar la cantidad de rutas en el caso de que haya menos conductores que vehículos y la flota de vehículos sea heterogénea. Luego, la optimización seleccionará el mejor subconjunto de vehículos para usar. Debe ser estrictamente positivo.

Row

Especifica las filas de la matriz de duración y distancia. Debe tener tantos elementos como ShipmentModel.duration_distance_matrix_src_tags.

string

Es la etiqueta que define a qué vehículos se aplica esta matriz de duración y distancia. Si está vacía, se aplica a todos los vehículos y solo puede haber una matriz.

Cada inicio de vehículo debe coincidir exactamente con una matriz, es decir, exactamente uno de sus campos start_tags debe coincidir con el vehicle_start_tag de una matriz (y solo de esa matriz).

Todas las matrices deben tener un vehicle_start_tag diferente.

Duration

Valores de duración para una fila determinada. Debe tener tantos elementos como ShipmentModel.duration_distance_matrix_dst_tags.

double

Valores de distancia para una fila determinada. Si no hay costos ni restricciones que se refieran a distancias en el modelo, se puede dejar vacío. De lo contrario, debe tener tantos elementos como durations.

bool

Indica si el evento "primero" es una publicación.

bool

Indica si el "segundo" evento es una publicación.

Duration

Es la compensación entre el "primer" y el "segundo" evento. Puede ser negativo.

int32

Es el índice de envío del "primer" evento. Se debe especificar este campo.

int32

Es el índice de envío del "segundo" evento. Se debe especificar este campo.

int32

Es el vehículo que realiza la ruta, identificado por su índice en el ShipmentModel de origen.

string

Etiqueta del vehículo que realiza esta ruta, igual a ShipmentModel.vehicles(vehicle_index).label, si se especifica.

Timestamp

Hora en la que el vehículo comienza su ruta.

Timestamp

Hora a la que el vehículo termina su ruta.

Visit

Es una secuencia ordenada de visitas que representa una ruta. visits[i] es la i-ésima visita en la ruta. Si este campo está vacío, el vehículo se considera como no utilizado.

Transition

Es la lista ordenada de transiciones de la ruta.

bool

Cuando OptimizeToursRequest.consider_road_traffic se establece en verdadero, este campo indica que se predicen inconsistencias en los horarios de las rutas con estimaciones de duración del viaje basadas en el tráfico. Es posible que no haya tiempo suficiente para completar los viajes ajustados al tráfico, las demoras y las pausas entre visitas, antes de la primera visita o después de la última, y cumplir con los horarios de las visitas y los vehículos. Por ejemplo:

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Es probable que la llegada a next_visit se produzca más tarde que el período actual debido al aumento de la estimación del tiempo de viaje travel_duration(previous_visit, next_visit) debido al tráfico. Además, es posible que una pausa se superponga con una visita debido a un aumento en las estimaciones de tiempo de viaje y las restricciones de los períodos de visita o descanso.

EncodedPolyline

Es la representación de la polilínea codificada de la ruta. Este campo solo se propaga si OptimizeToursRequest.populate_polylines está configurado como verdadero.

Break

Pausas programadas para el vehículo que realiza esta ruta. La secuencia breaks representa intervalos de tiempo, cada uno de los cuales comienza en el start_time correspondiente y dura duration segundos.

AggregatedMetrics

Métricas de duración, distancia y carga de esta ruta. Los campos de AggregatedMetrics se suman en todos los ShipmentRoute.transitions o ShipmentRoute.visits, según el contexto.

map<string, double>

Es el costo de la ruta, desglosado por campos de solicitud relacionados con el costo. Las claves son rutas de proto, en relación con la entrada OptimizeToursRequest, p.ej., "model.shipments.pickups.cost", y los valores son el costo total generado por el campo de costo correspondiente, agregado en toda la ruta. En otras palabras, costs["model.shipments.pickups.cost"] es la suma de todos los costos de retiro en la ruta. Todos los costos definidos en el modelo se registran en detalle aquí, a excepción de los costos relacionados con TransitionAttributes, que solo se registran de forma agregada a partir de 1/2022.

double

Es el costo total de la ruta. Es la suma de todos los costos del mapa de costos.

Timestamp

Es la hora de inicio de una pausa.

Duration

Es la duración de una pausa.

string

Es una cadena que representa los puntos codificados de la polilínea.

Duration

Es la duración del viaje durante esta transición.

double

Distancia recorrida durante la transición.

bool

Cuando se solicita el tráfico a través de OptimizeToursRequest.consider_road_traffic y no se puede recuperar la información de tráfico para un Transition, este valor booleano se establece en verdadero. Esto puede ser temporal (un error poco frecuente en los servidores de tráfico en tiempo real) o permanente (no hay datos para esta ubicación).

Duration

Es la suma de las duraciones de demora aplicadas a esta transición. Si hay alguna, la demora comienza exactamente delay_duration segundos antes del siguiente evento (visita o finalización del vehículo). Consulta los TransitionAttributes.delay.

Duration

Es la suma de la duración de las pausas que se producen durante esta transición, si corresponde. Los detalles sobre la hora de inicio y la duración de cada pausa se almacenan en ShipmentRoute.breaks.

Duration

Es el tiempo que se pasó esperando durante esta transición. La duración de la espera corresponde al tiempo inactivo y no incluye el tiempo de descanso. Además, ten en cuenta que este tiempo de espera puede dividirse en varios intervalos no contiguos.

Duration

Es la duración total de la transición, que se proporciona para mayor comodidad. Es igual a lo siguiente:

• próxima visita start_time (o vehicle_end_time si esta es la última transición): start_time de esta transición
• Si ShipmentRoute.has_traffic_infeasibilities es falso, también se cumple lo siguiente: "total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Es la hora de inicio de esta transición.

EncodedPolyline

Es la representación de polilínea codificada de la ruta que se siguió durante la transición. Este campo solo se propaga si populate_transition_polylines está configurado como verdadero.

string

Solo salida. Es un token opaco que se puede pasar al SDK de Navigation para reconstruir la ruta durante la navegación y, en caso de que se cambie la ruta, respetar la intención original cuando se creó la ruta. Trata este token como un blob opaco. No compares su valor entre las solicitudes, ya que puede cambiar incluso si el servicio muestra exactamente la misma ruta. Este campo solo se propaga si populate_transition_polylines está configurado como verdadero.

map<string, VehicleLoad>

Cargas de vehículos durante esta transición, para cada tipo que aparezca en el Vehicle.load_limits de este vehículo o que tenga un Shipment.load_demands distinto de cero en algún envío realizado en esta ruta.

Las cargas durante la primera transición son las cargas iniciales de la ruta del vehículo. Luego, después de cada visita, se agregan o se restan los load_demands de la visita para obtener las cargas de la siguiente transición, según si la visita fue una recolección o una entrega.

int64

Es la cantidad de carga del vehículo para el tipo determinado. Por lo general, el tipo indica la unidad de carga. Consulta los Transition.vehicle_loads.

int32

Es el índice del campo shipments en el ShipmentModel de origen.

bool

Si es verdadero, la visita corresponde a la recolección de un Shipment. De lo contrario, corresponde a una publicación.

int32

Índice de VisitRequest en el campo de retiro o entrega de Shipment (consulta is_pickup).

Timestamp

Hora en la que comienza la visita. Ten en cuenta que el vehículo puede llegar antes a la ubicación de la visita. Los tiempos son coherentes con los de ShipmentModel.

map<string, Load>

Demanda total de carga de visitas como la suma del envío y la solicitud de visita load_demands. Los valores son negativos si la visita es una entrega. Las solicitudes se registran para los mismos tipos que Transition.loads (consulta este campo).

Duration

Tiempo adicional de desvío debido a los envíos visitados en la ruta antes de la visita y al posible tiempo de espera inducido por los períodos. Si la visita es una entrega, el desvío se calcula a partir de la visita de retiro correspondiente y es igual a lo siguiente:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

De lo contrario, se calcula a partir del start_location del vehículo y es igual a lo siguiente:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Es la copia del Shipment.label correspondiente, si se especifica en Shipment.

string

Es la copia del VisitRequest.label correspondiente, si se especifica en VisitRequest.

string

Es la lista de tipos incompatibles. Dos envíos que tienen shipment_types diferentes entre los que se enumeran son “incompatibles”.

IncompatibilityMode

Es el modo que se aplica a la incompatibilidad.

string

Es la lista de tipos de envío alternativos que requiere dependent_shipment_types.

string

Todos los envíos con un tipo en el campo dependent_shipment_types requieren que se visite al menos un envío de tipo required_shipment_type_alternatives en la misma ruta.

NOTA: No se permiten cadenas de requisitos de modo que un shipment_type dependa de sí mismo.

RequirementMode

Es el modo aplicado al requisito.

int32

El índice corresponde al índice del envío en el ShipmentModel de origen.

string

Es la copia del Shipment.label correspondiente, si se especifica en Shipment.

Reason

Una lista de motivos que explican por qué se omitió el envío. Consulta el comentario anterior a Reason. Si no podemos comprender por qué se omitió un envío, no se establecerán los motivos.

Code

Consulta los comentarios de Code.

string

Si el código de motivo es DEMAND_EXCEEDS_VEHICLE_CAPACITY, se documenta un tipo de capacidad que se superó.

int32

Si el motivo se relaciona con una incompatibilidad entre el envío y el vehículo, este campo proporciona el índice de un vehículo relevante.

Timestamp

Es la hora de inicio del período de tiempo fijo. Si no se especifica, se establecerá en ShipmentModel.global_start_time.

Timestamp

La hora de finalización del período fijo Si no se especifica, se establecerá en ShipmentModel.global_end_time.

Timestamp

Es la hora de inicio flexible del período.

Timestamp

Es la hora de finalización flexible del período.

double

Es un costo por hora que se agrega a otros costos del modelo si el evento ocurre antes de soft_start_time, calculado de la siguiente manera:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Este costo debe ser positivo, y el campo solo se puede establecer si se configuró soft_start_time.

double

Es un costo por hora que se suma a otros costos del modelo si el evento ocurre después de soft_end_time, que se calcula de la siguiente manera:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Este costo debe ser positivo, y el campo solo se puede establecer si se configuró soft_end_time.

string

Son etiquetas que definen el conjunto de transiciones (src->dst) a las que se aplican estos atributos.

Una visita a la fuente o un inicio de vehículo coinciden si su VisitRequest.tags o Vehicle.start_tags contiene src_tag o no contiene excluded_src_tag (según cuál de estos dos campos no esté vacío).

string

Consulta los src_tag. Exactamente uno de src_tag y excluded_src_tag debe no estar vacío.

string

Una visita al destino o el final del viaje coinciden si su VisitRequest.tags o Vehicle.end_tags contiene dst_tag o no contiene excluded_dst_tag (según cuál de estos dos campos no esté vacío).

string

Consulta los dst_tag. Exactamente uno de dst_tag y excluded_dst_tag debe no estar vacío.

double

Especifica un costo para realizar esta transición. Se expresa en la misma unidad que todos los demás costos del modelo y no debe ser negativo. Se aplica además de todos los demás costos existentes.

double

Especifica un costo por kilómetro aplicado a la distancia recorrida durante esta transición. Se suma a cualquier Vehicle.cost_per_kilometer especificado en los vehículos.

DistanceLimit

Especifica un límite para la distancia recorrida durante la realización de esta transición.

A partir de junio de 2021, solo se admiten límites flexibles.

Duration

Especifica una demora que se produce cuando se realiza esta transición.

Esta demora siempre ocurre después de finalizar la visita a la fuente y antes de iniciar la visita al destino.

string

Es el nombre visible del vehículo definido por el usuario. Puede tener hasta 63 caracteres y puede usar caracteres UTF-8.

TravelMode

El modo de viaje, que afecta las rutas que puede usar el vehículo y su velocidad. Consulta también travel_duration_multiple.

RouteModifiers

Es un conjunto de condiciones que se deben cumplir y que afectan la forma en que se calculan las rutas para el vehículo determinado.

LatLng

Es la ubicación geográfica donde comienza el vehículo antes de recoger los envíos. Si no se especifica, el vehículo comienza en su primer punto de partida. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar start_location.

Waypoint

Punto de referencia que representa una ubicación geográfica donde comienza el vehículo antes de recoger los envíos. Si no se especifican start_waypoint ni start_location, el vehículo comienza en su primer punto de partida. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar start_waypoint.

LatLng

Es la ubicación geográfica donde finaliza el vehículo después de completar su último VisitRequest. Si no se especifica, el ShipmentRoute del vehículo finaliza de inmediato cuando completa su último VisitRequest. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar end_location.

Waypoint

Punto de referencia que representa una ubicación geográfica en la que finaliza el vehículo después de completar su último VisitRequest. Si no se especifican end_waypoint ni end_location, el ShipmentRoute del vehículo finaliza de inmediato cuando completa su último VisitRequest. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar end_waypoint.

string

Especifica las etiquetas adjuntas al inicio de la ruta del vehículo.

No se permiten cadenas vacías ni duplicadas.

string

Especifica las etiquetas adjuntas al final de la ruta del vehículo.

No se permiten cadenas vacías ni duplicadas.

TimeWindow

Son los períodos durante los cuales el vehículo puede salir de su ubicación de partida. Deben estar dentro de los límites de tiempo globales (consulta los campos ShipmentModel.global_*). Si no se especifica, no hay limitaciones además de esos límites de tiempo globales.

Los períodos que pertenecen al mismo campo repetido deben ser disjuntos, es decir, ningún período puede superponerse con otro ni estar adyacente a otro, y deben estar en orden cronológico.

cost_per_hour_after_soft_end_time y soft_end_time solo se pueden configurar si hay un solo período.

TimeWindow

Son los períodos durante los cuales el vehículo puede llegar a su ubicación de destino. Deben estar dentro de los límites de tiempo globales (consulta los campos ShipmentModel.global_*). Si no se especifica, no hay limitaciones además de esos límites de tiempo globales.

Los períodos que pertenecen al mismo campo repetido deben ser disjuntos, es decir, ningún período puede superponerse con otro ni estar adyacente a otro, y deben estar en orden cronológico.

cost_per_hour_after_soft_end_time y soft_end_time solo se pueden configurar si hay un solo período.

UnloadingPolicy

Se aplicó la política de descarga en el vehículo.

map<string, LoadLimit>

Capacidades del vehículo (por ejemplo, peso, volumen, cantidad de palés) Las claves del mapa son los identificadores del tipo de carga, coherentes con las claves del campo Shipment.load_demands. Si no hay una clave determinada en este mapa, se considera que la capacidad correspondiente no tiene límites.

double

Costos del vehículo: Todos los costos se suman y deben estar en la misma unidad que Shipment.penalty_cost.

Es el costo por hora de la ruta del vehículo. Este costo se aplica al tiempo total que tarda la ruta y, además, incluye el tiempo de viaje, el tiempo de espera y el tiempo de visita. El uso de cost_per_hour en lugar de solo cost_per_traveled_hour puede generar latencia adicional.

double

Es el costo por hora recorrida de la ruta del vehículo. Este costo se aplica solo al tiempo de viaje que tarda la ruta (es decir, el que se informa en ShipmentRoute.transitions) y excluye el tiempo de espera y el tiempo de visita.

double

Es el costo por kilómetro de la ruta del vehículo. Este costo se aplica a la distancia informada en ShipmentRoute.transitions y no a ninguna distancia recorrida implícitamente de arrival_location a departure_location de un solo VisitRequest.

double

Es el costo fijo que se aplica si se usa este vehículo para manejar un envío.

bool

Este campo solo se aplica a los vehículos cuando su ruta no entrega ningún envío. Indica si el vehículo se debe considerar usado o no en este caso.

Si es verdadero, el vehículo va de su ubicación de inicio a la de destino, incluso si no entrega ningún envío, y se tienen en cuenta los costos de tiempo y distancia que resultan del viaje de inicio a destino.

De lo contrario, no viaja desde su ubicación de inicio hasta la de destino, y no se programan break_rule ni demoras (de TransitionAttributes) para este vehículo. En este caso, el ShipmentRoute del vehículo no contiene información, excepto el índice y la etiqueta del vehículo.

DurationLimit

Es el límite que se aplica a la duración total de la ruta del vehículo. En un OptimizeToursResponse determinado, la duración de la ruta de un vehículo es la diferencia entre su vehicle_end_time y vehicle_start_time.

DurationLimit

Es el límite que se aplica a la duración del viaje de la ruta del vehículo. En un OptimizeToursResponse determinado, la duración del viaje de la ruta es la suma de todos sus transitions.travel_duration.

DistanceLimit

Es el límite que se aplica a la distancia total de la ruta del vehículo. En un OptimizeToursResponse determinado, la distancia de la ruta es la suma de todos sus transitions.travel_distance_meters.

map<string, Duration>

Especifica un mapa de cadenas de visit_types a duraciones. La duración es el tiempo adicional a VisitRequest.duration que se debe tomar en las visitas con el visit_types especificado. Esta duración de visita adicional agrega un costo si se especifica cost_per_hour. Las claves (es decir, visit_types) no pueden ser cadenas vacías.

Si una solicitud de visita tiene varios tipos, se agregará una duración para cada uno de ellos en el mapa.

BreakRule

Describe el programa de descansos que se aplicará en este vehículo. Si está vacío, no se programarán descansos para este vehículo.

string

Especifica una etiqueta para este vehículo. Esta etiqueta se informa en la respuesta como el vehicle_label del ShipmentRoute correspondiente.

bool

Si es verdadero, used_if_route_is_empty debe ser falso y este vehículo no se usará.

Si un vehículo ignorado realiza un envío en injected_first_solution_routes, se omite en la primera solución, pero se puede realizar en la respuesta.

Si un vehículo ignorado realiza un envío en injected_solution_constraint y cualquier retiro o entrega relacionados se restringen para permanecer en el vehículo (es decir, no se relajan al nivel RELAX_ALL_AFTER_THRESHOLD), se omite en la respuesta. Si un envío tiene un campo allowed_vehicle_indices no vacío y se ignoran todos los vehículos permitidos, se omite en la respuesta.

double

Especifica un factor multiplicativo que se puede usar para aumentar o disminuir los tiempos de viaje de este vehículo. Por ejemplo, si se establece en 2.0, significa que este vehículo es más lento y tiene tiempos de viaje el doble de los que tienen los vehículos estándar. Este múltiplo no afecta las duraciones de las visitas. Sí afecta el costo si se especifican cost_per_hour o cost_per_traveled_hour. Debe estar en el rango [0.001, 1000.0]. Si no se establece, el vehículo es estándar y este múltiplo se considera 1.0.

ADVERTENCIA: Los tiempos de viaje se redondearán al segundo más cercano después de aplicar este múltiplo, pero antes de realizar cualquier operación numérica. Por lo tanto, un múltiplo pequeño puede provocar una pérdida de precisión.

Consulta también extra_visit_duration_for_visit_type a continuación.

Duration

Es un límite estricto que restringe la duración a un máximo de max_duration.

Duration

Un límite flexible no aplica un límite de duración máxima, pero, cuando se incumple, hace que la ruta incurra en un costo. Este costo se suma a otros costos definidos en el modelo, con la misma unidad.

Si se define, soft_max_duration debe ser no negativa. Si también se define max_duration, soft_max_duration debe ser menor que max_duration.

Duration

Un límite flexible no aplica un límite de duración máximo, pero cuando se incumple, hace que la ruta incurra en un costo cuadrático en la duración. Este costo se suma a otros costos definidos en el modelo, con la misma unidad.

Si se define, quadratic_soft_max_duration debe ser no negativa. Si también se define max_duration, quadratic_soft_max_duration debe ser menor que max_duration y la diferencia no debe ser mayor que un día:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Es el costo por hora que se genera si se incumple el límite de soft_max_duration. El costo adicional es de 0 si la duración es inferior al umbral. De lo contrario, el costo depende de la duración de la siguiente manera:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

El costo no debe ser negativo.

double

Es el costo por hora cuadrada que se genera si se incumple el límite de quadratic_soft_max_duration.

El costo adicional es de 0 si la duración es inferior al umbral. De lo contrario, el costo depende de la duración de la siguiente manera:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

El costo no debe ser negativo.

int64

Es un límite flexible de la carga. Consulta los cost_per_unit_above_soft_max.

double

Si la carga supera soft_max_load a lo largo de la ruta de este vehículo, se aplica la siguiente penalización de costos (solo una vez por vehículo): (carga - soft_max_load) * cost_per_unit_above_soft_max. Todos los costos se suman y deben estar en la misma unidad que Shipment.penalty_cost.

Interval

Es el intervalo de carga aceptable del vehículo al comienzo de la ruta.

Interval

Es el intervalo de carga aceptable del vehículo al final de la ruta.

int64

Es la cantidad máxima de carga aceptable.

int64

Una carga mínima aceptable Debe ser ≥ 0. Si se especifican ambos, min debe ser ≤ max.

int64

Una carga máxima aceptable. Debe ser ≥ 0. Si no se especifica, este mensaje no restringe la carga máxima. Si se especifican ambos, min debe ser ≤ max.

bool

Opcional. Indica que la ubicación de este punto de referencia tiene la preferencia de que el vehículo se detenga en un lado particular de la ruta. Cuando establezcas este valor, la ruta pasará por la ubicación para que el vehículo pueda detenerse en el lado de la ruta hacia el que se orienta la ubicación desde el centro de la ruta. Esta opción no funciona para el modo de viaje "CAMINAR".

Location

Es un punto especificado con coordenadas geográficas, incluido un encabezado opcional.

string

El ID de lugar del lugar de interés asociado con el punto de referencia.