Modelo de costo

El objetivo principal de la API de Route Optimization es encontrar rutas con el costo más bajo. Por lo tanto, el modelo de costos es el impulsor principal de la optimización de rutas.

El modelo de costos es un conjunto de propiedades que especifican los costos globales, de los vehículos y de los envíos.

Las propiedades del modelo de costos admiten los siguientes tipos de objetivos de optimización:

• Asignaciones y rutas de vehículos eficientes
• Tiempos de retiro y entrega rentables
• Priorización de envíos críticos

Estructura

Como se muestra en el diagrama, las propiedades del modelo de costos se estructuran de la siguiente manera:

• Shipment contiene la propiedad penaltyCost.
• Vehicle contiene las siguientes propiedades:
  • fixedCost
  • costPerHour
  • costPerKilometer
  • costPerTraveledHour

En este documento, solo se destacan los parámetros esenciales del modelo de costos. Consulta la documentación de referencia para obtener el conjunto completo de parámetros de costo.

Lista de tareas de Essentials

En la siguiente lista de tareas, se describe el conocimiento esencial que evita posibles errores relacionados con los costos. Esta lista puede ayudarte a validar tu solicitud y solucionar problemas relacionados con la respuesta.

Los costos son necesarios para la optimización. Una solicitud sin costos hará que la API devuelva rutas sin sentido con un tiempo de viaje largo.

Debes especificar al menos uno de costPerHour, costPerKilometer o costPerTraveledHour por vehículo.

Puedes usar varias propiedades de costo por solicitud para lograr objetivos de optimización más sofisticados.

Las propiedades de costo no están vinculadas a una moneda en particular.

Tú decides el valor que representa una unidad de costo, y este valor se aplica a todas las propiedades de costo de la solicitud.

Propiedades

En la siguiente tabla, se enumeran y describen las propiedades del modelo de costos.

Madre o padre	Nombre de la propiedad	Tipo de propiedad	Costo por	Descripción de la propiedad
Shipment	penaltyCost	número	Se omitió el envío	Es el costo que se genera por omitir el envío. La API omite un envío cuando el costo para completarlo supera su costo de penalización. La configuración de penaltyCost prioriza la entrega de envíos con un costo más alto. Si no configuras un envío penaltyCost, este se vuelve obligatorio. Si estableces de forma explícita un envío penaltyCost en cero, la API siempre omitirá el envío, a menos que otras restricciones lo requieran.
Vehicle	fixedCost	número	Envío	Es el costo fijo que se aplica si se usa este vehículo para manejar un envío.
	costPerHour	número	Hora	Es el costo de operar un vehículo por hora, incluidos los tiempos de tránsito, espera, visita y descanso. A medida que aumenta este costo, el optimizador intenta encontrar rutas más rápidas que pueden no ser las más cortas. Esta propiedad puede ser un costo independiente y eficaz por vehículo debido a su simplicidad y exhaustividad.
	costPerKilometer	número	Kilómetros	Es el costo por kilómetro recorrido del vehículo, como los costos de combustible y los costos de mantenimiento amortizados del vehículo.
	costPerTraveledHour	número	Hora	Es el costo de operar un vehículo por hora solo durante el viaje, sin incluir los tiempos de espera, visita y descanso. Esto prioriza las rutas de viaje más rápidas en lugar de las más cortas.

Ejemplos

En esta sección, se incluyen tres tipos de ejemplos:

• Muestras de código que ilustran la estructura de las propiedades del modelo de costos
• Situación de ejemplo que muestra una forma de usar las propiedades del modelo de costos para lograr un objetivo comercial.
• Un ejemplo de solicitud que incluye los valores establecidos en la situación de ejemplo.

Muestras de código

En la siguiente muestra de código, se muestra la estructura de las propiedades del modelo de costos en Shipment:

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

En la siguiente muestra de código, se muestra la estructura de las propiedades del modelo de costos en Vehicle:

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

Situación de ejemplo

En esta sección, se describe una situación en la que tienes un negocio de guardería para perros. Optimizas una ruta para el camión que usas para recoger a los perros de sus casas. En esta situación, deseas que el optimizador tenga en cuenta los costos relacionados con el retiro de los perros y las operaciones del vehículo cuando proporciona una ruta.

En este ejemplo, una unidad de costo representa 1 dólar. Esto significa que los valores de la propiedad del modelo de costos en tu solicitud son los siguientes:

Propiedad	Valor	Situación
penaltyCost	10	Representa la penalización que ofreces a tus clientes por no recoger a su perro en un día programado. Cada vez que no recojas al perro en un día programado, el cliente recibirá un descuento de USD 40 en el total del servicio.
fixedCost	30	Representa el costo diario de los pagos de tu préstamo de vehículo, que es de 30 dólares por día.
costPerKilometer	0.08	Indica la cantidad de gasolina que consume tu vehículo por kilómetro. Tu vehículo necesita 0.04 galones por kilómetro para moverse, y el costo por galón en tu región es de 2 dólares.
costPerHour	27	Representa cuánto le pagas a un conductor por conducir tu vehículo. Le pagas al conductor 27 dólares por hora.
costPerTraveledHour	2.5	Indica cuánto debes pagar por el aire acondicionado del vehículo por hora para los perros mientras viajas. Cuando el vehículo no está en movimiento, el conductor puede abrir las puertas traseras y apagar el aire acondicionado.

En función de los parámetros de costos, el optimizador podría realizar compensaciones que no son obvias para el usuario, pero que se pueden encontrar a través de la optimización.

En el siguiente diagrama, se ilustra un ejemplo en el que el optimizador podría elegir una ruta más larga, pero más rápida, a través de la línea verde punteada para evitar el tráfico en la línea roja punteada.

En esta situación, el equilibrio de costos de las dos rutas es el siguiente:

• La línea verde punteada tiene un costPerHour y un costPerTraveledHour bajos, ya que es una ruta rápida que evita el tráfico, lo que es más rentable, incluso cuando el costPerKilometer es alto.

• La línea punteada roja tiene un costPerKilometer bajo, ya que es una ruta directa, pero costPerHour y costPerTraveledHour son demasiado altos debido a los tiempos de espera en el tráfico, lo que la convierte en la ruta más costosa.

Además de proporcionar rutas rentables, el optimizador también proporciona una suma de los costos totales de las rutas de entrega en las propiedades de respuesta.

Ejemplo de solicitud

En el siguiente ejemplo, se muestra la estructura de una solicitud básica de optimizeTours que incorpora los valores establecidos en la situación de ejemplo:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

Propiedades de la respuesta

El mensaje OptimizeToursResponse tiene propiedades de costo que describen los costos incurridos en el proceso de completar una ruta:

• metrics.costs: Es el costo total de todas las rutas desglosado por campos de solicitud relacionados con el costo.
• metrics.totalCost: Es el costo total de todas las rutas sumado.