Method: computeRouteMatrix

Ruft eine Liste von Start- und Zielorten auf und gibt einen Stream mit Routeninformationen für jede Kombination aus Start- und Zielort zurück.

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit dem HTTP/gRPC-Header X-Goog-FieldMask angeben. Weitere Informationen zu verfügbaren URL-Parametern und Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen der Feldpfade finden Sie in diesem Artikel.

Beispiel:

  • Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): X-Goog-FieldMask: *
  • Feldmaske mit Routendauer, Entfernungen, Elementstatus, Bedingung und Elementindexen (Beispiel für eine Produktionskonfiguration): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Es ist wichtig, dass Sie status in Ihre Feldmaske aufnehmen, da sonst alle Nachrichten in Ordnung zu sein scheinen. Google rät von der Verwendung der Platzhalterantwortfeldmaske (*) ab, da:

  • Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen, sodass wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, die möglicherweise zusätzliche Rechenzeit erfordern. Wenn Sie alle Felder oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die benötigten Felder auswählen, verringert sich die Antwortgröße und damit der Netzwerkdurchsatz.

HTTP-Anfrage

POST https://routespreferred.googleapis.com/v1:computeRouteMatrix

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "origins": [
    {
      object (RouteMatrixOrigin)
    }
  ],
  "destinations": [
    {
      object (RouteMatrixDestination)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "departureTime": string
}
Felder
origins[]

object (RouteMatrixOrigin)

Erforderlich. Array von Ursprüngen, das die Zeilen der Antwortmatrix bestimmt. Für die Kardinalität von Start- und Zielorten gelten mehrere Größenbeschränkungen:

  • Die Anzahl der Elemente (Startorte × Ziele) darf in jedem Fall 625 nicht überschreiten.
  • Die Anzahl der Elemente (Ursprungsorte × Ziele) darf nicht größer als 100 sein, wenn „routingpreferences“ auf TRAFFIC_AWARE_OPTIMAL gesetzt ist.
  • Die Anzahl der als placeId angegebenen Wegpunkte (Startorte + Ziele) darf 50 nicht überschreiten.
destinations[]

object (RouteMatrixDestination)

Erforderlich. Array von Zielen, das die Spalten der Antwortmatrix bestimmt.
travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an.
routingPreference

enum (RoutingPreference)

Optional. Gibt an, wie die Route berechnet wird. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder einer extrem langen Latenz führt, wird ein Fehler zurückgegeben. In Zukunft werden wir möglicherweise einen Fallback-Mechanismus implementieren, um eine andere Option zu verwenden, wenn die bevorzugte Option kein gültiges Ergebnis liefert. Sie können diese Option nur angeben, wenn travelMode den Wert DRIVE oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.
departureTime

string (Timestamp format)

Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig der Zeitpunkt der Anfrage verwendet. Wenn Sie diesen Wert auf einen bereits aufgetretenen Zeitpunkt festlegen, schlägt die Anfrage fehl.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von RouteMatrixElement.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.