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. Questo è utile in casi come la consegna di cibo o il car sharing, in cui il punto di ritiro o di consegna 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, all'SDK Navigation per Android o all'SDK Navigation per iOS oppure all'API Routes, dove viene creato un waypoint per un routing preciso. La destinazione verrà evidenziata per il conducente dall'SDK di navigazione in base al luogo a cui è associato il token.

Esempio: caso d'uso di rideshare

Panoramica

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

In linea generale, la procedura prevede i seguenti passaggi:

  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 di 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 partenza corretto.

Consulta la sezione Per saperne di più 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 car pooling o di consegna utilizza l'API Geocoding, l'API Routes e l'SDK di navigazione per iOS o Android per indirizzare un conducente utilizzando un token di percorso e un token di punto di navigazione:

Diagramma del caso d'uso di car sharing o consegna
Diagramma di un caso d'uso di car pooling o 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 sul percorso verso la destinazione.

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

Esempi di app per consumatori e conducenti

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

Consumatore che sceglie un punto di consegna

L'utente sceglie il punto che preferisce, ovvero uno nell'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 conducenti che utilizza l'SDK di navigazione per iOS o Android per creare un waypoint per indirizzare il conducente al punto di partenza corretto.

Per approfondire