Method: computeRoutes

Gibt die primäre Route zwischen dem angeforderten Start- und Zielort für die angeforderte Mobilitätsform zurück.

HTTP-Anfrage

POST https://mapstools.googleapis.com/v1alpha:computeRoutes

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Felder
origin

object (Waypoint)

Erforderlich. Ausgangswegpunkt.
destination

object (Waypoint)

Erforderlich. Zielwegpunkt.
travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an.
intermediateWaypoints[]

object (Waypoint)

Optional. Zwischenstopps zwischen Start- und Zielort, die in der angegebenen Reihenfolge passiert werden sollen. Es werden bis zu 25 Zwischenwegpunkte unterstützt.

Wenn Sie mehr als 10 Zwischenwegpunkte angeben, führt das zu höheren Kosten und einer höheren Latenz. Zwischenwegpunkte werden nicht unterstützt, wenn travelMode den Wert TRANSIT hat.
routingPreference

enum (RoutingPreference)

Optional. Bestimmt, wie Verkehrsdaten zur Berechnung der Route verwendet werden. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL wird nicht unterstützt, wenn travelMode WALK oder BICYCLE ist. Für TRANSIT werden Echtzeitdaten zu öffentlichen Verkehrsmitteln wie Verspätungen und Ausfälle aktiviert.
locationBias

object (LatLng)

Optional. Ein Ort, auf den die Suchergebnisse ausgerichtet werden sollen, z. B. um Mehrdeutigkeiten bei Textabfragen für Wegpunkte aufzulösen.
includePolyline

boolean

Optional. Gibt an, ob die codierte Polylinie in die Antwortrouten aufgenommen werden soll. Die Standardeinstellung ist false. Wenn true festgelegt ist, wird Route.encoded_polyline zurückgegeben.
computeAlternativeRoutes

boolean

Optional. Gibt an, ob zusätzlich zur empfohlenen Route alternative Routen berechnet werden sollen. Der Standardwert ist „false“. In diesem Fall wird nur die empfohlene Route zurückgegeben. Wenn „true“ festgelegt ist, werden bis zu alle verfügbaren Routen zurückgegeben. Alternativen sind jedoch möglicherweise nicht für jede Anfrage verfügbar.
Gibt an, wann Sie vom Startpunkt abfahren oder am letzten Wegpunkt ankommen möchten. Wenn keine Angabe gemacht wird, wird standardmäßig die aktuelle Uhrzeit verwendet. Bei TRANSIT darf die Zeit höchstens 7 Tage in der Vergangenheit und höchstens 100 Tage in der Zukunft liegen. Bei anderen Mobilitätsformen darf die Zeit nicht in der Vergangenheit liegen und höchstens 365 Tage in der Zukunft. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
departureTime

string (Timestamp format)

Optional. Gibt an, dass die Route anhand der Abfahrtszeit berechnet werden soll.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

Optional. Gibt an, dass die Route anhand der Ankunftszeit berechnet werden soll.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Ende der sich gegenseitig ausschließenden Felder.

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.mapstools