Referência rápida do SDK do Navigation para iOS

O SDK Navigation para iOS adiciona a navegação guiada do Google Maps a apps iOS, com personalização da interface e configuração de trajeto. Ela estende o SDK do Maps para iOS, que fornece a camada do mapa e também precisa ser instalado no app.

SDK do Navigation para iOS: informações importantes

  • Produto: SDK Navigation para iOS
  • Também conhecido como: SDK do Navigation
  • Categoria: rotas
  • Plataforma: iOS
  • Executado em: cliente (código do app ou do navegador)
  • Estágio de lançamento: GA
  • Ciclo de vida: Ativo
  • Visão geral: Visão geral do SDK de Navigation para iOS
  • Disponibilidade regional: limitada. As rotas de carro e a pé estão disponíveis na maioria dos países. O trânsito, as interrupções em tempo real, as rotas para veículos de duas rodas, as rotas de bicicleta, os limites de velocidade, os semáforos e as placas de parada variam de acordo com o país. (detalhes da cobertura)

SDK do Navigation para iOS: quando usar

Use o SDK do Navigation para iOS quando:

  • Você precisa da navegação guiada do Google Maps no seu app iOS nativo para que os usuários não precisem trocar de app.
  • Você precisa personalizar a interface de navegação, os estilos de mapa, a câmera ou o layout para combinar com sua marca durante a orientação.
  • Você precisa de preferências de trajeto, vários waypoints ou um token de trajeto da API Routes ou da API Route Optimization.
  • Você precisa de eventos de viagem (local, chegada, mudanças de trajeto, HEC) ou de um feed de dados de navegação guiada para uma interface de orientação personalizada ou o CarPlay.

Não use o SDK do Navigation para iOS quando:

SDK do Navigation para iOS: configuração

Pacotes oficiais do SDK do Navigation para iOS:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

Pacotes que não devem ser usados com o SDK de Navigation para iOS:

  • cocoapods: GoogleNavigation. A distribuição do CocoaPods foi descontinuada a partir da versão 11.0.0 e entrou no modo de manutenção em 18/08/2025. Use o Gerenciador de Pacotes do Swift.

SDK do Navigation para iOS: erros comuns

  • Problema: a tela escurece ou desliga durante a navegação porque o SDK não desativa o timer de inatividade do iOS. Correção: defina UIApplication.shared.isIdleTimerDisabled = true durante a navegação. Consulte /maps/documentation/navigation/ios-sdk/route.
  • Problema: uma versão principal futura do SDK vai usar o altímetro (CMAltimeter), e os apps sem NSMotionUsageDescription em Info.plist vão falhar na inicialização. Adicionar a chave agora não afeta o comportamento atual. Correção: adicione NSMotionUsageDescription (Privacy - Motion Usage Description) a Info.plist. Consulte /maps/documentation/navigation/ios-sdk/route.
  • Problema: o SDK do Places para iOS não está incluído no SDK do Navigation (a partir do SDK do Places 5.0). Por isso, as classes do Places estão ausentes. Correção: instale o SDK do Places para iOS separadamente, usando a mesma versão do SDK do Navigation. Consulte /maps/documentation/navigation/ios-sdk/xcode-setup.
  • Problema: a definição de destinos com um token de trajeto falha com .travelModeUnsupported quando o travelMode do app não é driving ou twoWheeler. Correção: defina mapView.travelMode como .driving ou .twoWheeler. Verifique resolvedParameters.travelMode para conferir o modo usado pela rota. Consulte /maps/documentation/navigation/ios-sdk/route-customizations.

SDK Navigation para iOS: recursos legados e descontinuados

  • Distribuição do CocoaPods: descontinuada desde 06/08/2026. Substituição: Gerenciador de pacotes do Swift. Sintoma: modo de manutenção desde 18/08/2025. Não haverá novas versões do CocoaPods após o segundo trimestre de 2026. Consulte o guia de migração.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): descontinuado desde 02/11/2026. Substituição: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • Propriedade da instância GMSServices appCheckTokenProvider: descontinuada desde 24/09/2026. Substituição: propriedade de classe GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Sintoma: na versão 11.1.0, a configuração do App Check por meio de GMSServices.sharedServices() falhou. Consulte o guia de migração.
  • GMSNavigator continueToNextDestination: descontinuado desde 07/04/2026. Substituição: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights e showsStopSigns: desativados desde 06/08/2026. Substituição: nenhuma substituição é necessária. Os semáforos e as placas de parada são mostrados por padrão durante a navegação.
  • Tipo de mapa .terrain durante a navegação ativa: desativado desde 06/08/2026. Substituição: tipo de mapa .normal (kGMSTypeNormal), .satellite ou .hybrid.
  • Protocolos GMSNavigatorDelegate e GMSRoadSnappedLocationProviderDelegate: desativados desde 13/05/2021. Substituição: GMSNavigatorListener e GMSRoadSnappedLocationProviderListener (adicione com -addListener:; defina timeUpdateThreshold e distanceUpdateThreshold em GMSNavigator). Consulte o guia de migração.

O que você pode fazer com o SDK Navigation para iOS

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.

SDK do Navigation para iOS: estilo de mapas

SDK do Navigation para iOS: navegação