Wegpunkte festlegen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Wegpunkte entlang der Route sind Orte, die zwischen Start- und Zielort angegeben werden und die auf der Route liegen sollen.

Sie können mit der REST-Methode computeRoutes oder der gRPC-Methode ComputeRoutes in einer einzelnen Anfrage bis zu 25 Zwischenziele definieren. Verwenden Sie dazu die Array-Property intermediates.

Zwischenstopps im Vergleich zu Durchgangswegpunkten

Sie können einen Zwischenwegpunkt entweder als Stopp oder als Durchfahrtsort konfigurieren:

  • Zwischenstopp: Das Fahrzeug hält standardmäßig an diesem Ort. Jeder Zwischenstopp-Wegpunkt unterteilt die Route, indem in der Antwort ein RouteLeg-Eintrag zum legs-Array hinzugefügt wird. Weitere Informationen finden Sie unter Zwischenstopp auf einer Route festlegen.
  • Durchfahrtswegpunkt mit "via" auf true gesetzt: Das Fahrzeug fährt ohne anzuhalten durch den Ort. Durchgangswegpunkte fügen dem legs-Array keine Einträge hinzu. Weitere Informationen finden Sie unter Punkt festlegen, durch den eine Route verlaufen soll.

Routenabschnitte und Wegpunkte entlang der Route

Für jeden Zwischenstopp in einer Anfrage enthält die Antwort ein separates RouteLeg-Objekt im routes.legs-Array.

Eine Route mit einem Startpunkt, einem Zwischenstopp und einem Zielort enthält beispielsweise zwei Routenabschnitte: * Abschnitt 1: Vom Startpunkt zum Zwischenstopp. * 2. Etappe: Vom Zwischenstopp zum Zielort.

Beispiel: Anfrage mit einem Zwischenziel

Im folgenden Beispiel wird das Array intermediates verwendet, um einer Route einen einzelnen Zwischenstopp hinzuzufügen.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Antwort mit mehreren Routenabschnitten

Da der Zwischenwegpunkt in der Anfrage ein Zwischenstopp ist, für den "via": true nicht festgelegt ist, wird die Route in der Antwort in zwei Abschnitte im Array legs unterteilt:

{
  "routes": [
    {
      "distanceMeters": 805,
      "duration": "248s",
      "legs": [
        {
          "distanceMeters": 207,
          "duration": "89s",
          "startLocation": {
            "latLng": {
              "latitude": 37.4197318,
              "longitude": -122.0826233
            }
          },
          "endLocation": {
            "latLng": {
              "latitude": 37.419734,
              "longitude": -122.0807792
            }
          }
        },
        {
          "distanceMeters": 598,
          "duration": "159s",
          "startLocation": {
            "latLng": {
              "latitude": 37.419734,
              "longitude": -122.0807792
            }
          },
          "endLocation": {
            "latLng": {
              "latitude": 37.4176166,
              "longitude": -122.0793882
            }
          }
        }
      ]
    }
  ]
}