Detalhes sobre o feed de dados de navegação guiada

Um feed de dados de navegação guiada fornece informações apenas de navegação para dispositivos não projetados para orientação de navegação baseada em mapas. Ele fornece as próximas manobras com os elementos que você fornece:

  • ícones (esquerda, direita, retorno)
  • números de voltas em rotatórias
  • nomes de ruas
  • distâncias e tempo estimados para a próxima etapa de navegação ou destino final

Você pode usar o feed de navegação guiada para criar experiências em que a interface completa do SDK do Navigation não é adequada, como para telas pequenas. Por exemplo, você pode usar isso para motociclistas, em que é possível projetar orientações apenas de navegação para ajudar os usuários a chegar aos destinos com mais rapidez e confiança, com o mínimo de distrações.

Elementos essenciais de exibição de navegação

Uma tela de dispositivo móvel que mostra uma próxima curva à direita a 15 metros na Rua da Igreja. Na parte de baixo da tela, o tempo restante até o destino é de 13 minutos, e a distância restante é de 3,3 km.

Os campos principais de cada etapa de navegação são o nome completo da rua, a manobra e a distância total da etapa, que estão disponíveis em GMSNavigationStepInfo.

Para a viagem geral, talvez você queira mostrar o tempo e a distância restantes até a etapa atual ou o destino, que estão disponíveis em GMSNavigationNavInfo. A imagem à direita mostra um exemplo desses elementos essenciais de navegação.

Configurar um listener de eventos

Para usar dados apenas de navegação, é necessário implementar um listener de eventos para o evento didChangeNavInfo. No listener de eventos, acesse as informações da viagem e da etapa para fornecer navegação guiada aos usuários.

Para implementar processadores de eventos, o controlador de visualização do mapa precisa implementar o GMSNavigatorListener protocolo. Para informações detalhadas sobre como processar eventos no SDK do Navigation para iOS, consulte Detectar eventos de navegação.

Como processar o evento didChangeNavInfo

Crie um listener para o evento didChangeNavInfo para adicionar suporte de navegação guiada ao seu app. No listener de eventos, use as seguintes classes e enumerações para controlar a navegação guiada:

  • GMSNavigationNavInfo : classe que define informações sobre o estado da navegação.

  • GMSNavigationStepInfo : classe que define informações sobre uma única etapa em uma rota de navegação.

  • GMSNavigationNavState : enumeração que define o estado atual de uma navegação, como em rota, redirecionamento ou parada.

  • GMSNavigationDrivingSide : enumeração que define se essa etapa está em uma rota de direção à direita ou à esquerda.

  • GMSNavigationManeuver : enumeração que define a ação de navegação a ser realizada, como virar à esquerda ou à direita.

Confira abaixo exemplos de listeners de eventos para o 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;
        ...
      }
    }
    ...
  }

Use a propriedade navState de GMSNavigationNavInfo para receber o estado atual da navegação, que é um dos seguintes:

  • Em rota : o estado GMSNavigationNavStateEnroute significa que a navegação guiada está ativa e o usuário está na rota fornecida. As informações sobre a etapa de manobra atual estão disponíveis.

  • Redirecionamento : GMSNavigationNavStateRerouting significa que a navegação está em andamento, mas o navegador está procurando uma nova rota. A próxima etapa de manobra não está disponível porque ainda não há uma nova rota.

  • Parado : GMSNavigationNavStateStopped significa que a navegação terminou. Por exemplo, a navegação para quando o usuário sai da navegação no app. No app de exemplo, um estado GMSNavigationNavStateStopped limpa a tela de informações de navegação para evitar que as instruções de etapa restantes sejam exibidas.

Indicação de faixa

O SDK do Navigation representa as faixas no card de navegação como GMSNavigationLane e GMSNavigationLaneDirection objetos de dados. Um GMSNavigationLane objeto representa uma faixa específica durante a navegação e tem uma lista de GMSNavigationLaneDirection objetos que descrevem todas as curvas que podem ser feitas nessa faixa.

A direção recomendada que um motorista deve seguir em uma faixa é marcada usando o campo recommended.

Exemplo de indicação de faixa

O snippet a seguir ilustra a representação de dados das faixas mostradas na captura de tela anterior.

// 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}]

Imagens de indicação de faixa

O SDK do Navigation oferece suporte à geração de imagens de faixa para cada etapa de navegação, conforme transmitido por GMSNavigationStepInfo. Esses ícones se ajustam às orientações de dimensionamento de imagens do 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];

Como criar ícones para manobras

Ícone de uma manobra

A GMSNavigationManeuver enumeração define cada manobra possível que pode ocorrer durante a navegação, e você pode receber a manobra de uma determinada etapa da propriedade maneuver de GMSNavigationStepInfo.

É necessário criar ícones de manobra e pareá-los com as manobras associadas. Para algumas manobras, é possível configurar um mapeamento individual para um ícone, como GMSNavigationManeuverDestinationLeft e GMSNavigationManeuverDestinationRight. No entanto, como algumas manobras compartilham características com outras, talvez você queira mapear mais de uma manobra para um único ícone. Por exemplo, GMSNavigationManeuverTurnLeft e GMSNavigationManeuverOnRampLeft podem ser mapeados para o ícone de curva à esquerda.

Algumas manobras contêm um rótulo adicional "Sentido horário" ou "Sentido anti-horário", que o SDK determina com base no lado de direção de um país. Por exemplo, em países em que a direção é no lado esquerdo da estrada, os motoristas fazem uma rotatória ou um retorno no sentido horário, enquanto os países do lado direito da estrada vão no sentido anti-horário. O SDK do Navigation detecta se uma manobra ocorre no trânsito do lado esquerdo ou direito e gera a manobra apropriada. Portanto, o ícone de manobra pode ser diferente para uma manobra no sentido horário e no sentido anti-horário.

Abrir para conferir exemplos de ícones para diferentes manobras

Ícone de exemplo Manobras de navegação guiada
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

Usar ícones gerados

O SDK do Navigation oferece suporte à geração de ícones de manobra para um determinado GMSNavigationStepInfo. Esses ícones se ajustam às orientações de dimensionamento de imagens do 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];