Attiva il feed di dati passo passo

Un feed di dati passo passo fornisce informazioni solo di navigazione ai dispositivi non progettati per le indicazioni di navigazione basate su mappe. Fornisce le manovre imminenti con gli elementi che fornisci:

  • Icone (sinistra, destra, inversione a U)
  • Numeri di svolta nelle rotatorie
  • Nomi delle strade
  • Distanze e tempi stimati per il passaggio successivo della navigazione o la destinazione finale

Puoi utilizzare il feed passo passo per creare esperienze in cui l'interfaccia utente completa dell'SDK Navigation non è appropriata, ad esempio per Android Auto o per display con schermi piccoli in cui non è disponibile uno stack Android completo. Ad esempio, potresti utilizzare questa funzionalità per i conducenti di veicoli a due ruote, dove puoi proiettare indicazioni solo di navigazione per aiutarli a raggiungere le loro destinazioni in modo più rapido e sicuro con distrazioni minime.

Per utilizzare l'SDK, devi creare un servizio e registrarlo con l'SDK Navigation per Android in modo che possa ricevere nuove informazioni di navigazione in tempo reale (circa una volta al secondo durante la navigazione).

Questo documento mostra come creare e registrare un servizio di navigazione che riceve informazioni di navigazione dall'SDK e fornisce lo stato di navigazione al dispositivo ricevente.

Panoramica

Questa sezione riassume il flusso di alto livello per l'abilitazione della funzionalità passo passo.

Utilizzo della funzionalità TurnByTurn

Ecco i passaggi di alto livello per abilitare la funzionalità passo passo. Le sezioni seguenti forniscono dettagli su ogni passaggio.

  1. Crea un servizio per ricevere gli aggiornamenti di navigazione.

  2. Registra il servizio.

  3. Comprendi gli stati di navigazione.

Creare un servizio per ricevere gli aggiornamenti di navigazione

L'SDK Navigation si associa al tuo servizio TurnByTurn e gli invia gli aggiornamenti di navigazione tramite Android Messenger . Puoi creare un nuovo servizio di navigazione per questi aggiornamenti o utilizzare un servizio esistente.

Il vantaggio di utilizzare un servizio per ricevere gli aggiornamenti di navigazione è che il servizio può risiedere in un processo in background separato.

Il servizio nell'esempio seguente riceve informazioni di navigazione e utilizza TurnByTurnManager per convertire i dati in un oggetto NavInfo che contiene i dettagli di navigazione.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

Codici messaggio

I messaggi NavInfo possono essere identificati tramite il campo Message.what della classe Message, impostato sul valore di TurnByTurnManager.MSG_NAV_INFO.

Registrare il servizio per gli aggiornamenti di navigazione

I seguenti snippet di codice registrano il servizio di navigazione.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

Avviare e arrestare il servizio

Il servizio di navigazione è attivo finché l'SDK Navigation è associato. Puoi chiamare manualmente startService() e stopService() per controllare il ciclo di vita del servizio di navigazione, ma quando registri il servizio con l'SDK Navigation, il servizio viene avviato automaticamente e si arresta solo quando annulli la registrazione. A seconda di come configuri l'app, potresti prendere in considerazione l'avvio di un servizio in primo piano, come descritto nella documentazione panoramica dei servizi di Android.

Annullare la registrazione del servizio

Per interrompere la ricezione degli aggiornamenti di navigazione, annulla la registrazione del servizio dall'SDK Navigation.

navigator.unregisterServiceForNavUpdates();

Comprendere gli stati di navigazione

Utilizza NavInfo.getNavState() per ottenere lo stato attuale della navigazione, che è uno dei seguenti:

  • Enroute - Lo stato ENROUTE indica che la navigazione guidata è attiva e l'utente si trova sul percorso fornito. Sono disponibili informazioni sul passaggio di manovra imminente corrente.

  • Rerouting - REROUTING indica che la navigazione è in corso, ma il navigatore sta cercando un nuovo percorso. Il passaggio di manovra imminente non è disponibile perché non è ancora presente un nuovo percorso. Nell'app di esempio, nella visualizzazione delle informazioni di navigazione viene visualizzato il messaggio "Ricalcolo del percorso in corso…". Una volta trovato un percorso, viene inviato un messaggio NavInfo con lo stato ENROUTE.

  • Stopped - STOPPED indica che la navigazione è terminata. Ad esempio, la navigazione si interrompe quando l'utente esce dalla navigazione nell'app. Nell'app di esempio, uno stato STOPPED cancella la visualizzazione delle informazioni di navigazione per evitare che vengano visualizzate istruzioni passo passo persistenti.

Compilare la visualizzazione del feed

Ora che hai configurato il servizio passo passo, questa sezione illustra gli elementi visivi e di testo che puoi utilizzare per compilare le schede delle indicazioni per il feed passo passo.

Schermata di un dispositivo mobile che mostra una svolta a sinistra imminente su W Ahwanee Ave tra 30 metri. Nella parte inferiore dello schermo, il tempo rimanente per raggiungere la destinazione è di 46 minuti e la distanza rimanente è di 63 km.

Quando l'utente avvia la navigazione guidata, nella parte superiore viene visualizzata una scheda di navigazione contenente i dati di navigazione compilati dall'SDK Navigation. L'immagine correlata mostra un esempio di questi elementi di navigazione essenziali.

Questa tabella mostra i campi per le informazioni di navigazione e dove trovarli.

Campi per ogni passaggio di navigazione Campi per l'intero viaggio
Trovato in StepInfo Trovato in NavInfo
Nome completo della strada Tempo rimanente
L'icona della manovra Distanza dalla destinazione
Distanza dal passaggio successivo
Campi delle indicazioni delle corsie in cui posizionarsi

Indicazione delle corsie in cui posizionarsi

L'SDK Navigation rappresenta le corsie nella navigazione scheda di svolta come Lane e LaneDirection oggetti di dati. Un oggetto Lane rappresenta una corsia specifica durante la navigazione e contiene un elenco di oggetti LaneDirection che descrivono tutte le svolte che possono essere effettuate da questa corsia.

Una configurazione di esempio dell'indicazione delle corsie in cui posizionarsi.

La direzione consigliata che un utente deve prendere in una corsia è contrassegnata dal isRecommended.

Esempio di indicazione delle corsie in cui posizionarsi

Il seguente snippet illustra la rappresentazione dei dati delle corsie visualizzate sopra.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

Creare icone per le manovre

L' Maneuver enumerazione definisce ogni possibile manovra che potrebbe verificarsi durante la navigazione e puoi ottenere la manovra per un determinato passaggio dal metodo StepInfo.getManeuver().

Devi creare le icone delle manovre e associarle alle manovre associate. Per alcune manovre, puoi configurare un mapping uno a uno a un'icona, ad esempio DESTINATION_LEFT e DESTINATION_RIGHT. Tuttavia, poiché alcune manovre sono simili, potresti voler mappare più di una manovra a una singola icona. Ad esempio, TURN_LEFT e ON_RAMP_LEFT potrebbero essere mappate entrambe all'icona di svolta a sinistra.

Alcune manovre contengono un'etichetta aggiuntiva clockwise o counterclockwise, che l'SDK determina in base al lato di guida di un paese. Ad esempio, nei paesi in cui si guida sul lato sinistro della strada, i conducenti prendono una rotatoria o un'inversione a U in senso orario, mentre i paesi sul lato destro della strada vanno in senso orario. L'SDK Navigation rileva se una manovra si verifica nel traffico a sinistra o a destra e restituisce la manovra appropriata. Pertanto, l'icona della manovra potrebbe essere diversa per una manovra in senso orario rispetto a una in senso antiorario.

Espandi per visualizzare le icone di esempio per diverse manovre

Icona di esempio Manovre passo passo
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_RAMP_U_TURN_CLOCKWISE
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_RIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
ROUNDABOUT_STRAIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_LEFT_CLOCKWISE
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
ROUNDABOUT_U_TURN_CLOCKWISE
ROUNDABOUT_COUNTERCLOCKWISE
ROUNDABOUT_CLOCKWISE
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
ROUNDABOUT_EXIT_CLOCKWISE
MERGE_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_RAMP_KEEP_LEFT
MERGE_UNSPECIFIED
DESTINATION
DESTINATION_RIGHT
DESTINATION_LEFT
FERRY_BOAT
FERRY_TRAIN

Utilizzare le icone generate

Un piccolo elenco di icone generate fornite dall'SDK Navigation.

Per facilitare i casi d'uso di Android Auto, l'SDK Navigation supporta la generazione di icone di manovra e di indicazioni di corsia. Queste icone si adattano alle indicazioni relative alle dimensioni delle immagini della libreria di app per auto di Android Auto, che consiglia di scegliere un riquadro di delimitazione di 500 x 74 dp. Per i dettagli, consulta setsLaneImage e CarIcon nella documentazione di riferimento di Android.

Esempio di generazione di icone

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

Dopo aver abilitato la generazione delle icone, l'oggetto StepInfo di TurnbyTurn compila i campi maneuverBitmap e lanesBitmap con le icone.

Passaggi successivi