Punkt für eine Route festlegen

Standardmäßig werden Zwischenwegpunkte für Zwischenstopps zum Abholen und Absetzen verwendet. Sie können aber auch angeben, dass ein Zwischenwegpunkt nur durchfahren werden soll.

Eine Route, die einen Startwegpunkt, einen Zwischenwegpunkt und einen Zielwegpunkt enthält, umfasst nur einen Routenabschnitt, der den Start- und den Zielort verbindet und über den Zwischenwegpunkt (via) führt.

Konfigurieren Sie einen Zwischenwegpunkt als Durchgangswegpunkt, indem Sie das Attribut via des Wegpunkts über die Schnittstelle Waypoint auf true setzen.

Die Property via ist am effektivsten, wenn Routen erstellt werden, während der Nutzer die Wegpunkte auf der Karte zieht. So kann der Nutzer in Echtzeit sehen, wie die endgültige Route aussehen könnte. Außerdem wird so sichergestellt, dass Wegpunkte an Orten platziert werden, die für die Routes Library zugänglich sind.

Beispielanfrage

In der folgenden Beispielanfrage wird gezeigt, wie ein Zwischenwegpunkt als Durchgangswegpunkt 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 Plus Code angeben, versucht die Routes Library, den relevantesten Standort mit einer entsprechenden Orts-ID zu finden. Das Array geocodingResults.intermediates 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
    }
  ]
}