Gibt die Hauptroute sowie optionale alternative Routen zurück, wenn eine Reihe von End- und Zwischenpunkten angegeben wird.
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 einem HTTP-/gRPC-Header X-Goog-FieldMask
angeben (siehe Verfügbare URL-Parameter und ‑Header). Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen finden Sie unter Feldpfade erstellen.
Beispiel für diese Methode:
- Feldmaske aller verfügbaren Felder (für manuelle Prüfung):
X-Goog-FieldMask: *
- Feldmaske mit Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für eine Produktionskonfiguration):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google rät davon ab, die Platzhalter-Antwortfeldmaske (*
) zu verwenden oder die Feldmaske auf oberster Ebene (routes
) anzugeben, weil:
- Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen einsparen. So können wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
- Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu, und 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 Felder auswählen, die Sie benötigen, führt dies zu einer kleineren Antwortgröße und damit zu einem höheren Netzwerkdurchsatz.
HTTP-Anfrage
POST https://routespreferred.googleapis.com/v1:computeRoutes
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "origin": { object ( |
Felder | |
---|---|
origin |
Erforderlich. Ursprungswegpunkt. |
destination |
Erforderlich. Zielwegpunkt. |
intermediates[] |
Optional. Eine Gruppe von Wegpunkten entlang der Route (mit Ausnahme von Endpunkten), die an einem Zwischenstopp stehen oder an einem vorbeigehen. Es werden bis zu 25 Wegpunkte unterstützt. |
travel |
Optional. Gibt die Mobilitätsform an. |
routing |
Optional. Gibt an, wie die Route berechnet werden soll. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung 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 |
polyline |
Optional. Gibt die gewünschte Qualität der Polylinie an. |
polyline |
Optional. Gibt die bevorzugte Codierung für die Polylinie an. |
departure |
Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig der Zeitpunkt der Anfrage verwendet. Wenn Sie diesen Wert auf eine Zeit festlegen, die bereits verstrichen ist, schlägt die Anfrage fehl. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
compute |
Optional. Gibt an, ob zusätzlich zur Route alternative Routen berechnet werden sollen. Für Anfragen mit Zwischenpunkten werden keine alternativen Routen zurückgegeben. |
route |
Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und sich auf die Berechnung von Routen auswirken. |
language |
Optional. Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Anzeigesprache aus dem Ort der Routenanfrage abgeleitet. |
units |
Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Dazu gehört auch das Feld |
optimize |
Wenn optWaypointOrder auf „true“ gesetzt ist, wird versucht, die angegebenen Zwischen-Wegpunkte so neu zu ordnen, dass die Gesamtkosten der Route minimiert werden. Wenn einer der Wegpunkte ein Wegpunkt ist, schlägt die Anfrage fehl. Verwenden Sie |
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von ComputeRoutesResponse
.
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.