Anfragenachricht erstellen

Wie im Abschnitt Routenoptimierung – Übersicht kurz beschrieben, besteht eine grundlegende Anfrage aus den erforderlichen Entitäten Modell, Sendungen und Fahrzeuge:

• Model enthält Einstellungen und Einschränkungen für die gesamte Anfrage, einschließlich Shipments und Vehicles.
• Lieferungen stellen Aufgaben oder tatsächliche Sendungen dar, die Abhol- und Liefer-VisitRequests umfassen. Sendungen haben lokale Einstellungen und Einschränkungen.
• Fahrzeuge stehen für Fahrzeuge, Fahrer oder Mitarbeiter. Außerdem gibt es bei Fahrzeugen lokale Einstellungen und Beschränkungen.

Die Eigenschaften der einzelnen Entitäten beschreiben einen Teil eines Optimierungsproblems auf einer bestimmten Detailebene. Modellweite Einschränkungen werden auf alle Sendungen und Fahrzeuge angewendet, während Einschränkungen und Eigenschaften, die für Sendungen oder Fahrzeuge angegeben sind, für eine einzelne Sendung oder ein einzelnes Fahrzeug gelten.

Eine vollständige Dokumentation zu jedem Nachrichtentyp finden Sie in der Referenzdokumentation zu ShipmentModel (REST, gRPC), Shipment (REST, gRPC) und Vehicle (REST, gRPC).

OptimizeToursRequest Unterkünfte

Zu den häufig verwendeten Eigenschaften der OptimizeToursRequest-Nachricht der obersten Ebene (REST, gRPC) gehören:

• searchMode gibt an, ob die erste Lösung zurückgegeben werden soll, die die angegebenen Einschränkungen erfüllt, oder ob die bestmögliche Lösung innerhalb eines festgelegten Termins gefunden werden soll.
• Mit considerRoadTraffic wird festgelegt, ob Live-Verkehrsinformationen für die Routenberechnung und die geschätzte Ankunftszeit verwendet werden.
• Mit populateTransitionPolylines wird festgelegt, ob in der Antwort Routenpolylinien und Routentokens zurückgegeben werden.

Modellattribute

Zu den häufig verwendeten Eigenschaften der ShipmentModel-Nachricht (REST, gRPC) gehören:

• globalStartTime ist die früheste Startzeit der Routen für alle Fahrzeuge und Sendungen. Vor diesem Datum dürfen keine Fahrzeuge ihre ersten Übergänge und Sendungen starten.
• globalEndTime ist die späteste Endzeit der Routen aller Fahrzeuge und Sendungen. Alle zugewiesenen Sendungen und Umstellungen müssen vor diesem Zeitpunkt abgeschlossen sein.

Versandeigenschaften

Zu den häufig verwendeten Eigenschaften der Shipment-Nachricht (REST, gRPC) gehören:

• pickups[] und deliveries[] geben an, wo eine Sendung abgeholt oder abgegeben werden kann. Für pickups[]- und deliveries[]-Properties wird die VisitRequest-Nachricht verwendet (REST, gRPC).
• loadDemands gibt die Ladung an, die für ein Fahrzeug erforderlich ist, um eine Lieferung abzuschließen. Die entsprechende load_limits-Eigenschaft (REST, gRPC) von Fahrzeugen gibt an, wie viel Ladung ein Fahrzeug gleichzeitig aufnehmen kann. Weitere Informationen zur Auslastung finden Sie unter Anforderungen und Limits für die Auslastung.
• penalty_cost entspricht den Kosten, die bei einem übersprungenen Versand anfallen. Weitere Informationen zu den Kosten finden Sie unter Parameter des Kostenmodells.

Fahrzeugeigenschaften

Zu den häufig verwendeten Attributen der Vehicle-Nachricht (REST, gRPC) gehören:

• startLocation gibt an, wo ein Fahrzeug seine Route beginnen muss. Dieses Attribut ist optional. Wenn keine Angabe erfolgt, beginnt die Route des Fahrzeugs am Standort der ersten zugewiesenen Sendung.
• endLocation gibt an, wo ein Fahrzeug seine Route beenden muss. Dieses Attribut ist optional. Wenn nicht angegeben, endet die Route des Fahrzeugs am Standort der letzten zugewiesenen Sendung.
• startTimeWindows[] gibt an, wann ein Fahrzeug seine Route starten kann. Dieses Attribut ist optional.
• endTimeWindows[] gibt an, wann ein Fahrzeug seine Route starten und beenden kann. Beide Properties sind optional.
• loadLimits steht für die Kapazität des Fahrzeugs, die für die Ladungsanforderungen der Sendungen verfügbar ist. Weitere Informationen zu Lastanforderungen und ‑limits finden Sie unter Lastanforderungen und ‑limits.

Eine vollständige Beispielanfrage im JSON-Format sieht so aus:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.73881799999999,
              "longitude": -122.4161
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.79581,
              "longitude": -122.4218856
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.73881799999999,
          "longitude": -122.4161
        },
        "endLocation": {
          "latitude": 37.73881799999999,
          "longitude": -122.4161
        },
        "costPerKilometer": 1.0
      }
    ],
   "globalStartTime": "2024-02-13T00:00:00.000Z",
   "globalEndTime": "2024-02-14T06:00:00.000Z"
  }
}

OptimizeTours und BatchOptimizeTours verarbeiten Anfragenachrichten wie im Beispiel oben, aber auf unterschiedliche Weise. Bevor Sie eine Anfrage zur Routenoptimierung stellen, sollten Sie den Unterschied zwischen den beiden Methoden kennen:

OptimizeTours und BatchOptimizeTours vergleichen