Package google.maps.routeoptimization.v1

int32

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

Duration

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

Duration

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

Duration

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

Duration

Es la duración total de las pausas para una ruta o una solución.

Duration

Es la duración total de la visita para 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 para una ruta o una solución.

map<string, VehicleLoad>

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

int32

Cantidad de envíos obligatorios realizados.

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

double

Es la suma del Shipment.penalty_cost de los envíos realizados.

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

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 y se puede usar como alias para hacer un seguimiento de los modelos.

InputConfig

Obligatorio. Es información sobre el modelo de entrada.

OutputConfig

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

BreakRequest

Es la secuencia de interrupciones. Ver el mensaje BreakRequest

FrequencyConstraint

Se pueden aplicar varios FrequencyConstraint. Todas deben satisfacerse con los BreakRequest de este BreakRule. Consulta FrequencyConstraint.

Timestamp

Obligatorio. Límite inferior (inclusive) del inicio del receso.

Timestamp

Obligatorio. Límite superior (inclusive) 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 este parámetro de restricción. No negativo. Consulta la descripción de FrequencyConstraint.

Duration

Obligatorio. Es el lapso máximo permitido de cualquier intervalo de tiempo en la ruta que no incluye, al menos de forma parcial, una interrupción 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

Es un límite flexible que no aplica un límite de distancia máximo, 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 menor que max_meters y no debe ser negativo.

double

Costo por kilómetro incurrido, que 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

Es el costo por kilómetro en el que se incurre 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. 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á. Es posible que algunas rutas se omitan de la solución original. Las rutas y los envíos omitidos deben satisfacer las suposiciones básicas de validez que se indican para injected_first_solution_routes.

SkippedShipment

Son los envíos omitidos de la solución que se insertará. Es posible que algunos se omitan en la solución original. Observa el campo routes.

ConstraintRelaxation

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

Relaxation

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

int32

Especifica los índices de los vehículos a los que se aplica la restricción de visita relaxations. Si está vacío, se considera el valor predeterminado y los relaxations se aplican 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 que como máximo un campo de relajación de restricciones esté vacío vehicle_indices. Un índice de vehículos solo se puede incluir una vez, incluso en 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 de fields).

Level

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

Timestamp

Fecha y hora en la que se puede aplicar la relajación level.

int32

Cantidad de visitas a partir de la cual se puede aplicar la relajación level. Si threshold_visit_count es 0 (o no está configurado), el level se puede aplicar directamente al inicio del vehículo.

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

DataFormat

Obligatorio. Es el formato de los datos de entrada.

GcsSource

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

LatLng

Son las coordenadas geográficas de la parada.

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 recogida y la entrega. Los valores de dirección pueden ser de 0 a 360, donde 0 especifica una dirección hacia el norte, 90 especifica una dirección 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 devuelve una respuesta antes de que transcurra el período de tiempo de espera o se alcance el plazo 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 se agote el tiempo de espera.

ShipmentModel

Es el modelo de envío que se debe resolver.

SolvingMode

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

SearchMode

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

ShipmentRoute

Guía el algoritmo de optimización para encontrar una primera solución similar a una solución anterior.

El modelo se restringe cuando se crea 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 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 partida de un envío de retiro 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).
• El envío solo se puede realizar en un vehículo permitido. 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 necesariamente se muestra un error de validación, sino que se puede mostrar un error que indique que no es factible.

InjectedSolutionConstraint

Restringe 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 deben completar, pero no se deben modificar.

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

ShipmentRoute

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

Desde el 2020/11, esto solo completa las polilíneas de las rutas no vacías y requiere que populate_polylines sea verdadero.

Los campos route_polyline de las rutas que se pasan pueden no ser 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 no vacías, independientemente de si se ignoran los envíos o vehículos relacionados.

bool

Si es verdadero, haz lo siguiente:

• Usa ShipmentRoute.vehicle_label en lugar de vehicle_index para hacer coincidir las rutas en una solución insertada con los vehículos de la solicitud; reutiliza la asignación del ShipmentRoute.vehicle_index original al nuevo ShipmentRoute.vehicle_index para actualizar ConstraintRelaxation.vehicle_indices si no está vacío, 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 la 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, tal vez 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 y 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, se quita la ruta correspondiente de la solución junto con sus visitas. Si un shipment_label en la solución inyectada 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 insertada 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 afectar las restricciones implícitas, lo que puede generar cambios en la solución, errores de validación o inviabilidad.

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

bool

Considera la estimación del tráfico para calcular los campos ShipmentRoute Transition.travel_duration, Visit.start_time y vehicle_end_time, para establecer el campo ShipmentRoute.has_traffic_infeasibilities y para calcular el campo OptimizeToursResponse.total_cost.

bool

Si es verdadero, se completarán las polilíneas en las respuestas de ShipmentRoute.

bool

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

bool

Si se configura este parámetro, la solicitud puede tener un plazo (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 significativamente mayor (aunque sigue siendo 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 y una velocidad definida por geodesic_meters_per_second.

string

Es la etiqueta que se puede usar para identificar esta solicitud y que se devuelve en OptimizeToursResponse.request_label.

double

Cuando use_geodesic_distances es verdadero, este campo debe configurarse y define la velocidad que se aplica para calcular los tiempos de viaje. Su valor debe ser de al menos 1.0 metros/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 el límite es 10,000.

ShipmentRoute

Son las rutas calculadas para cada vehículo. La ruta i-ésima corresponde al i-ésimo vehículo del modelo.

string

Copia del OptimizeToursRequest.label, si se especificó una etiqueta en la solicitud.

SkippedShipment

Es la lista de todos los envíos que se omitieron.

OptimizeToursValidationError

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

OptimizeToursRequest

En algunos casos, modificamos la solicitud entrante antes de resolverla, es decir, agregamos costos. Si solving_mode == TRANSFORM_AND_RETURN_REQUEST, aquí se devuelve la solicitud modificada.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request para obtener más detalles.

Metrics

Son las métricas de duración, distancia y uso de esta solución.

AggregatedMetrics

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

int32

Es la cantidad de envíos obligatorios que se omitieron.

int32

Cantidad de vehículos utilizados. Nota: Si una ruta de 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 temprana para un vehículo usado, calculada como el mínimo de ShipmentRoute.vehicle_start_time para todos los vehículos usados.

Timestamp

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

map<string, double>

Costo de la solución, desglosado por los campos de solicitud relacionados con el costo. Las claves son rutas de acceso a .proto, relativas a la OptimizeToursRequest de entrada, 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 aquí en detalle, con la excepción de los costos relacionados con TransitionAttributes, que solo se registran de forma agregada a partir del 2022/01.

double

Costo total de la solución Es la suma de todos los valores en el mapa de costos.

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.

Uri

Obligatorio. URI del objeto de Cloud Storage que contiene el OptimizeToursRequest.

Uri

Obligatorio. URI del objeto de Cloud Storage que contendrá el OptimizeToursResponse.

Uri

Opcional. Es el URI del objeto de Cloud Storage que contiene el OptimizeToursResponse codificado como JSON o textproto. Si el objeto se codificó como JSON, la extensión del nombre del objeto será .json. Si el objeto se codificó como textproto, la extensión del nombre del objeto será .txtpb.

El crc32_checksum del recurso se puede usar para verificar que no se haya modificado el contenido del recurso.

int32

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

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 generar varios de ellos. Al igual que un compilador, este es un proceso imperfecto. Algunos errores de validación serán "fatales", lo que significa que detendrán 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, con el tiempo, pueden aparecer códigos y nombres visibles nuevos, 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 "VARIOS ERRORES".

string

Es el nombre visible del error.

FieldReference

Un contexto de error puede involucrar 0, 1 (la mayoría de las veces) o más campos. Por ejemplo, puedes referirte a la primera recolección del vehículo núm. 4 y el envío núm. 2 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 1:1 entre code y error_message (cuando el código no es "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 del modelo.

string

Nombre del campo, p.ej., "vehicles".

FieldReference

Es un subcampo anidado de forma recursiva, si es necesario.

int32

Índice del campo si se repite.

string

Es la clave si el campo es un mapa.

DataFormat

Obligatorio. Es el formato de datos de salida.

GcsDestination

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 incluyan 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 transbordador. Solo se aplica a los modos de viaje motorizados.

bool

Opcional. Especifica si se debe evitar la navegación 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 el 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 las paradas.

map<string, Load>

Demandas de carga del envío (por ejemplo, peso, volumen, cantidad de palets, etcétera) Las claves del mapa deben ser identificadores que describan el tipo de carga correspondiente y, de ser posible, también deben incluir las unidades. Por ejemplo: "weight_kg", "volume_gallons", "pallet_count", etcétera. 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 realizarla. Los vehículos se indican por su índice en la lista vehicles de ShipmentModel.

double

Especifica el costo en el que se incurre cuando cada vehículo entrega este envío. Si se especifica, debe tener ALGUNA de las siguientes opciones:

• 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 vehículos hay en el modelo. El i-ésimo elemento 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

Son los í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. Un índice de vehículos no se puede especificar más de una vez. Si un vehículo se excluye de costs_per_vehicle_indices, su costo es cero.

Duration

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

Por ejemplo, sea t el tiempo más corto que se tarda en ir desde la alternativa de retiro seleccionada directamente a la alternativa de entrega seleccionada. Luego, el parámetro de configuración 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 límites relativos y absolutos en el mismo envío, se usará el límite más restrictivo para cada par posible de retiro o entrega. Desde el 10/2017, los desvíos solo se admiten cuando las duraciones de los viajes no dependen de los vehículos.

Duration

Especifica la duración máxima desde el inicio de la recolección hasta el inicio de la entrega de un envío. Si se especifica, debe ser no negativo, y el envío debe contener al menos un retiro 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áximas: 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 recolecciones o entregas 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 campo shipment_label del objeto ShipmentRoute.Visit correspondiente.

bool

Si es verdadero, se omite este envío, pero no se aplica 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 realizació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 partida hasta el destino. Si se especifica, debe ser no negativo, y el envío debe contener al menos un retiro y una entrega.

Por ejemplo, sea t el tiempo más corto que se tarda en ir desde la alternativa de retiro seleccionada directamente a la alternativa de entrega seleccionada. Luego, el parámetro de configuración 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 límites relativos y absolutos en el mismo envío, se usará el límite más restrictivo para cada par posible de retiro o entrega. Desde el 10/2017, los desvíos solo se admiten cuando las duraciones de los viajes no dependen de los vehículos.

int64

Es la cantidad en la 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 acción de VisitRequest. Si el modelo de envío tiene matrices de distancia de duración, no se debe especificar arrival_location.

Waypoint

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

LatLng

Es la ubicación geográfica desde la que el vehículo sale 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 la parada en la que el vehículo sale 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 restringen la hora de llegada a una visita. Ten en cuenta que un vehículo puede salir fuera del período de 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 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.

Los períodos no deben superponerse ni ser adyacentes, y deben estar en orden ascendente.

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

Duration

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

double

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

map<string, Load>

Son las demandas de carga de esta solicitud de visita. Es igual que el campo Shipment.load_demands, pero 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 que necesita un vehículo para completar 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.

bool

Especifica si se deben evitar los giros en U en las rutas de conducción en esta ubicación. La función para evitar giros en U es el mejor esfuerzo y no se garantiza que se eviten por completo. Esta es una función experimental y su comportamiento está sujeto a cambios.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request para obtener más detalles.

Shipment

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

Vehicle

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

Objective

Es el conjunto de objetivos de este modelo que transformaremos en costos. Si no está vacío, el modelo de entrada no debe tener costo. Para obtener la solicitud modificada, usa solving_mode = TRANSFORM_AND_RETURN_REQUEST. Ten en cuenta que, en este caso, no se resolverá la solicitud. Consulta la documentación correspondiente.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request para obtener más detalles.

Timestamp

Hora de inicio y finalización global del modelo: No se puede considerar válida ninguna hora 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 a menos de 31536000 segundos de diferencia.

Cuando uses campos de cost_per_*hour, es posible que desees establecer 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 la hora predeterminada 00:00:00 UTC del 1 de enero de 1970 (es decir, segundos: 0, nanosegundos: 0).

Timestamp

Si no se establece, se usa la hora predeterminada 00:00:00 UTC del 1 de enero de 1971 (es decir, segundos: 31536000, nanosegundos: 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 tardía de todos los vehículos. Los usuarios pueden asignar un costo por hora a esa cantidad para intentar optimizar la finalización del trabajo 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 las distancias geodésicas o de Google Maps, 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 comienza su ruta en la ubicación A y la finaliza en la ubicación A
• 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 comienza su ruta en locA y la finaliza en locB, con la matriz "fast".
• 1 vehículo que comienza su ruta en locB y la finaliza en locB, con la matriz "lenta".
• 1 vehículo que comienza su ruta en locB y la finaliza en locB, con la matriz "fast".
• 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

Son 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 desde las visitas con la etiqueta duration_distance_matrix_src_tags(j) hasta 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 no debe estar vacío.

string

Son etiquetas que definen los destinos de las matrices de duración y distancia; duration_distance_matrices(i).rows(j).durations(k) (respectivamente, duration_distance_matrices(i).rows(j).meters(k)) define la duración (o la distancia) del viaje desde las visitas con la etiqueta duration_distance_matrix_src_tags(j) hasta 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 no debe estar vacío.

TransitionAttributes

Se agregaron atributos de transición al modelo.

ShipmentTypeIncompatibility

Conjuntos de shipment_types incompatibles (consulta ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Conjuntos de requisitos de shipment_type (consulta ShipmentTypeRequirement).

PrecedenceRule

Conjunto de reglas de precedencia que se deben aplicar en el modelo.

IMPORTANTE: El uso de reglas de precedencia limita el tamaño del problema que se puede optimizar. Es posible que se rechacen las solicitudes que usan reglas de precedencia que incluyen muchos envíos.

int32

Restringe 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 que 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 la misma cantidad de elementos que 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ío, 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

Son los valores de duración para una fila determinada. Debe tener la misma cantidad de elementos que ShipmentModel.duration_distance_matrix_dst_tags.

double

Son los valores de distancia para una fila determinada. Si no hay costos ni restricciones que hagan referencia a las distancias en el modelo, este campo se puede dejar vacío. De lo contrario, debe tener tantos elementos como durations.

Type

Es el tipo de objetivo.

double

Es el valor que se le debe asignar a este objetivo en relación con los demás. Puede ser cualquier número no negativo, y los pesos no tienen que sumar 1. Los pesos tienen un valor predeterminado de 1.0.

bool

Indica si el evento "first" es una entrega.

bool

Indica si el evento "segundo" es una entrega.

Duration

Es el desplazamiento entre el evento "primero" y el "segundo". Puede ser negativo.

int32

Índice de envío del evento "primero". Se debe especificar este campo.

int32

Índice de envío del evento "second". Se debe especificar este campo.

int32

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

Fecha y hora en que el vehículo finaliza su ruta.

Visit

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

Transition

Lista ordenada de transiciones para la ruta.

bool

Cuando OptimizeToursRequest.consider_road_traffic se establece como verdadero, este campo indica que las incoherencias en los horarios de las rutas se predicen con estimaciones de duración del viaje basadas en el tráfico. Es posible que no haya tiempo suficiente para completar el viaje ajustado al tráfico, las demoras y los descansos entre visitas, antes de la primera visita o después de la última, y, aun así, cumplir con los períodos de visita y del vehículo. 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 su intervalo actual debido al aumento de la estimación del tiempo de viaje travel_duration(previous_visit, next_visit) a causa del tráfico. Además, es posible que se fuerce una pausa para que se superponga con una visita debido a un aumento en las estimaciones del tiempo de viaje y a las restricciones de la ventana de tiempo de la visita o la pausa.

EncodedPolyline

Es la representación de la ruta en forma de polilínea codificada. Este campo solo se propaga si OptimizeToursRequest.populate_polylines se establece como verdadero.

Break

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

AggregatedMetrics

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

VehicleFullness

Campo VehicleFullness para calcular qué tan cerca están las métricas con límite de sus respectivos límites del vehículo. Sus campos son proporciones entre un campo de métricas con límite (p.ej., AggregatedMetrics.travel_distance_meters) y el límite del vehículo relacionado (p.ej., Vehicle.route_distance_limit).

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

map<string, double>

Costo de la ruta, desglosado por los campos de la solicitud relacionados con el costo. Las claves son rutas de acceso a .proto, relativas al OptimizeToursRequest de entrada, 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 a lo largo de la ruta. Todos los costos definidos en el modelo se registran aquí en detalle, con la excepción de los costos relacionados con TransitionAttributes, que solo se registran de forma agregada a partir del 2022/01.

double

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

Timestamp

Es la hora de inicio de un descanso.

Duration

Es la duración de un descanso.

string

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

Duration

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 del tráfico para un Transition, este valor booleano se establece como verdadero. Esto puede ser temporal (un problema 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 la demora aplicadas a esta transición. Si hay alguna, la demora comienza exactamente delay_duration segundos antes del próximo evento (visita o finalización del vehículo). Consulta los TransitionAttributes.delay.

Duration

Suma de la duración de los descansos que se producen durante esta transición, si corresponde. Los detalles sobre la hora de inicio y la duración de cada interrupción se almacenan en ShipmentRoute.breaks.

Duration

Tiempo de espera durante esta transición. La duración de espera corresponde al tiempo de inactividad y no incluye el tiempo de descanso. También ten en cuenta que este tiempo de espera se puede dividir 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 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 se establece 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 cambio de ruta, respetar la intención original cuando se creó la ruta. Trata este token como un BLOB opaco. No compares su valor entre solicitudes, ya que puede cambiar incluso si el servicio devuelve la misma ruta. Este campo solo se propaga si populate_transition_polylines se establece como verdadero.

map<string, VehicleLoad>

Cargas de vehículos durante esta transición, para cada tipo que aparece en el Vehicle.load_limits de este vehículo o que tiene 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, los load_demands de la visita se suman o restan 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 en el vehículo para el tipo determinado. La unidad de carga suele indicarse con el tipo. Consulta los Transition.vehicle_loads.

int32

Índice del campo shipments en el ShipmentModel de origen.

bool

Si es verdadero, la visita corresponde a un retiro de un Shipment. De lo contrario, corresponde a una entrega.

int32

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

Timestamp

Fecha y hora en que comienza la visita. Ten en cuenta que es posible que el vehículo llegue antes a la ubicación de la visita. Los períodos coinciden 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 demandas 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

Copia del Shipment.label correspondiente, si se especifica en el Shipment.

string

Copia del VisitRequest.label correspondiente, si se especifica en el VisitRequest.

int32

Es un token opaco que representa información sobre la ubicación de una visita.

Este campo se puede propagar en las visitas de las rutas de resultados cuando VisitRequest.avoid_u_turns se estableció como verdadero para esta visita o si ShipmentModel.avoid_u_turns se estableció como verdadero en la solicitud OptimizeToursRequest.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request para obtener más detalles.

string

Es la lista de tipos incompatibles. Dos envíos que tienen diferentes shipment_types 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 el 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 en las 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

Copia del Shipment.label correspondiente, si se especifica en el Shipment.

Reason

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

double

Esta es una copia del Shipment.penalty_cost, que se incluye aquí para que sea más fácil ver la gravedad de un envío omitido.

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

double

Es la proporción estimada de vehículos que no pueden realizar este envío por al menos uno de los siguientes motivos. Nota: Este campo solo se completa cuando los motivos involucran un vehículo.

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

Code

Consulta los comentarios del código.

int32

Es igual que example_vehicle_index, excepto que proporcionamos la lista de varios vehículos identificados. Esta lista no es necesariamente exhaustiva. Solo se completa si [fill_example_vehicle_indices_in_skipped_reasons][] es verdadero.

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

string

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

int32

Si el motivo está relacionado con una incompatibilidad entre el vehículo y el envío, este campo proporciona el índice de un vehículo pertinente.

Timestamp

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

Timestamp

Es 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. Se calcula 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 agrega a otros costos del modelo si el evento ocurre después de soft_end_time, y 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 configurar si se estableció soft_end_time.

string

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

Una visita de origen o un inicio de vehículo coinciden si su VisitRequest.tags o Vehicle.start_tags contienen src_tag o no contienen 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 estar no vacío.

string

Una visita al destino o un final de viaje del vehículo coinciden si su VisitRequest.tags o Vehicle.end_tags contienen dst_tag o no contienen 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 estar no vacío.

double

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

double

Especifica un costo por kilómetro que se aplica 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 en la distancia recorrida durante esta transición.

Desde el 2021/06, solo se admiten límites flexibles.

Duration

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

Este retraso siempre se produce después de finalizar la visita de origen y antes de comenzar la visita de destino.

string

Es el URI del recurso. Es posible que el recurso aún no exista.

El contenido del recurso se codifica como JSON o textproto. Solo se admiten los recursos de Google Cloud Storage. Si el recurso está codificado como JSON, el nombre del recurso debe tener el sufijo .json. Si el recurso está codificado como textproto, el nombre del recurso debe tener el sufijo .txtpb. Por ejemplo, un URI de Google Cloud Storage para un archivo codificado en JSON podría verse de la siguiente manera: gs://bucket/path/input/object.json.

string

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

TravelMode

Es 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

Ubicación geográfica en la que se encuentra el vehículo antes de recoger cualquier envío. Si no se especifica, el vehículo comienza en su primera parada. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar start_location.

Waypoint

Es un punto de referencia que representa una ubicación geográfica en la que el vehículo se detiene antes de recoger cualquier envío. Si no se especifican start_waypoint ni start_location, el vehículo comienza en su primera parada. Si el modelo de envío tiene matrices de duración y distancia, no se debe especificar start_waypoint.

LatLng

Ubicación geográfica en la que se detiene el vehículo después de completar su último VisitRequest. Si no se especifica, el ShipmentRoute del vehículo finaliza inmediatamente 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

Es un punto de ruta que representa una ubicación geográfica en la que el vehículo se detiene después de completar su último VisitRequest. Si no se especifican end_waypoint ni end_location, el ShipmentRoute del vehículo finaliza inmediatamente 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

Períodos durante los cuales el vehículo puede salir de su ubicación de inicio. 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 los 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 ser adyacente a él, y deben estar en orden cronológico.

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

TimeWindow

Son los períodos durante los cuales el vehículo puede llegar a su ubicación final. 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 los 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 ser adyacente a él, y deben estar en orden cronológico.

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

UnloadingPolicy

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

map<string, LoadLimit>

Capacidades del vehículo (peso, volumen, cantidad de palets, por ejemplo) Las claves del mapa son los identificadores del tipo de carga, coherentes con las claves del campo Shipment.load_demands. Si una clave determinada no está presente en este mapa, se considera que la capacidad correspondiente es ilimitada.

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 comprende el tiempo de viaje, el tiempo de espera y el tiempo de visita. Usar cost_per_hour en lugar de solo cost_per_traveled_hour puede generar latencia adicional.

double

Es el costo por hora de viaje de la ruta del vehículo. Este costo solo se aplica al tiempo de viaje que toma 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 se aplica a ninguna distancia recorrida de forma implícita desde arrival_location hasta departure_location de un solo VisitRequest.

double

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

bool

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

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

De lo contrario, no se desplaza desde su ubicación de inicio hasta su ubicación final, y no se programa ningún break_rule ni demora (desde TransitionAttributes) para este vehículo. En este caso, el objeto ShipmentRoute del vehículo no contiene ninguna información, excepto el índice y la etiqueta del vehículo.

DurationLimit

Es el límite aplicado 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 aplicado a la duración del viaje de la ruta del vehículo. En un OptimizeToursResponse determinado, la duración del viaje por la ruta es la suma de todos sus transitions.travel_duration.

DistanceLimit

Es el límite aplicado 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 adicional de la visita agrega costos 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 tipo en el mapa.

BreakRule

Describe el programa de descanso 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 permanecerá sin usarse.

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

Si un envío se realiza con un vehículo ignorado en injected_solution_constraint y cualquier retiro o entrega relacionado se limita a permanecer en el vehículo (es decir, no se relaja 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 que son el doble de los de los vehículos estándar. Este múltiplo no afecta las duraciones de las visitas. 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 generar 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

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

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

Duration

Es un límite flexible que no aplica un límite de duración máximo, pero, cuando se incumple, la ruta incurre 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 no debe ser negativo. 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 umbral de soft_max_duration. El costo adicional es 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 en el que se incurre si se incumple el umbral de quadratic_soft_max_duration.

El costo adicional es 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 alguna vez supera soft_max_load a lo largo de la ruta de este vehículo, se aplica la siguiente penalización de costo (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. Los límites flexibles solo se pueden definir en los tipos que se aplican solo a las recolecciones o solo a las entregas en todo el modelo.

Interval

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

Interval

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

int64

Es la cantidad máxima aceptable de carga.

LoadCost

Costo de transportar una unidad de carga durante un kilómetro para este vehículo. Esto se puede usar como proxy para el consumo de combustible: si la carga es un peso (en Newtons), entonces carga*kilómetro tiene la dimensión de una energía.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request para obtener más detalles.

LoadCost

Costo de viajar con una unidad de carga durante una hora para este vehículo.

Experimental: Consulta https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request para obtener más detalles.

int64

Una carga mínima aceptable Debe ser ≥ 0. Si se especifican ambos, min debe ser menor o igual que 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 menor o igual que max.

int64

Es la cantidad de carga por encima de la cual el costo de mover una unidad de carga cambia de cost_per_unit_below_threshold a cost_per_unit_above_threshold. Debe ser >= 0.

double

Costo de mover una unidad de carga, para cada unidad entre 0 y el umbral. Debe ser un valor finito y mayor o igual que 0.

double

Es el costo de mover una unidad de carga por cada unidad que supere el umbral. En el caso especial de que el umbral sea igual a 0, se trata de un costo fijo por unidad. Debe ser un valor finito y mayor o igual que 0.

double

Es el valor máximo de todos los demás campos de este mensaje.

double

Es la proporción entre AggregatedMetrics.travel_distance_meters y Vehicle.route_distance_limit. Si Vehicle.route_distance_limit no está configurado, este campo tampoco lo estará.

double

Es la proporción entre [AggregatedMetrics.travel_duration_seconds][] y Vehicle.travel_duration_limit. Si Vehicle.travel_duration_limit no está configurado, este campo tampoco lo estará.

double

Es la proporción entre [AggregatedMetrics.total_duration_seconds][] y Vehicle.route_duration_limit. Si Vehicle.route_duration_limit no está configurado, este campo tampoco lo estará.

double

Es la proporción máxima entre todos los tipos de [AggregatedMetrics.max_load][] y sus respectivos Vehicle.load_limits. Si no se configuran todos los campos Vehicle.load_limits, este campo no se configurará.

double

Es la proporción (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) para un vehículo determinado. Si el denominador no está presente, se usa (ShipmentModel.global_end_time - ShipmentModel.global_start_time) en su lugar.

bool

Opcional. Indica que la ubicación de este punto de referencia está destinada a que el vehículo se detenga en un lado específico de la ruta. Cuando configuras este valor, la ruta pasará por la ubicación para que el vehículo pueda detenerse al costado de la ruta hacia el que se inclina la ubicación desde el centro de la ruta. Esta opción no funciona para el modo de viaje "A PIE".

bool

Indica que el punto de referencia está destinado a que los vehículos se detengan, con la intención de recoger o dejar pasajeros. Esta opción solo funciona para el modo de viaje "DRIVING" y cuando "location_type" es "location".

Experimental: El comportamiento o la existencia de este campo pueden cambiar en el futuro.

Location

Es un punto especificado con coordenadas geográficas, que incluye un rumbo opcional.

string

Es el ID de lugar del PDI asociado con el punto de ruta.

Cuando uses un ID de lugar para especificar la ubicación de llegada o salida de un VisitRequest, usa un ID de lugar que sea lo suficientemente específico como para determinar una ubicación de LatLng para la navegación al lugar. Por ejemplo, un ID de lugar que representa un edificio es adecuado, pero no se recomienda un ID de lugar que representa una ruta.