Routenplanung für große Fahrzeuge

Die Routenplanung für große Fahrzeuge umfasst eine Reihe von Attributen, mit denen Sie Flottenrouten für große Fahrzeuge optimieren können. Dazu geben Sie die physischen Abmessungen, das Gewicht und die Anzahl der Anhänger an. Die API verwendet diese Attribute, um geeignete Routen zu berechnen, auf denen Straßen mit Einschränkungen, niedrige Brücken oder Routen mit Gewichtsbeschränkungen vermieden werden.

Mit der Routenplanung für große Fahrzeuge können Sie logistische Herausforderungen für schwere und große Fahrzeuge lösen, z. B.:

  • Straßenrisiken vermeiden:Routenpläne erstellen, die Fahrzeuge von niedrigen Durchfahrten, Straßen mit Gewichtsbeschränkungen und anderen physischen Gefahren fernhalten.
  • Detaillierte Fahrzeuginformationen angeben:Genaue Abmessungen, Gesamtgewicht, Anzahl der Achsen und Anhängerkonfigurationen in Routenpläne für die gesamte Flotte einbeziehen.
  • Flottenweite Planung verbessern:Effiziente Routenpläne für Ihre gesamte Lkw-Flotte erstellen und dabei sicherstellen, dass alle Zuweisungen den physischen Straßenbeschränkungen entsprechen.

Beschränkungen

Bevor Sie beginnen, müssen Sie die folgenden Einschränkungen und Anforderungen beachten.

  • Geografische Verfügbarkeit: Die Routenplanung für große Fahrzeuge ist nur in den zusammenhängenden 48 Bundesstaaten der USA verfügbar.
  • Fahrerhinweise und Sicherheit: Fahrer dürfen sich nicht ausschließlich auf Routen verlassen, die von dieser API zurückgegeben werden, um sicher oder legal zu sein. Es wird nicht garantiert, dass die Routen für das Fahrzeug geeignet sind. Wenn Fahrer ihnen folgen, können sie Gefahren ausgesetzt sein, z. B. niedrigen Brücken oder Straßen, auf denen große Fahrzeuge verboten sind.
  • Best-Effort-Routen: In einigen Fällen kann die API keine Route finden, die alle Reisebeschränkungen vollständig erfüllt. Stattdessen wird eine „Best-Effort“-Route zurückgegeben, die möglicherweise durch eingeschränkte Bereiche führt.
  • Nicht unterstützte Funktionen: Die Routenplanung für große Fahrzeuge unterstützt Folgendes nicht:
    • Lkw-Mautpreise
    • Höchstgeschwindigkeit
    • Routenplanung für radioaktive Gefahrstoffe
  • Abrechnung: Google stellt alle optimizeTours-Anfragen einheitlich in Rechnung, unabhängig davon, ob die Anfragen Attribute für die Routenplanung für große Fahrzeuge konfigurieren.
  • Langstreckenrouten:Lkw-Routen über 500 km oder mehr erfordern mehr Rechenzeit als kürzere Routen und liefern möglicherweise Routendaten von geringerer Qualität. Um die Routenqualität aufrechtzuerhalten, sollten Sie die Entfernungen zwischen Sendungen, Start- und Zielorten von Fahrzeugen begrenzen. Wenn Sie lange Routen benötigen, verlängern Sie die Fristen für Anfragen, um die Wahrscheinlichkeit von DEADLINE_EXCEEDED-Fehlern zu verringern.

Attribute

Wenn Sie Attribute für die Routenplanung für große Fahrzeuge verwenden möchten, müssen Sie ein Fahrzeug mit seinen physischen Abmessungen konfigurieren und den Routenmodus auf „Lkw“ festlegen.

In der folgenden Tabelle sind die Attribute der obersten Ebene für die Konfiguration der Routenplanung für große Fahrzeuge aufgeführt:

Attribut Typ Anforderung Beschreibung
travelMode String Erforderlich Gibt den Reisemodus für das Fahrzeug an. Wenn Sie Attribute für die Routenplanung für große Fahrzeuge aktivieren möchten, legen Sie diesen Wert auf TRUCK fest.
routeModifiers Objekt Erforderlich Enthält routenspezifische Konfigurationen, einschließlich vehicleInfo.

vehicleInfo

Das vehicleInfo Objekt enthält die physischen Spezifikationen des Fahrzeugs. Definieren Sie dieses Objekt im routeModifiers Attribut. Das Objekt vehicleInfo muss angegeben werden , wenn Sie travelMode auf TRUCK festlegen.

In der folgenden Tabelle sind die Attribute aufgeführt, die im vehicleInfo Objekt verfügbar sind:

Attribut Typ Anforderung Beschreibung
totalHeightMm Ganzzahl Erforderlich Gibt die Gesamthöhe des Fahrzeugs in Millimetern an. Dieser Wert muss eine positive Ganzzahl sein.
totalWidthMm Ganzzahl Erforderlich Gibt die Gesamtbreite des Fahrzeugs in Millimetern an. Dieser Wert muss eine positive Ganzzahl sein.
totalWeightKg Ganzzahl Erforderlich Gibt das Gesamtgewicht des Fahrzeugs in Kilogramm an. Dieser Wert muss eine positive Ganzzahl sein.
totalLengthMm Ganzzahl Erforderlich Gibt die Gesamtlänge des Fahrzeugs in Millimetern an. Dieser Wert muss eine positive Ganzzahl sein.
trailerInfo Array Optional Enthält ein Array mit Anhängerspezifikationen, einschließlich des Attributs lengthMm, mit dem die Länge jedes einzelnen Anhängers in Millimetern angegeben wird.
totalAxleCount Ganzzahl Erforderlich Gibt die Gesamtzahl der Achsen am Fahrzeug an. Dieser Wert muss eine Ganzzahl größer oder gleich 2 sein.

Beispiele

In diesem Abschnitt werden zwei Arten von Beispielen behandelt:

Codebeispiel

Im folgenden Beispiel wird die Struktur der Attribute für die Routenplanung für große Fahrzeuge dargestellt:

"vehicles": [
  {
    "travelMode": "TRUCK",
    "routeModifiers": {
      "vehicleInfo": {
        "totalHeightMm": TOTAL_HEIGHT_MM,
        "totalWidthMm": TOTAL_WIDTH_MM,
        "totalWeightKg": TOTAL_WEIGHT_KG,
        "totalLengthMm": TOTAL_LENGTH_MM,
        "trailerInfo": [
          {
            "lengthMm": TRAILER_LENGTH_MM
          }
        ],
        "totalAxleCount": TOTAL_AXLE_COUNT
      }
    }
  }
]

Beispielanfrage

Im folgenden Beispiel wird die Struktur einer einfachen optimizeTours Anfrage mit Routenplanung für große Fahrzeuge dargestellt:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 40.953523,
              "longitude": -72.2277846
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 40.9546673,
              "longitude": -72.2580151
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "TRUCK",
        "routeModifiers": {
          "vehicleInfo": {
            "totalHeightMm": 4000,
            "totalWidthMm": 2500,
            "totalWeightKg": 9000,
            "totalLengthMm": 20000,
            "trailerInfo": [
              {
                "lengthMm": 15000
              }
            ],
            "totalAxleCount": 5
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}