Route mit Navigationspunkt-Tokens erstellen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Mit Navigationspunkt-Tokens können Sie wichtige Kontextinformationen zu einem Ziel an das Navigation SDK for Android oder das Navigation SDK for iOS senden, um das Routing und die Fahrerfreundlichkeit zu verbessern. Das ist nützlich, wenn der Abhol- oder Abgabeort ohne Nutzereingabe nicht eindeutig ist, z. B. bei der Essenslieferung oder bei Fahrdiensten.

Dieses Bild zeigt Beispiele für eine Ridesharing-App für Verbraucher, in der der Navigationspunkt ausgewählt ist, und eine Fahrer-App, die das Navigation SDK for Android verwendet, um den Fahrer präzise zu navigieren.

Beispiele für Verbraucher- und Fahrer-Apps

Wenn Sie ein Navigationspunkt-Token erstellen und übergeben möchten, verwenden Sie den Destinations-Endpunkt der Geocoding API, damit Ihre Nutzer einen bevorzugten Ort aus einer Liste von Navigationspunkten auswählen können. Die Auswahl des Nutzers wird zu einem Navigationspunkt, der vom Destinations-Endpunkt der Geocoding API zurückgegeben wird. Anschließend können Sie das Navigationspunkt-Token, das sowohl die Zielkoordinaten als auch Kontextinformationen enthält, an das Navigation SDK for Android oder das Navigation SDK for iOS übergeben. Dort wird ein Wegpunkt für das genaue Routing erstellt. Das Ziel wird dem Fahrer vom Navigation SDK basierend auf dem Ort, mit dem das Token verknüpft ist, hervorgehoben.

So wird ein Navigationspunkt-Token erstellt und zum Routing an das Nav SDK gesendet

Stellen Sie sich beispielsweise einen Ridesharing-Anwendungsfall vor, bei dem es eine App für den Nutzer gibt, um die Fahrt zu buchen, und eine zweite App für den Fahrer, um eine Benachrichtigung über die Fahrt und Routinginformationen zum Ziel zu erhalten.

Wenn ein Nutzer die Nutzer-App öffnet, ruft die App den Destinations-Endpunkt der Geocoding API auf und bietet dem Nutzer eine Auswahl potenzieller Navigationspunkte:

Verbraucher wählt einen Abgabeort aus

Der Nutzer wählt seinen bevorzugten Punkt aus, der einer im Array von navigationPoints im Antworttext einer SearchDestinations-Anfrage entspricht:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

Das Navigationspunkt-Token aus der Antwort wird an eine mobile Fahrer-App übergeben, die das Navigation SDK für Android oder iOS verwendet, um einen Wegpunkt zu erstellen, über den der Fahrer zum richtigen Abholort geleitet wird.