Kostenmodell

Das Hauptziel der Route Optimization API ist es, Routen mit den niedrigsten Kosten zu finden. Daher ist das Kostenmodell der Hauptfaktor für die Routenoptimierung.

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

Die Attribute 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 Attribute des Kostenmodells so strukturiert:

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

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

Checkliste für Grundlagen

Die folgende Checkliste enthält grundlegende Informationen , mit denen Sie potenzielle kostenbezogene Fehler vermeiden können. Anhand dieser Liste können Sie Ihre Anfrage überprüfen und Fehler in Ihrer Antwort beheben.

Attribute

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

Beispiele

In diesem Abschnitt werden drei Arten von Beispielen behandelt:

• Codebeispiele , die die Struktur der Attribute des Kostenmodells veranschaulichen.
• Ein Beispielszenario , das zeigt, wie Sie die Attribute des Kosten modells verwenden können, um ein Geschäftsziel zu erreichen.
• Ein Beispiel für eine Anfrage , das die im Beispielszenario festgelegten Werte enthält.

Codebeispiele

Das folgende Codebeispiel zeigt die Struktur der Attribute des Kostenmodells in Shipment:

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

Das folgende Codebeispiel zeigt die Struktur der Attribute des Kostenmodells 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 Hundebetreuung betreiben. Sie optimieren eine Route für den Lkw, mit dem Sie die Hunde von ihren Häusern abholen. In diesem Szenario soll der Optimizer bei der Routenplanung Kosten im Zusammenhang mit der Abholung der Hunde und dem Fahrzeugbetrieb berücksichtigen.

In diesem Beispiel entspricht eine Kosteneinheit 1 US-Dollar. Das bedeutet, dass die Werte der Attribute des Kostenmodells in Ihrer Anfrage so aussehen:

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

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

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

• Die grüne gestrichelte Linie hat niedrige costPerHour und costPerTraveledHour, da es sich um eine schnelle Route handelt, die den Verkehr vermeidet. Sie ist kostengünstiger, auch wenn die costPerKilometer hoch sind.

• Die rote gepunktete Linie hat niedrige costPerKilometer, da es sich um eine direkte Route handelt. Die costPerHour und costPerTraveledHour sind jedoch aufgrund der Wartezeiten im Verkehr zu hoch, was sie zur teuersten Route macht.

Neben kostengünstigen Routen bietet der Optimizer in den Antwort attributen auch eine Summe der Gesamtkosten der Lieferrouten.

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

Attribute der Antwort

Die OptimizeToursResponse Nachricht enthält Kostenattribute die die Kosten beschreiben, die bei der Ausführung einer Route entstehen:

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