Alternative Routen abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Standardmäßig gibt die Routes API die Standardroute zurück. Das ist in der Regel die schnellste Route vom Start- zum Zielort. Wenn Sie alternative Routen anfordern, gibt die API zusätzlich zur Standardroute bis zu drei Routen zurück. Ihre Kunden können dann eine Route auswählen, die ihren Anforderungen am besten entspricht.

Überlegungen beim Anfordern alternativer Routen

Wenn Sie alternative Routen anfordern möchten, beachten Sie Folgendes:

  • Die Antwort enthält maximal drei alternative Routen. Manchmal sind jedoch keine alternativen Routen verfügbar, sodass die Antwort nur die Standardroute enthält.

  • Da für die Berechnung alternativer Routen zusätzliche Verarbeitungsschritte erforderlich sind, kann sich die Antwortzeit der API verlängern, wenn alternative Routen angefordert werden.

Beispielanfrage für alternative Routen

Legen Sie für computeAlternativeRoutes den Wert true fest, um alternative Routen anzufordern. Im folgenden Beispiel wird gezeigt, wie Sie in einer computeRoutes-Methodenanfrage (REST) alternative Routen anfordern.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

In diesem Beispiel geben Sie eine Feldmaske an, damit die Antwort nur die Attribute duration, distanceMeters, und routeLabels für jede Route enthält. Anhand dieser Informationen kann Ihr Kunde dann entscheiden, welche Route er nehmen möchte. Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.

Beispiel für eine Antwort mit alternativen Routen

Verwenden Sie in der Antwort die Array-Property routeLabels, um die Reichweitenroute zu identifizieren:

  • Für die Standardroute enthält das Attribut routeLabels den Wert DEFAULT_ROUTE.

  • Bei alternativen Routen enthält das Attribut routeLabels den Wert DEFAULT_ROUTE_ALTERNATE.

In diesem Beispiel enthält die Antwort die Standardroute und zwei alternative Routen. Die Werte der Attribute duration und distanceMeters sind für jede Route unterschiedlich:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

Polylinien in die Antwort einbeziehen

Damit der Nutzer die Route leichter auswählen kann, fügen Sie der Antwort die Polylinie für jede Route hinzu. Anschließend können Sie jede Polylinie auf einer Karte anzeigen lassen.

Wenn Sie die Polylinie hinzufügen möchten, fügen Sie routes.polyline in die Feldmaske ein:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

Die Antwort enthält dann die Polylinie für jede Route:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}