Routenplanung für große Fahrzeuge

Das Routing für große Fahrzeuge umfasst eine Reihe von Eigenschaften, mit denen Sie Flottenrouten für große Fahrzeuge optimieren können, indem Sie physische Abmessungen, Gewicht und Anzahl der Anhänger angeben. Die API verwendet diese Attribute, um machbare Routen zu berechnen, die gesperrte Straßen, niedrige Brücken oder Routen mit Gewichtsbeschränkungen vermeiden.

Mit dem Routing 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: Sie können genaue Abmessungen, das Gesamtgewicht, die Anzahl der Achsen und die Anhängerkonfigurationen in die Routenpläne für die gesamte Flotte einbeziehen.
  • Flottenweite Planung verbessern: Erstellen Sie effiziente Routenpläne für Ihre gesamte Lkw-Flotte und sorgen Sie gleichzeitig dafür, dass alle Aufträge den physischen Straßenbeschränkungen entsprechen.
  • Detaillierte Routenführung aktivieren: Generieren Sie Routentokens für optimierte Flottenmanagement-Routen und übergeben Sie sie an das Navigation SDK, um Fahrer mit einer Navigation für große Fahrzeuge zu unterstützen.

Beschränkungen

Bevor Sie beginnen, sollten Sie sich mit den folgenden Einschränkungen und Anforderungen vertraut machen.

  • Geografische Verfügbarkeit: Die Routenplanung für große Fahrzeuge ist nur in den 48 zusammenhängenden 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 wie niedrigen Brücken oder Straßen ausgesetzt sein, auf denen große Fahrzeuge verboten sind.
  • Best-Effort-Routen: In einigen Fällen kann die API keine Route finden, die alle Reisebeschränkungen erfüllt. Stattdessen wird eine „Best-Effort“-Route zurückgegeben, die möglicherweise trotzdem durch Sperrzonen führt.
  • Nicht unterstützte Funktionen: Die Routenplanung für große Fahrzeuge unterstützt Folgendes nicht:
    • Lkw-Mautgebühren
    • Höchstgeschwindigkeit
    • Routen für radioaktive Gefahrgüter
  • Abrechnung:Google rechnet alle optimizeTours-Anfragen einheitlich ab, unabhängig davon, ob mit den Anfragen Eigenschaften für die Routenplanung für große Fahrzeuge konfiguriert werden.
  • Langstreckenrouten:Lkw-Routen über 500 km erfordern mehr Rechenzeit als kürzere Routen und liefern möglicherweise Routendaten von geringerer Qualität. Um die Qualität der Routen zu gewährleisten, sollten Sie die Entfernungen zwischen Sendungen, Startorten und Zielorten von Fahrzeugen begrenzen. Wenn Sie lange Routen benötigen, erhöhen Sie die Zeitlimits für Anfragen, um die Wahrscheinlichkeit von DEADLINE_EXCEEDED-Fehlern zu verringern.

Attribute

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

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

Attribut Typ Anforderung Beschreibung
travelMode String Erforderlich Gibt die Mobilitätsform für das Fahrzeug an. Wenn Sie die Eigenschaften für das Routing von großen Fahrzeugen 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 innerhalb des Attributs routeModifiers. Die Angabe des vehicleInfo-Objekts ist erforderlich, wenn Sie travelMode auf TRUCK festlegen.

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

Attribut Typ Anforderung Beschreibung
totalHeightMm integer Erforderlich Gibt die Gesamthöhe des Fahrzeugs in Millimetern an. Dieser Wert muss eine positive Ganzzahl sein.
totalWidthMm integer Erforderlich Gibt die Gesamtbreite des Fahrzeugs in Millimetern an. Dieser Wert muss eine positive Ganzzahl sein.
totalWeightKg integer Erforderlich Gibt das Gesamtgewicht des Fahrzeugs in Kilogramm an. Dieser Wert muss eine positive Ganzzahl sein.
totalLengthMm integer 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 Trailer-Spezifikationen, einschließlich der Eigenschaft lengthMm, um die Länge jedes einzelnen Trailers in Millimetern anzugeben.
totalAxleCount integer Erforderlich Gibt die Gesamtzahl der Achsen des Fahrzeugs an. Dieser Wert muss eine Ganzzahl größer oder gleich 2 sein.

Beispiele

Dieser Abschnitt enthält zwei Arten von Beispielen:

Codebeispiel

Das folgende Beispiel zeigt die Struktur der Eigenschaften, die für die Routenplanung für große Fahrzeuge verwendet werden:

"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

Das folgende Beispiel zeigt die Struktur einer einfachen optimizeTours-Anfrage mit Routen für große Fahrzeuge:

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

Nächste Schritte

  • Detaillierte Routenführung bereitstellen: Hier erfahren Sie, wie Sie die für jeden Übergang zurückgegebene routeToken an das Navigation SDK für Android oder iOS übergeben.
  • Übergangspolylinien und Routentokens generieren: Hier erfahren Sie, wie Sie Routentokens mit populateTransitionPolylines in Übergangspolylinien und Routentokens anfordern.
  • API-Referenz: Eine vollständige Liste der Felder finden Sie in der optimizeTours-Referenz.