Punkt für eine Route festlegen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Standardmäßig werden Zwischenziele für das Abholen und Absetzen von Fahrgästen verwendet. Sie können aber auch angeben, dass ein Zwischenziel nur durchfahren werden soll.

Eine Route mit einem Startwegpunkt, einem Pass-Through-Zwischenwegpunkt und einem Zielwegpunkt enthält nur einen Routenabschnitt, der den Start- und den Zielort verbindet und dabei den Zwischenwegpunkt (via) durchläuft.

Konfigurieren Sie einen Zwischen-Waypoint als Pass-Through-Waypoint, indem Sie das Attribut via des Waypoints mit der Waypoint-Schnittstelle auf true setzen.

Die Eigenschaft via ist am effektivsten, wenn Routen als Reaktion darauf erstellt werden, dass der Nutzer die Wegpunkte auf der Karte zieht. So kann der Nutzer in Echtzeit sehen, wie die endgültige Route aussehen könnte, und sicherstellen, dass Wegpunkte an Orten platziert werden, auf die die Routes Library zugreifen kann.

Beispielanfrage

Im folgenden Beispiel wird gezeigt, wie ein Zwischenziel als Durchgangsziel markiert wird.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);

Orts-IDs für Wegpunkte entlang der Route abrufen

Wenn Sie den Standort eines Startpunkts, Ziels oder Zwischenwegpunkts als Adressstring oder als Plus Code angeben, versucht die Routes Library, den relevantesten Standort mit einer entsprechenden Orts-ID zu finden. Das geocodingResults.intermediates-Array in den Ergebnissen enthält die Orts-ID, die dem Standort der Wegpunkte entspricht, sowie zusätzliche Daten zum Standort.

Beispiel für eine Antwort mit Geocoding-Ergebnissen

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}