Zwischenstopp auf einer Route festlegen

Sie haben zwei Möglichkeiten, einen Zwischenstopp auf einer Route festzulegen, z. B. für eine Abholung oder einen Zielort:

• Zwischenziel hinzufügen: Dies ist die Standardoption. Fügen Sie im Array intermediates einen Zwischenwegpunkt zwischen Start- und Zielort hinzu. Die Routing-Engine richtet den Wegpunkt an der nächstgelegenen befahrbaren Straße aus und unterteilt die Route in RouteLeg Abschnitte, die durch diesen Stopp verbunden sind.
• vehicleStopover angeben: Wenn Sie möchten, dass die Routing-Engine zusätzliche Analysen durchführt, um Straßenabschnitte zu vermeiden, die sich nicht zum Anhalten eignen, z. B. Autobahnen, Tunnel oder Überführungen, legen Sie vehicleStopover: true für einen Wegpunkt fest.

Zwischenziel hinzufügen

Wenn Sie einen Zwischenstopp auf einer Route festlegen möchten, fügen Sie dem intermediates-Array in Ihrer Anfrage einen Zwischenwegpunkt hinzu.

Das Hinzufügen eines Zwischenziels hat folgende Auswirkungen:

• Die Route ist in RouteLeg Segmente unterteilt: Jedes Segment verbindet eine Haltestelle mit der nächsten.
• Die Koordinate wird an eine Straße angedockt: Die Routing-Engine dockt Ihre Breiten- und Längengradkoordinate, die sich möglicherweise auf einem Dach oder in einem Garten befindet, an das nächste befahrbare Straßensegment an.

Bei vielen Straßen ist das Einrasten an der nächstgelegenen Straße ein praktischer Haltepunkt. Das Einrasten bestimmt jedoch nicht, ob das Straßenabschnitt zum Anhalten geeignet ist, z. B. wenn die nächste Straße eine Autobahn oder ein Tunnel ist.

Beispiel: Zwischenziel hinzufügen

Im folgenden Beispiel wird gezeigt, wie Sie einen Zwischenstopp auf einer Route festlegen, indem Sie in einer computeRoutes-POST-Anfrage einen Zwischenwegpunkt hinzufü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'

Weitere Informationen zu Zwischenwegpunkten und Routenabschnitten finden Sie unter Zwischenwegpunkte festlegen.

vehicleStopover für die Eignung für Abholung und Lieferung angeben

Ein Standard-Zwischenziel wird zwar an die nächstgelegene Straße angedockt, diese ist aber nicht immer für einen Fahrzeugstopp geeignet. Wenn die Routing-Engine zusätzliche Analysen durchführen soll, um die Eignung der Straße für die Abholung oder den Ausstieg zu bewerten, legen Sie vehicleStopover: true für den Wegpunkt fest.

Wenn Sie vehicleStopover: true festlegen, werden von der Routing-Engine infrage kommende Straßensegmente ausgewertet und es wird versucht, Straßen zu vermeiden, die sich nicht zum Anhalten eignen, z. B. Autobahnen, Tunnel und Überführungen.

Beispiel: An einem Ort, an dem eine Straße direkt über einer Autobahn in einem Tunnel verläuft: * Standard-Zwischenziel: Wird an die Autobahn oder den Tunnel darunter angedockt, wenn es geometrisch näher an Ihrer Koordinate liegt. * Fahrzeugzwischenstopp: Es wird eine zusätzliche Analyse durchgeführt, um die Autobahn und den Tunnel zu umgehen. Der Zwischenstopp wird auf eine Straße an der Oberfläche gelegt, die sich zum Anhalten eignet.

Beispiel: vehicleStopover für einen Wegpunkt angeben

Im folgenden Beispiel wird gezeigt, wie vehicleStopover: true für einen Zwischenstopp in einer vollständigen POST-Anfrage festgelegt wird:

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
        }
      },
      "vehicleStopover": true
    }
  ],
  "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'

Weitere Informationen zu Wegpunkttypen und ‑optionen finden Sie unter Wegpunkttypen und ‑optionen.