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, das Navigation SDK for iOS oder die Routes API senden, um die Routenplanung und die Fahrerfreundlichkeit zu verbessern. Das ist nützlich, wenn der Abhol- oder Absetzpunkt ohne Nutzereingabe nicht eindeutig ist, z. B. bei Essenslieferungen oder Mitfahrgelegenheiten.

Wenn Sie ein Navigationspunkt-Token erstellen und übergeben möchten, verwenden Sie die Destinations-Methode der Geocoding API. So können Ihre Nutzer einen bevorzugten Ort aus einer Liste von Navigationspunkten auswählen. Die Auswahl des Nutzers wird zu einem Navigationspunkt, der von der Destinations-Methode 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, das Navigation SDK for iOS oder die Routes API übergeben. Dort wird dann ein Wegpunkt für die genaue Routenplanung erstellt. Das Ziel wird dem Fahrer vom Navigations-SDK basierend auf dem Ort, mit dem das Token verknüpft ist, hervorgehoben.

Beispiel: Anwendungsfall Mitfahrgelegenheit

Übersicht

In diesem Beispiel wird gezeigt, wie Sie die Geocoding API, die Routes API und das Navigation SDK für iOS oder Android kombinieren, um eine Mitfahr-App zu erstellen, die den Preis für die Route berechnet und Fahrer zum richtigen Abholort leitet.

Auf übergeordneter Ebene sind folgende Schritte erforderlich:

  1. Rufen Sie ein Navigationspunkt-Token über die Geocoding API ab.
  2. Mit der Routes API können Sie eine Route berechnen und in einem Routentoken codieren.
  3. Übergeben Sie sowohl das Navigationspunkt-Token als auch das Routen-Token an das Navigation SDK.
  4. Verwenden Sie das Navigation SDK, um den Fahrer zum richtigen Abholort zu leiten.

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

In diesem Diagramm sehen Sie, wie eine Mitfahr- oder Liefer-App die Geocoding API, die Routes API und das Navigation SDK für iOS oder Android verwenden würde, um einen Fahrer mithilfe eines Routen-Tokens und eines Navigationspunkt-Tokens zu leiten:

Anwendungsfalldiagramm für Mitfahr- oder Lieferdienste
Diagramm eines Anwendungsfalls für Mitfahrdienste oder Lieferungen

Beispiel für Fahrdienst

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

Diese Abbildung zeigt Beispiele für eine Mitfahr-App für Fahrgäste, in der der Navigationspunkt ausgewählt ist, und eine Fahrer-App, die das Navigation SDK for Android verwendet, um den Fahrer genau zu routen.

Beispiele für Apps für Fahrgäste und Fahrer

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

Verbraucher wählt einen Absetzort aus

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

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

Das App-Backend stellt der Routes API das Navigationspunkt-Token zur Verfügung, um die Route zu berechnen und ein Routen-Token abzurufen.

Schließlich werden sowohl das Navigationspunkt-Token als auch das Routen-Token an eine mobile Fahrer-App übergeben, die das Navigation SDK für iOS oder Android verwendet, um einen Wegpunkt zu erstellen, über den der Fahrer zum richtigen Abholpunkt geleitet wird.

Weitere Informationen