Nimmt 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 mithilfe des URL-Parameters $fields
oder fields
oder mit dem HTTP/gRPC-Header X-Goog-FieldMask
bereitstellen. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen finden Sie unter Feldpfade erstellen.
Zum Beispiel in dieser Methode:
- Feldmaske aller verfügbaren Felder (für die manuelle Prüfung):
X-Goog-FieldMask: *
- Feldmaske für Routendauer, -abstände, -status, -zustand und -indizes (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 andernfalls alle Nachrichten als fehlerfrei angezeigt werden. Google rät von der Verwendung des Platzhalters (*
) in der Antwortfeldmaske ab, da:
- Indem Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Berechnungszyklen, sodass wir das Ergebnis mit einer geringeren Latenz an Sie zurückgeben können.
- Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Wir werden möglicherweise in Zukunft weitere Antwortfelder hinzufügen. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. 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, ist die Antwort kleiner und der Netzwerkdurchsatz höher.
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 ( |
Felder | |
---|---|
origins[] |
Erforderlich. Array mit Ursprüngen, das die Zeilen der Antwortmatrix bestimmt. Für die Kardinalität von Start- und Zielorten gelten mehrere Größenbeschränkungen:
|
destinations[] |
Erforderlich. Array mit Zielen, das die Spalten der Antwortmatrix bestimmt. |
travel |
Optional. Gibt die Mobilitätsform an. |
routing |
Optional. Gibt an, wie die Route berechnet wird. Der Server versucht, die Route anhand der ausgewählten Routing-Einstellung zu berechnen. Wenn die Routing-Einstellung zu einem Fehler oder zu einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Diese Option kann nur angegeben werden, wenn |
departure |
Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig der Zeitpunkt der Anfrage verwendet. Wenn Sie für diesen Wert einen Zeitpunkt festlegen, der bereits stattgefunden hat, schlägt die Anfrage fehl. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext einen Stream von RouteMatrixElement
-Instanzen.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/maps-platform.routespreferred
Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.