Referencia rápida del SDK de Navigation para iOS

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:

SDK de Navigation para iOS: Configuración

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: 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 = true durante 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 sin NSMotionUsageDescription en Info.plist fallarán durante la inicialización. Agregar la clave ahora no tiene ningún efecto en el comportamiento actual. Solución: Agrega NSMotionUsageDescription (Privacidad: Descripción del uso de movimiento) a Info.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 .travelModeUnsupported cuando el travelMode de la app no es driving ni twoWheeler. Solución: Establece mapView.travelMode en .driving o .twoWheeler. Verifica resolvedParameters.travelMode para 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.
  • GMSNavigator setDestinations: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 GMSServices appCheckTokenProvider: Obsoleta desde el 24 de septiembre de 2026. Reemplazo: Propiedad de clase GMSServices.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 de GMSServices.sharedServices(). Consulta la guía de migración.
  • GMSNavigator continueToNextDestination: Obsoleto desde el 7 de abril de 2026. Reemplazo: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights y showsStopSigns: 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 .terrain durante la navegación activa: Retirado desde el 6 de agosto de 2026. Reemplazo: Tipo de mapa .normal (kGMSTypeNormal), .satellite o .hybrid.
  • Protocolos GMSNavigatorDelegate y GMSRoadSnappedLocationProviderDelegate: Retirados desde el 13 de mayo de 2021. Reemplazo: GMSNavigatorListener y GMSRoadSnappedLocationProviderListener (agrega con -addListener:; establece timeUpdateThreshold y distanceUpdateThreshold en GMSNavigator). 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