Compute Route Matrix – Übersicht

„Compute Route Matrix“ ist eine Methode im Routes API-Dienst, die eine HTTPS-Anfrage akzeptiert und Entfernungen und Reisezeiten für eine Matrix von Routen 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 Wegbeschreibungen? Informationen zu Routenbeschreibungen finden Sie unter Compute Routes – Übersicht.

Migriert? Wenn Sie von der Distance Matrix API (alte Version) migrieren, lesen Sie die Migrationsanleitung ab Warum zur Routes API migrieren?.

Vorteile von Compute Route Matrix

Mit Compute Routes Matrix können Sie die effizientesten Routen für die Dispatch-Planung ermitteln, z. B.:

  • Wie Sie am besten Mitarbeitern die Abholung einer Reihe von Paketen zuweisen

  • Das beste Lager ermitteln, von dem aus Pakete an ihr endgültiges Ziel versendet werden sollen

Was kann ich mit Compute Route Matrix tun?

Mit Compute Route Matrix können Sie eine Matrix mit möglichen Routen zwischen vielen Start- und Zielorten abrufen. Sie können mehrere Start- und Zielorte pro serverseitiger Anfrage angeben. Die Anzahl der Start- und Zielorte darf maximal 625 betragen. 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 Route für Passagiere, Sendungen oder Mitarbeiter zwischen mehreren Start- und Zielorten zu ermitteln:

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

  • Geschätzte Fahrzeit bei Stau

Funktionsweise von Compute Route Matrix

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

Beispiel

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 Ziel-Wegpunkte.

Ressourcen

In der folgenden Tabelle sind die über die Routes API Compute Route Matrix-Methode verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
ComputeRouteMatrix Gibt ein Array von Routen von einem Start- zu einem Ziel-Wegpunkt zurück. JSON

Compute Route Matrix verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Abrechnung der Routes API Weitere Informationen finden Sie unter Nutzung und Abrechnung.
3 Matrix der Routen berechnen und die Antwort prüfen Weitere Informationen finden Sie unter Routenmatrix abrufen und Routenmatrixantwort prüfen.

Verfügbare Clientbibliotheken

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

Nächste Schritte