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:
- Você está criando um app Android. Use o SDK do Navigation para Android.
- Você está criando um app Flutter ou React Native. Use o Google Navigation para Flutter e React Native.
- Você só precisa de rotas, ETAs ou distâncias em um servidor, sem orientação no app. Use a API Routes.
SDK do Navigation para iOS: configuração
- Serviço a ser ativado:
navigationsdk.googleapis.com - Autenticação: chave de API
- Ative também: SDK do Maps para iOS
- Atribuição de uso: chame
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) para adicionar um ID de atribuição de uso ao inicializador. Para desativar, exclua a chamada ou transmita uma string vazia. - Começar: configurar o SDK do Navigation para iOS
- Referência: referência do SDK do Navigation para iOS
- Preços: uso e faturamento do SDK de Navigation para iOS
- Políticas: políticas do SDK de Navigation para iOS
- Notas da versão: notas da versão do SDK de Navigation para iOS
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: produtos relacionados
- Costuma ser usada com: SDK do Maps para iOS, API Routes, API Route Optimization, SDK do Places para iOS
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 = truedurante 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 semNSMotionUsageDescriptionemInfo.plistvão falhar na inicialização. Adicionar a chave agora não afeta o comportamento atual. Correção: adicioneNSMotionUsageDescription(Privacy - Motion Usage Description) aInfo.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
.travelModeUnsupportedquando otravelModedo app não édrivingoutwoWheeler. Correção: definamapView.travelModecomo.drivingou.twoWheeler. VerifiqueresolvedParameters.travelModepara 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.
GMSNavigatorsetDestinations: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
GMSServicesappCheckTokenProvider: descontinuada desde 24/09/2026. Substituição: propriedade de classeGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Sintoma: na versão 11.1.0, a configuração do App Check por meio deGMSServices.sharedServices()falhou. Consulte o guia de migração. GMSNavigatorcontinueToNextDestination: descontinuado desde 07/04/2026. Substituição:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightseshowsStopSigns: 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
.terraindurante a navegação ativa: desativado desde 06/08/2026. Substituição: tipo de mapa.normal(kGMSTypeNormal),.satelliteou.hybrid. - Protocolos
GMSNavigatorDelegateeGMSRoadSnappedLocationProviderDelegate: desativados desde 13/05/2021. Substituição:GMSNavigatorListenereGMSRoadSnappedLocationProviderListener(adicione com-addListener:; definatimeUpdateThresholdedistanceUpdateThresholdemGMSNavigator). 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
- Adicione navegação guiada interativa a um app para dispositivos móveis.
- Defina o destino para a navegação guiada.
- Inicie o trajeto para usar a navegação guiada.
- Especifique o meio de transporte (carro, a pé, veículo de duas rodas, táxi) para uma solicitação de trajeto.
- Modificar as preferências de trajeto para a navegação guiada.
- Especifique o lado da via e outras preferências de chegada para a navegação guiada.
- Especifique um trajeto replanejado para navegação guiada com um token de trajeto reutilizável.
- Retornar atualizações de chegada do usuário de uma sessão de navegação guiada.
- Retornar atualizações de localização do usuário de uma sessão de navegação guiada.
- Retornar atualizações de tempo e distância de uma sessão de navegação guiada.
- Retornar atualizações de mudança de trajeto de uma sessão de navegação guiada.
- Retornar atualizações do modo noturno de uma sessão de navegação guiada.
- Retornar atualizações de velocidade do usuário de uma sessão de navegação guiada.
- Personalize os elementos da interface e os controles que aparecem durante a navegação guiada.
- Adicionar um novo elemento da interface à navegação guiada.
- Adicione um indicador de progresso da viagem à navegação guiada.
- Personalize os recursos do mapa que aparecem durante a navegação guiada.
- Adicionar uma camada de trânsito à navegação guiada.
- Modifique a visualização e o comportamento da câmera para a navegação guiada.
- Personalize os alertas de velocímetro e limite de velocidade para a navegação guiada.
- Retorna um feed de navegação guiada como uma série de mensagens para cada manobra ao longo do trajeto.
- Especifique ícones de manobra personalizados para usar com um feed de navegação guiada.
- Adicione navegação guiada interativa para o CarPlay a um app iOS. Pré-lançamento
- Alertar os usuários sobre interrupções no trajeto.
- Permita que os usuários vejam as interrupções ao longo do trajeto antes de iniciar o trajeto.
- Permitir que os usuários informem interrupções no trajeto.
- Permitir que os usuários verifiquem interrupções ao longo do trajeto.
- Adicione um botão para informar interrupções em trajetos personalizados.