Route mit Navigationspunkt-Tokens erstellen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Mit Navigation Point-Tokens können Sie wichtige Kontextinformationen zu einem Ziel an das Navigation SDK for Android, Navigation SDK for iOS oder die Routes API senden, um die Routenplanung und die Fahrerfahrung zu verbessern. Das ist in Fällen wie der Essenslieferung oder bei Mitfahrdiensten nützlich, bei denen der Abhol- oder Absetzpunkt ohne Nutzereingabe möglicherweise nicht eindeutig ist.

Verwenden Sie die Methode „Destinations“ der Geocoding API, um ein Navigation Point-Token zu erstellen und zu übergeben. So können Ihre Nutzer einen bevorzugten Standort aus einer Liste von Navigations punkten auswählen. Die Auswahl des Nutzers wird zu einem Navigationspunkt, der von der Methode „Destinations“ der Geocoding API zurückgegeben wird.

Anschließend können Sie das Navigation Point-Token, das sowohl die Zielkoordinaten als auch Kontextinformationen enthält, an das Navigation SDK for Android, das Navigation SDK for iOS oder die Routes API übergeben. Dort wird ein Wegpunkt für die genaue Routenplanung erstellt. Das Ziel wird dem Fahrer vom Navigation SDK basierend auf dem Ort hervorgehoben, mit dem das Token verknüpft ist.

Beispiel: Mitfahrdienst

Übersicht

In diesem Beispiel wird gezeigt, wie Sie die Geocoding API, die Routes API und das Navigation SDK for iOS oder Android kombinieren, um eine Mitfahrdienst-App zu erstellen, die den Routenpreis berechnet und Fahrer zum richtigen Abholpunkt leitet.

Die Schritte auf hoher Ebene sind:

  1. Rufen Sie ein Navigation Point-Token über die Geocoding API ab.
  2. Berechnen Sie mit der Routes API eine Route und codieren Sie sie in einem Routentoken.
  3. Übergeben Sie sowohl das Navigation Point-Token als auch das Routentoken an das Navigation SDK.
  4. Leiten Sie den Fahrer mit dem Navigation SDK zum richtigen Abholpunkt.

Im Abschnitt Weitere Informationen finden Sie Links zur entsprechenden Dokumentation der Routes API, des Navigation SDK for iOS und des Navigation SDK for Android.

In diesem Diagramm wird gezeigt, wie eine Mitfahrdienst- oder Liefer-App die Geocoding API, die Routes API und das Navigation SDK for iOS oder Android verwendet, um einen Fahrer mithilfe eines Routentokens und eines Navigation Point-Tokens zu leiten:

Diagramm: Anwendungsfall – Mitfahrdienst oder Lieferdienst
Diagramm eines Mitfahrdienst- oder Lieferanwendungsfalls

Beispiel für einen Mitfahrdienst

Stellen Sie sich ein Mitfahrdienst-Szenario vor, in dem es eine App für den Kunden gibt, um die Fahrt zu buchen, und eine zweite App für den Fahrer, um eine Benachrichtigung über die Fahrt und Routeninformationen zum Ziel zu erhalten.

Dieses Bild zeigt Beispiele für eine Mitfahrdienst-App für Kunden, in der der Navigationspunkt ausgewählt ist, und eine Fahrer-App, die das Navigation SDK for Android verwendet, um den Fahrer genau zu leiten.

Beispiele für Verbraucher- und Fahrer-Apps

Wenn ein Kunde die Kunden-App öffnet, ruft die App die Methode „Destinations“ der Geocoding API auf und bietet dem Kunden eine Auswahl potenzieller Navigationspunkte:

Verbraucher wählt einen Abgabeort aus

Der Nutzer wählt den gewünschten Punkt aus, der sich in der Array von navigationPoints im Antworttext einer SearchDestinations-Anfrage befindet:

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

Das App-Back-End stellt der Routes API das Navigation Point-Token zur Verfügung, um die Route zu berechnen und ein Routentoken abzurufen.

Schließlich werden sowohl das Navigation Point-Token als auch das Routentoken an eine mobile Fahrer-App übergeben, die das Navigation SDK for iOS oder Android verwendet, um einen Wegpunkt zu erstellen, um den Fahrer zum richtigen Abholpunkt zu leiten.

Weitere Informationen