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 senden, um das Routing und die Fahrerfreundlichkeit zu verbessern. Das ist z. B. bei Lieferdiensten oder Fahrdiensten nützlich, bei denen der Abhol- oder Abgabeort ohne Nutzereingabe möglicherweise nicht eindeutig ist.

Dieses Bild zeigt Beispiele für eine Mitfahr-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 übergeben, wo ein Wegpunkt für das genaue Routing erstellt wird. 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 Navigations-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 for Android verwendet, um einen Waypoint zu erstellen, über den der Fahrer zum richtigen Abholort geleitet wird.