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 factor determinante 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 eficientes de vehículos
• 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 costos.

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 tu 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 caso de ejemplo que muestra una forma de usar las propiedades del modelo de costos para alcanzar un objetivo comercial.
• Un ejemplo de solicitud que incluye los valores establecidos en la situación de ejemplo.

Muestras de código

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

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

En el siguiente ejemplo 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. Estás optimizando 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 la recogida de los perros y las operaciones del vehículo cuando proporcione una ruta.

En este ejemplo, una unidad de costo representa 1 dólar. Esto significa que los valores de las propiedades 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 punteada verde para evitar el tráfico en la línea punteada roja.

En este caso, el balance de costos de las dos rutas es el siguiente:

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

• La línea punteada roja tiene un valor de costPerKilometer bajo, ya que es una ruta directa, pero los valores de 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 en todas las rutas, desglosado por los campos de la solicitud relacionados con el costo.
• metrics.totalCost: Es el costo total de todas las rutas sumadas.