Percorso che utilizza i token dei punti di navigazione

Sviluppatori dello Spazio economico europeo (SEE)

I token dei punti di navigazione ti consentono di inviare informazioni contestuali chiave su una destinazione all'SDK Navigation per Android, all'SDK Navigation per iOS o all'API Routes per migliorare il routing e l'esperienza del conducente. Ciò è utile in casi come la consegna di cibo o il ridesharing, in cui il punto di ritiro o riconsegna potrebbe essere ambiguo senza l'input dell'utente.

Per creare e passare un token del punto di navigazione, utilizza il metodo Destinations dell' API Geocoding per consentire agli utenti di selezionare una località preferita da un elenco di punti di navigazione. La selezione dell'utente diventa un punto di navigazione restituito dal metodo Destinations dell'API Geocoding.

Puoi quindi passare il token del punto di navigazione, che contiene sia le coordinate della destinazione sia le informazioni contestuali, a l'SDK Navigation per Android, all'SDK Navigation per iOS o all'API Routes, dove viene creato un waypoint per un routing preciso. La destinazione verrà evidenziata per il conducente dall'SDK Navigation in base al luogo a cui è associato il token.

Esempio: caso d'uso del ridesharing

Panoramica

Questo esempio mostra come combinare l'API Geocoding, l'API Routes e l'SDK Navigation per iOS o Android per creare un'app di ridesharing che calcola il prezzo del percorso e indirizza i conducenti al punto di ritiro corretto.

Ecco i passaggi a livello generale:

  1. Recupera un token del punto di navigazione tramite l'API Geocoding.
  2. Utilizza l'API Routes per calcolare un percorso e codificarlo in un token del percorso.
  3. Passa sia il token del punto di navigazione sia il token del percorso all'SDK Navigation.
  4. Utilizza l'SDK Navigation per indirizzare il conducente al punto di ritiro corretto.

Consulta la sezione Per approfondire per i link alla documentazione pertinente dell'API Routes, dell'SDK Navigation per iOS e dell'SDK Navigation per Android.

Questo diagramma mostra come un'app di ridesharing o di consegna utilizzerebbe l'API Geocoding, l'API Routes e l'SDK Navigation per iOS o Android per indirizzare un conducente utilizzando un token del percorso e un token del punto di navigazione:

Diagramma del caso d'uso per il servizio di ride sharing o di consegna
Diagramma di un caso d'uso di ridesharing o di consegna

Esempio di ridesharing

Immagina uno scenario di ridesharing in cui esiste un'app per il consumatore per prenotare la corsa e una seconda app per il conducente per ricevere la notifica della corsa e le informazioni di routing alla destinazione.

Questa immagine mostra esempi di un'app di ridesharing per i consumatori in cui viene selezionato il punto di navigazione e un'app per i conducenti che utilizza l'SDK Navigation per Android per indirizzare con precisione il conducente.

Esempi di app per consumatori e autisti

Quando un utente finale apre l'app per utenti finali, l'app chiama il metodo Destinations dell'API Geocoding e fornisce all'utente finale una selezione di potenziali punti di navigazione:

Consumatore che sceglie un punto di consegna

L'utente sceglie il punto che preferisce, che è uno dell'array di navigationPoints nel corpo della risposta di una richiesta SearchDestinations:

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

Il backend dell'app fornisce il token del punto di navigazione all'API Routes per calcolare il percorso e recuperare un token del percorso.

Infine, sia il token del punto di navigazione sia il token del percorso vengono passati a un'app mobile per i conducenti che utilizza l'SDK Navigation per iOS o Android per creare un waypoint per indirizzare il conducente al punto di ritiro corretto.

Per approfondire