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 principal impulsor de la optimización de rutas.

El modelo de costos es un conjunto de propiedades que especifican los costos globales, de vehículos y de 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 ver el conjunto completo de parámetros de costo.

Lista de tareas de Essentials

En la siguiente lista de tareas, se describen los conocimientos esenciales que evitan posibles errores relacionados con los costos. Esta lista puede ayudarte a validar tu solicitud y solucionar problemas con la respuesta.

Propiedades

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

Ejemplos

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

• Muestras de código que ilustran la estructura de las propiedades del modelo de costos.
• Un ejemplo de situación 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 indica 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 indica 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. Estás optimizando una ruta para el camión que usas para recoger a los perros de sus casas. En esta situación, quieres que el optimizador tenga en cuenta los costos relacionados con la recogida de los perros y las operaciones de los vehículos cuando proporcione 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:

Según 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 discontinua verde para evitar el tráfico en la línea punteada roja.

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

• La línea discontinua verde 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 el costPerHour y el 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 optimizeTours básica 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 en los que se incurre 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 sumadas.