Compute Route Matrix – Übersicht

„Compute Route Matrix“ ist eine Methode im Routes API-Dienst, die eine HTTPS-Anfrage akzeptiert und Entfernungen und Fahrtzeiten für eine Routenmatrix zwischen verschiedenen Start- und Zielorten zurückgibt. Sie können Fahrtzeiten und Entfernungen für mehrere Ziele und bis zu 625 Routenelemente berechnen.

Benötigen Sie Routen für Autofahrten? Wenn Sie an Routenbeschreibungen interessiert sind, lesen Sie die Übersicht zu „ Compute Routes“.

Migration? Wenn Sie von der Distance Matrix API (Legacy) migrieren, finden Sie die Migrationsanleitung unter Gründe für die Migration zur Routes API.

Gründe für die Verwendung von „Compute Route Matrix“

Mit „Compute Route Matrix“ können Sie die effizientesten Routen für die Disposition ermitteln, z. B.:

• Wie Sie eine Gruppe von Mitarbeitern am besten mit der Abholung einer Reihe von Paketen beauftragen

• Das beste Lager ermitteln, von dem aus Pakete an ihren endgültigen Zielort versendet werden sollen

Was können Sie mit „Compute Route Matrix“ tun?

Mit „Compute Route Matrix“ können Sie eine Matrix möglicher Routen zwischen vielen Start- und Zielorten abrufen. Sie können mehrere Start- und Zielorte pro serverseitiger Anfrage angeben, wobei die Anzahl der Startorte multipliziert mit der Anzahl der Zielorte maximal 625 betragen darf. Sie können Elemente der Antwort streamen, bevor die gesamte Matrix berechnet wurde, wodurch die Antwortlatenz verringert wird.

Sie können diese Arten von Routendaten anfordern, um die effizienteste Möglichkeit zu ermitteln, Fahrgäste, Sendungen oder Mitarbeiter zwischen mehreren Start- und Zielorten zu befördern:

• Entfernung in Kilometern oder Meilen für eine ausgewählte Reisemethode

• Geschätzte Fahrtzeit im Verkehr

Funktionsweise von „Compute Route Matrix“

Die Methode ComputeRouteMatrix akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind mindestens ein Startort, zwei oder mehr Zielorte, travelMode und eine Feldmaske, um anzugeben, welche Felder zurückgegeben werden sollen.

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Die Antwort enthält die möglichen Routen für die Kombination aller Start- und Zielorte.

Ressourcen

In der folgenden Tabelle sind die Ressourcen zusammengefasst, die über die Methode „Compute Route Matrix“ der Routes API verfügbar sind, sowie die zurückgegebenen Daten.

„Compute Route Matrix“ verwenden

Verfügbare Clientbibliotheken

Eine Liste der verfügbaren Clientbibliotheken für „Compute Route Matrix“ finden Sie unter Clientbibliotheken.

Nächste Schritte

• Routenmatrix abrufen
• Verfügbare Optionen für die Routenmatrix
• Auswählen, welche Informationen zurückgegeben werden sollen
• Von der Distance Matrix API (Legacy) migrieren
• Von der Vorabversion der Routes API zur allgemein verfügbaren Version migrieren