Attiva il feed di dati passo passo

Un feed di dati passo passo fornisce informazioni di sola navigazione ai dispositivi che non progettato per indicazioni di navigazione basate sulla mappa. Fornisce manovre future con gli elementi che fornisci:

  • icone (sinistra, destra, inversione a U)
  • indica i numeri delle rotatorie
  • nomi di strade
  • distanze stimate e tempo per il passaggio successivo o finale di navigazione destinazione

Puoi utilizzare il feed passo passo per creare esperienze in cui L'interfaccia utente dell'SDK di navigazione non è appropriata, ad esempio per Android Auto o per piccole se non è disponibile uno stack Android completo. Ad esempio, potrebbe essere usata per i conducenti di veicoli a due ruote, per cui puoi indicazioni solo per la navigazione per raggiungere le destinazioni più velocemente e più facilmente in sicurezza con il minimo di distrazioni.

Per utilizzare l'SDK, dovrai creare un servizio e registrarlo con il SDK di navigazione per Android per 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

In questa sezione viene descritto come aggiungere la libreria TurnByTurn ai progetti. riassume il flusso generale per la creazione di funzionalità passo passo.

Per utilizzare una versione autonoma della libreria TurnByTurn, segui questi passaggi:

  1. Configura il tuo ambiente per accedere al Repository Maven host:

    Maven

    Aggiungi quanto segue al tuo file pom.xml:

        <project>
          ...
          <repositories>
            <repository>
              <id>google-maven-repository</id>
              <url>https://maven.google.com</url>
            </repository>
          </repositories>
          ...
        </project>
        
        

    Gradle

    Aggiungi quanto segue al tuo file build.gradle:

    repositories {
        ...
        google()
    }
        
  2. Aggiungi la seguente dipendenza alla configurazione Maven o Gradle:
  3. Maven

    <dependencies>
    ...
    <dependency>
          <groupId>com.google.android.maps</groupId>
          <artifactId>google_turnbyturn</artifactId>
          <version>1.0.0</version>
    </dependency>
    </dependencies>
        
        

    Gradle

    dependencies {
      ...
      implementation 'com.google.android.maps:google_turnbyturn:1.0.0'
    }
        

Aggiungi la libreria TurnByTurn al tuo progetto utilizzando un file JAR scaricato (alternativa)

La libreria TurnByTurn è disponibile come file JAR in questa cartella SDK. Se non hai accesso, contatta il tuo rappresentante.

  1. Scarica e decomprimi google_turnbyturn_*.jar.
  2. Copia il file JAR scaricato nella directory app/libs del progetto.
  3. Aggiungi quanto segue a build.gradle per includere il JAR nella build.

    dependencies {
       ...
       api fileTree(include: ['*.jar'], dir: 'libs')
    }
    

Utilizzo della libreria TurnByTurn

Di seguito è riportata la procedura generale per attivare la funzionalità passo passo. La le sezioni seguenti forniscono dettagli su ogni passaggio.

  1. Crea un servizio per ricevere aggiornamenti sulla navigazione.

  2. Registra il servizio.

  3. Informazioni sugli stati di navigazione.

  4. Guarda un esempio di visualizzazione della navigazione che mostra elementi essenziali.

Crea un servizio per ricevere aggiornamenti sulla navigazione

L'SDK di navigazione si associa al servizio TurnByTurn e e invia aggiornamenti di navigazione tramite il Messaggistica di Google. Puoi creare un nuovo servizio di navigazione per questi aggiornamenti o utilizzare una completamente gestito di Google Cloud.

Il vantaggio di usare un servizio per ricevere aggiornamenti di navigazione è che il servizio possono trovarsi 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

NavInfo messaggi possono essere identificati tramite Message.what campo della classe Message, che è impostata sul valore TurnByTurnManager.MSG_NAV_INFO.

Registrazione del 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);

Avvio e arresto del servizio

Il servizio di navigazione è attivo fintanto che L'SDK di navigazione si associa a questo elemento. Puoi chiamare manualmente startService() e stopService() per controllare la durata del servizio di navigazione ma quando registri il tuo servizio con l'SDK di navigazione, il servizio si avvia automaticamente si interrompe solo quando annulli la registrazione. A seconda di come configuri l'app, puoi: prendere in considerazione l'avvio di un servizio in primo piano, descritto nel documentazione Servizi Panoramica.

Annullamento della registrazione del servizio

Per non ricevere più aggiornamenti sulla navigazione, annulla la registrazione del servizio dal SDK di navigazione.

navigator.unregisterServiceForNavUpdates();

Informazioni sugli stati della navigazione

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

  • Percorso: lo stato ENROUTE indica che la navigazione guidata è attualmente sia attiva e l'utente si trova sul percorso specificato. Informazioni sullo stato attuale passaggio di manovra successivo disponibile.

  • Cambio percorso: REROUTING significa che la navigazione è in corso, ma il navigatore sta cercando un nuovo percorso. Il passaggio successivo della manovra perché non è ancora disponibile un nuovo percorso. Nell'app di esempio, viene visualizzato un messaggio di "Reindirizzamento..." il messaggio appare in la visualizzazione delle informazioni di navigazione. Una volta trovata una route, viene visualizzato un messaggio NavInfo inviato con lo stato ENROUTE.

  • Arrestato: STOPPED significa che la navigazione è terminata. Ad esempio, la navigazione si interrompe quando l'utente esce dalla navigazione nell'app. Nell'app di esempio, Lo stato STOPPED cancella la visualizzazione delle informazioni di navigazione per evitare un passo prolungato istruzioni.

Compila la visualizzazione del feed

Ora che hai configurato il servizio passo passo, in questa sezione vengono spiegate le elementi visivi e di testo che puoi utilizzare per completare le schede informative per il feed passo passo.

Lo schermo di un dispositivo mobile che mostra l&#39;imminente svolta a sinistra di 30 metri verso W Ahwanee
Lungo. In fondo allo schermo, il tempo restante per arrivare alla destinazione è 46 minuti,
e la distanza rimanente è 39
chilometri.

Quando l'utente accede alla navigazione guidata, appare una scheda di navigazione in alto, contenente dati di navigazione compilati SDK di navigazione. L'immagine correlata mostra un esempio questi elementi essenziali di navigazione.

Questa tabella mostra i campi delle informazioni di navigazione e la posizione in cui puoi trovarli.

Campi per ogni passaggio di navigazione Campi relativi alla corsa complessiva
Trovato in StepInfo Trovato in NavInfo
Nome completo della strada Tempo rimanente
L'icona della manovra Distanza dalla destinazione
Distanza dal passaggio successivo
Campi dell'indicazione delle corsie in cui posizionarsi

Indicazione delle corsie in cui posizionarsi

L'SDK di navigazione rappresenta le corsie della navigazione. gira carta come Corsia e LaneDirection di oggetti dati. Un oggetto Lane rappresenta una corsia specifica durante la navigazione e include un elenco di LaneDirection oggetti che descrivono tutte le svolte da questa corsia.

Esempio di indicazione delle corsie in cui posizionarsi
configurazione.

La direzione consigliata che un utente deve seguire in una corsia è indicata dal isRecommended .

Esempio di indicazione delle corsie in cui posizionarsi

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

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

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

Crea icone per le manovre

La Maneuver enum definisce ogni possibile manovra che potrebbe verificarsi durante la navigazione può ottenere la manovra per un determinato passaggio dal metodo StepInfo.getManeuver().

Devi creare le icone delle manovre e accoppiarle alle manovre associate. Per alcune manovre, puoi configurare una mappatura one-to-one su un'icona, come DESTINATION_LEFT e DESTINATION_RIGHT. Tuttavia, poiché alcune manovre in modo simile, potresti voler mappare più manovre a una singola icona. Per Ad esempio, TURN_LEFT e ON_RAMP_LEFT possono essere mappati sull'icona di svolta a sinistra.

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

Espandi per visualizzare esempi di icone di 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

Utilizza icone generate

Un piccolo elenco di icone generate fornite dalla piattaforma di navigazione
l&#39;SDK.

Per agevolare i casi d'uso di Android Auto, L'SDK di navigazione supporta la generazione di manovre e corsie icone delle indicazioni. Queste icone corrispondono alle indicazioni sulle dimensioni delle immagini di Android Auto Libreria di app per auto che consiglia come target un riquadro di delimitazione di 500 x 74 dp. Consulta: setsLaneImage e CarIcon nella documentazione di riferimento di Android per maggiori dettagli.

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 TurnbyTurn StepInfo compila la Campi maneuverBitmap e lanesBitmap con le rispettive icone.

Passaggi successivi