Zwischenstopp auf einer Route festlegen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Sie haben zwei Möglichkeiten, einen Stopp entlang einer Route festzulegen, z. B. für eine Abholung oder eine Abgabe:

  • Zwischenwegpunkt hinzufügen: Das ist die Standardeinstellung. Fügen Sie im Array intermediates einen Zwischenwegpunkt zwischen Start und Ziel hinzu. Die Routing-Engine platziert den Wegpunkt auf der nächstgelegenen befahrbaren Straße und unterteilt die Route in RouteLeg-Segmente, die durch diesen Stopp verbunden sind.
  • vehicleStopover angeben: Wenn die Routing-Engine zusätzliche Analysen durchführen soll, um Straßenabschnitte zu vermeiden, die sich nicht für einen Stopp eignen, z. B. Autobahnen, Tunnel oder Überführungen, legen Sie für einen Wegpunkt vehicleStopover: true fest.

Zwischenwegpunkt hinzufügen

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

Das Hinzufügen eines Zwischenwegpunkts hat folgende Auswirkungen:

  • Die Route wird in RouteLeg Segmente unterteilt: Jedes Segment verbindet einen Stopp mit dem nächsten.
  • Die Koordinate wird auf eine Straße platziert: Die Routing-Engine platziert Ihre Breiten und Längengradkoordinate, die sich möglicherweise auf einem Dach oder in einem Hof befindet, auf dem nächstgelegenen befahrbaren Straßenabschnitt.

Bei vielen Straßen ist das Platzieren auf der nächstgelegenen Straße ein praktischer Stopport. Durch das Platzieren wird jedoch nicht bestimmt, ob sich dieser Straßenabschnitt für einen Stopp eignet, z. B. wenn die nächstgelegene Straße eine Autobahn oder ein Tunnel ist.

Beispiel: Zwischenwegpunkt hinzufügen

Im folgenden Beispiel wird gezeigt, wie Sie einen Stopp entlang 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 Abgabe angeben

Ein Standard-Zwischenwegpunkt wird auf der nächstgelegenen Straße platziert. Diese Straße ist jedoch nicht immer für einen Stopp mit dem Fahrzeug geeignet. Wenn die Routing-Engine zusätzliche Analysen durchführen soll, um die Eignung einer Straße für die Abholung oder Abgabe zu bewerten, legen Sie für den Wegpunkt vehicleStopover: true fest.

Wenn Sie vehicleStopover: true festlegen, bewertet die Routing-Engine die infrage kommenden Straßenabschnitte und versucht, Straßen zu vermeiden, die sich nicht für einen Stopp eignen, z. B. Autobahnen, Tunnel und Überführungen.

Beispiel: An einem Ort führt eine Straße direkt über eine Autobahn in einem Tunnel: * Standard-Zwischenwegpunkt: Wird auf der Autobahn oder im Tunnel darunter platziert, wenn diese geometrisch näher an Ihrer Koordinate liegen. * vehicleStopover: Führt zusätzliche Analysen durch, um die Autobahn und den Tunnel zu umfahren, und platziert den Stopp auf einer Straße, die sich für einen Stopp eignet.

Beispiel: vehicleStopover für einen Wegpunkt angeben

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

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.