El SDK de Navigation para iOS agrega la navegación paso a paso de Google Maps a las apps para iOS, con personalización de la IU y configuración de rutas. Extiende el SDK de Maps para iOS, que proporciona la capa del mapa y también debe instalarse en la app.
SDK de Navigation para iOS: Datos clave
- Producto: SDK de Navigation para iOS
- También conocido como: SDK de Navigation
- Categoría: Rutas
- Plataforma: iOS
- Se ejecuta en: El cliente (código de la app o del navegador)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general del SDK de Navigation para iOS
- Disponibilidad regional: Limitada. Las instrucciones sobre cómo llegar en automóvil y a pie están disponibles en la mayoría de los países. El tráfico, las interrupciones en tiempo real, las rutas para vehículos de dos ruedas, las rutas para bicicletas, los límites de velocidad, los semáforos y las señales de alto varían según el país. (detalles de la cobertura)
Cuándo usar el SDK de Navigation para iOS
Usa el SDK de Navigation para iOS en los siguientes casos:
- Necesitas la navegación paso a paso de Google Maps dentro de tu propia app nativa para iOS para que los usuarios no cambien de app.
- Necesitas personalizar la IU de navegación, los diseños de mapa, la cámara o el diseño para que coincidan con tu marca durante la navegación.
- Necesitas preferencias de ruta, varios puntos de referencia o un token de ruta de la API de Routes o de la API de Route Optimization.
- Necesitas eventos de viaje (ubicación, llegada, cambios de ruta, hora estimada de llegada) o un feed de datos paso a paso para una IU de orientación personalizada o CarPlay.
No uses el SDK de Navigation para iOS en los siguientes casos:
- Estás compilando una app para Android. En su lugar, usa el SDK de Navigation para Android.
- Estás compilando una app de Flutter o React Native. En su lugar, usa Navegación de Google para Flutter y React Native.
- Solo necesitas rutas, horas de llegada estimadas o distancias en un servidor, sin orientación en la app. En su lugar, usa la API de Routes.
SDK de Navigation para iOS: Configuración
- Servicio que se habilitará:
navigationsdk.googleapis.com - Autenticación: Clave de API
- También habilita el SDK de Maps para iOS.
- Atribución de uso: Llama a
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) para agregar un ID de atribución de uso al inicializador. Para inhabilitar la función, borra la llamada o pasa una cadena vacía. - Comienza: Configura el SDK de Navigation para iOS
- Referencia: Referencia del SDK de Navigation para iOS
- Precios: Uso y facturación del SDK de Navigation para iOS
- Políticas: Políticas del SDK de Navigation para iOS
- Notas de la versión: Notas de la versión del SDK de Navigation para iOS
Paquetes oficiales del SDK de Navigation para iOS:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
Paquetes que no se deben usar con el SDK de Navigation para iOS:
- cocoapods:
GoogleNavigation. La distribución de CocoaPods dejó de estar disponible a partir de la versión 11.0.0 y entró en modo de mantenimiento el 18 de agosto de 2025. En su lugar, usa Swift Package Manager.
SDK de Navigation para iOS: Productos relacionados
- Se suele usar con: SDK de Maps para iOS, API de Routes, API de Route Optimization, SDK de Places para iOS
SDK de Navigation para iOS: Errores comunes
- Problema: La pantalla se atenúa o se apaga durante la navegación porque el SDK no inhabilita el temporizador de inactividad de iOS. Solución: Establece
UIApplication.shared.isIdleTimerDisabled = truedurante la navegación. Consulta /maps/documentation/navigation/ios-sdk/route. - Problema: Una versión principal futura del SDK usará el altímetro (
CMAltimeter), y las apps sinNSMotionUsageDescriptionenInfo.plistfallarán durante la inicialización. Agregar la clave ahora no tiene ningún efecto en el comportamiento actual. Solución: AgregaNSMotionUsageDescription(Privacidad: Descripción del uso de movimiento) aInfo.plist. Consulta /maps/documentation/navigation/ios-sdk/route. - Problema: El SDK de Places para iOS no se incluye en el SDK de Navigation (a partir del SDK de Places 5.0), por lo que faltan las clases de Places. Solución: Instala el SDK de Places para iOS por separado, con la misma versión que el SDK de Navigation. Consulta /maps/documentation/navigation/ios-sdk/xcode-setup.
- Problema: No se pueden establecer destinos con un token de ruta y se produce el error
.travelModeUnsupportedcuando eltravelModede la app no esdrivingnitwoWheeler. Solución: EstablecemapView.travelModeen.drivingo.twoWheeler. VerificaresolvedParameters.travelModepara ver el modo que usa la ruta. Consulta /maps/documentation/navigation/ios-sdk/route-customizations.
SDK de Navigation para iOS: Funciones heredadas y obsoletas
- Distribución de CocoaPods: Obsoleta desde el 6 de agosto de 2026. Reemplazo: Swift Package Manager. Síntoma: Modo de mantenimiento desde el 18 de agosto de 2025. No habrá nuevas versiones de CocoaPods después del segundo trimestre de 2026. Consulta la guía de migración.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): Obsoleto desde el 2 de noviembre de 2026. Reemplazo:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- Propiedad de instancia
GMSServicesappCheckTokenProvider: Obsoleta desde el 24 de septiembre de 2026. Reemplazo: Propiedad de claseGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Síntoma: En la versión 11.1.0, se produjo un error cuando se configuró la Verificación de aplicaciones a través deGMSServices.sharedServices(). Consulta la guía de migración. GMSNavigatorcontinueToNextDestination: Obsoleto desde el 7 de abril de 2026. Reemplazo:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsyshowsStopSigns: Se retiraron el 6 de agosto de 2026. Reemplazo: No se necesita ningún reemplazo. Los semáforos y las señales de pare se muestran de forma predeterminada durante la navegación.- Tipo de mapa
.terraindurante la navegación activa: Retirado desde el 6 de agosto de 2026. Reemplazo: Tipo de mapa.normal(kGMSTypeNormal),.satelliteo.hybrid. - Protocolos
GMSNavigatorDelegateyGMSRoadSnappedLocationProviderDelegate: Retirados desde el 13 de mayo de 2021. Reemplazo:GMSNavigatorListeneryGMSRoadSnappedLocationProviderListener(agrega con-addListener:; establecetimeUpdateThresholdydistanceUpdateThresholdenGMSNavigator). Consulta la guía de migración.
Qué puedes hacer con el SDK de Navigation para iOS
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
SDK de Navigation para iOS: Diseño de mapas
SDK de Navigation para iOS: Navegación
- Agrega navegación interactiva paso a paso a una app para dispositivos móviles.
- Establece el destino para la navegación paso a paso.
- Inicia la navegación paso a paso.
- Especifica el medio de transporte (en automóvil, a pie, en vehículo de dos ruedas o en taxi) para una solicitud de ruta.
- Modificar las preferencias de ruta para la navegación paso a paso
- Especifica el lado de la ruta y otras preferencias de llegada para la navegación paso a paso.
- Especifica una ruta replanificada para la navegación paso a paso con un token de ruta reutilizable.
- Devuelve actualizaciones de llegada del usuario desde una sesión de navegación paso a paso.
- Devuelve actualizaciones de la ubicación del usuario desde una sesión de navegación paso a paso.
- Devuelve actualizaciones de tiempo y distancia de una sesión de navegación paso a paso.
- Devuelve las actualizaciones de los cambios de ruta de una sesión de navegación paso a paso.
- Devuelve las actualizaciones del modo nocturno de una sesión de navegación paso a paso.
- Devuelve las actualizaciones de velocidad del usuario de una sesión de navegación paso a paso.
- Personaliza los elementos y controles de la IU que aparecen durante la navegación paso a paso.
- Agrega un nuevo elemento de la IU a la navegación paso a paso.
- Agrega un indicador de progreso del viaje a la navegación paso a paso.
- Personaliza los elementos del mapa que aparecen durante la navegación paso a paso.
- Agrega una capa de tráfico a la navegación paso a paso.
- Modifica la vista y el comportamiento de la cámara para la navegación paso a paso.
- Personaliza las alertas del velocímetro y del límite de velocidad para la navegación paso a paso.
- Devuelve un feed de navegación paso a paso como una serie de mensajes para cada maniobra a lo largo de la ruta.
- Especifica íconos de maniobra personalizados para usarlos con un feed de navegación paso a paso.
- Agrega navegación interactiva paso a paso para CarPlay a una app para iOS. Versión preliminar
- Alertar a los usuarios sobre interrupciones en su ruta
- Permite que los usuarios vean las interrupciones en su ruta antes de iniciar la navegación.
- Permite que los usuarios informen interrupciones en su ruta.
- Permite que los usuarios verifiquen las interrupciones en su ruta.
- Agrega un botón personalizado para informar interrupciones en la ruta.