Zwischenstopp auf einer Route festlegen

Entwickler im Europäischen Wirtschaftsraum (EWR)

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 Zwischenstopp 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 Andocken an die nächste 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 eine Haltestelle auf einer Route festlegen, indem Sie einen Zwischenwegpunkt in einer computeRoutes-POST-Anfrage 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 Abgabeort 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. * Zwischenstopp für Fahrzeuge: Führt eine zusätzliche Analyse durch, um die Autobahn und den Tunnel zu umgehen, und richtet den Stopp auf einer für das Anhalten geeigneten Straße aus.

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.