Dettagli sul feed di dati passo passo

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

  • Icone (sinistra, destra, inversione a U)
  • numeri di svolta nelle rotatorie
  • Nomi di strade
  • Distanze e tempi stimati per il passaggio di navigazione successivo 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 i display di piccole dimensioni. Ad esempio, potresti utilizzarla per i conducenti di veicoli a due ruote, per i quali puoi proiettare indicazioni di sola navigazione per aiutarli a raggiungere le loro destinazioni in modo più rapido e sicuro con distrazioni minime.

Elementi di visualizzazione della navigazione essenziali

Una schermata mobile che mostra una svolta a destra tra 15 metri su Church Street. Nella parte inferiore dello schermo, il tempo rimanente per raggiungere la destinazione è di 13 minuti e la distanza rimanente è di 2, 1 miglia.

I campi principali per ogni passaggio di navigazione sono il nome completo della strada, la manovra e la distanza totale del passaggio, disponibili in GMSNavigationStepInfo.

Per l'intero percorso, potresti voler visualizzare il tempo e la distanza rimanenti fino al passaggio corrente o alla destinazione, tutti disponibili in GMSNavigationNavInfo. L'immagine a destra mostra un esempio di questi elementi di navigazione essenziali.

Configura un listener di eventi

Per utilizzare i dati di sola navigazione, devi implementare un listener di eventi per l'evento didChangeNavInfo. All'interno del listener di eventi, accedi alle informazioni sul percorso e sui passaggi per fornire agli utenti la navigazione passo passo.

Per implementare i gestori di eventi, il controller di visualizzazione della mappa deve implementare il protocollo GMSNavigatorListener. Per informazioni dettagliate sulla gestione degli eventi in Navigation SDK per iOS, consulta Ascolta gli eventi di navigazione.

Gestione dell'evento didChangeNavInfo

Crea un listener per l'evento didChangeNavInfo per aggiungere il supporto della navigazione passo passo alla tua app. Nel listener di eventi, utilizza le seguenti classi ed enum per controllare la navigazione passo passo:

  • GMSNavigationNavInfo : classe che definisce le informazioni sullo stato della navigazione.

  • GMSNavigationStepInfo : classe che definisce le informazioni su un singolo passaggio lungo un percorso di navigazione.

  • GMSNavigationNavState : enum che definisce lo stato attuale di una navigazione, ad esempio in viaggio, cambio percorso o interrotta.

  • GMSNavigationDrivingSide : enum che definisce se questo passaggio si trova su un percorso con guida a destra o a sinistra.

  • GMSNavigationManeuver : enum che definisce l'azione di navigazione da intraprendere, ad esempio svolta a sinistra o svolta a destra.

Di seguito sono riportati esempi di listener di eventi per l'evento didChangeNavInfo:

Swift

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

Objective-C

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

Utilizza la proprietà navState di GMSNavigationNavInfo per ottenere lo stato attuale della navigazione, che è uno dei seguenti:

  • In viaggio: lo stato GMSNavigationNavStateEnroute indica che la navigazione guidata è attiva e l'utente sta seguendo il percorso fornito. Sono disponibili informazioni sul passaggio della manovra imminente corrente.

  • Cambio percorso - GMSNavigationNavStateRerouting indica che la navigazione è in corso, ma il navigatore sta cercando un nuovo percorso. Il passaggio della manovra imminente non è disponibile perché non esiste ancora un nuovo percorso.

  • Interrotta - GMSNavigationNavStateStopped 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 GMSNavigationNavStateStopped cancella la visualizzazione delle informazioni di navigazione per impedire la visualizzazione di istruzioni di passaggio persistenti.

Indicazioni sulle corsie in cui posizionarsi

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

La direzione consigliata che un conducente deve seguire in una corsia è contrassegnata utilizzando il campo recommended.

Esempio di indicazione delle corsie in cui posizionarsi

Lo snippet seguente illustra la rappresentazione dei dati delle corsie visualizzate nello screenshot precedente.

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

Immagini delle indicazioni di corsia

L'SDK Navigation supporta la generazione di immagini delle corsie per ogni passaggio di navigazione, come indicato da GMSNavigationStepInfo. Queste icone sono conformi alle linee guida per il dimensionamento delle immagini di CarPlay.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

Creazione di icone per le manovre

Icona di una manovra

L'enum GMSNavigationManeuver definisce ogni possibile manovra che potrebbe verificarsi durante la navigazione e puoi ottenere la manovra per un determinato passaggio dalla proprietà maneuver di GMSNavigationStepInfo.

Devi creare icone di manovra e associarle alle manovre corrispondenti. Per alcune manovre, puoi configurare una mappatura uno a uno con un'icona, ad esempio GMSNavigationManeuverDestinationLeft e GMSNavigationManeuverDestinationRight. Tuttavia, poiché alcune manovre condividono caratteristiche con altre, potresti voler mappare più di una manovra a una singola icona. Ad esempio, GMSNavigationManeuverTurnLeft e GMSNavigationManeuverOnRampLeft potrebbero essere mappati entrambi all'icona di svolta a sinistra.

Alcune manovre contengono un'etichetta aggiuntiva "In senso orario" o "In senso antiorario", 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 percorrono una rotatoria o un'inversione a U in senso orario, mentre nei paesi in cui si guida sul lato destro della strada, la percorrono in senso antiorario. L'SDK Navigation rileva se una manovra avviene nel traffico a sinistra o a destra e genera 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 le 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 le icone generate

L'SDK Navigation supporta la generazione di icone di manovra per un determinato GMSNavigationStepInfo. Queste icone sono conformi alle indicazioni per il dimensionamento delle immagini di CarPlay.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];