Kostenmodell

Das Hauptziel der Route Optimization API ist es, Routen mit den niedrigsten Kosten zu finden. Das Kostenmodell ist daher der wichtigste Faktor für die Routenoptimierung.

Das Kostenmodell ist eine Reihe von Eigenschaften, die globale, Fahrzeug- und Versandkosten angeben.

Die Eigenschaften des Kostenmodells unterstützen die folgenden Arten von Optimierungszielen:

• Effiziente Fahrzeugzuweisungen und Routen
• Kostengünstige Abhol- und Lieferzeiten
• Priorisierung kritischer Sendungen

Struktur

Wie im Diagramm dargestellt, sind die Eigenschaften des Kostenmodells so strukturiert:

• Shipment enthält das Attribut penaltyCost.
• Vehicle enthält die folgenden Eigenschaften:
  • fixedCost
  • costPerHour
  • costPerKilometer
  • costPerTraveledHour

In diesem Dokument werden nur die wichtigsten Parameter des Kostenmodells beschrieben. Eine vollständige Liste der Kostenparameter finden Sie in der Referenzdokumentation.

Checkliste für Essentials

In der folgenden Checkliste wird das erforderliche Wissen beschrieben, mit dem potenzielle kostenbezogene Fehler vermieden werden können. Anhand dieser Liste können Sie Ihre Anfrage validieren und Fehler in Ihrer Antwort beheben.

Attribute

In der folgenden Tabelle werden die Attribute des Kostenmodells aufgeführt und beschrieben.

Beispiele

In diesem Abschnitt werden drei Arten von Beispielen behandelt:

• Codebeispiele, die die Struktur von Kostenmodelleigenschaften veranschaulichen.
• Beispielszenario, in dem eine Möglichkeit zur Verwendung von Kostenmodellattributen zur Erreichung eines Geschäftsziels gezeigt wird.
• Ein Beispiel für eine Anfrage, die die im Beispielszenario festgelegten Werte enthält.

Codebeispiele

Das folgende Codebeispiel zeigt die Struktur der Kostenmodelleigenschaften in Shipment:

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

Das folgende Codebeispiel zeigt die Struktur der Kostenmodelleigenschaften in Vehicle:

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

Beispielszenario

In diesem Abschnitt wird ein Szenario beschrieben, in dem Sie ein Unternehmen für die Betreuung von Hunden haben. Sie optimieren eine Route für den Lkw, mit dem Sie die Hunde von ihren Zuhause abholen. In diesem Szenario soll der Optimierer bei der Routenplanung die Kosten für das Abholen der Hunde und den Fahrzeugbetrieb berücksichtigen.

In diesem Beispiel entspricht eine Kosteneinheit 1 $. Das bedeutet, dass die Werte der costModel-Eigenschaft in Ihrer Anfrage die folgenden sind:

Anhand von Kostenparametern kann der Optimizer Kompromisse eingehen, die für den Nutzer nicht offensichtlich sind, aber durch die Optimierung gefunden werden können.

Das folgende Diagramm zeigt ein Beispiel, in dem der Optimizer eine längere, aber schnellere Route über die grüne gestrichelte Linie wählen könnte, um den Verkehr auf der roten gepunkteten Linie zu vermeiden.

In diesem Szenario sieht die Kostenbilanz der beiden Routen so aus:

• Die grüne gestrichelte Linie hat einen niedrigen costPerHour und costPerTraveledHour, da es sich um eine schnelle Route handelt, auf der es keinen Verkehr gibt. Das ist kostengünstiger, auch wenn der costPerKilometer hoch ist.

• Die rote gepunktete Linie hat einen niedrigen costPerKilometer, da es sich um eine direkte Route handelt. Die costPerHour und costPerTraveledHour sind jedoch aufgrund der Wartezeiten im Verkehr zu hoch, sodass es sich um die teuerste Route handelt.

Der Optimizer bietet nicht nur kostengünstige Routen, sondern auch eine Zusammenfassung der Gesamtkosten der Lieferrouten in den Antworteigenschaften.

Beispielanfrage

Das folgende Beispiel zeigt die Struktur einer einfachen optimizeTours-Anfrage mit den im Beispielszenario festgelegten Werten:

{
  "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
      }
    ]
  }
}

Antwortattribute

Die Nachricht OptimizeToursResponse enthält Kosteneigenschaften, die die Kosten beschreiben, die bei der Durchführung einer Route anfallen:

• metrics.costs: Die Gesamtkosten für alle Routen, aufgeschlüsselt nach kostenbezogenen Anfragefeldern.
• metrics.totalCost: Die Gesamtkosten für alle Routen.