Referencia rápida del SDK de Maps para iOS

El SDK de Maps para iOS te permite agregar mapas basados en datos de Google Maps a apps para iOS. El SDK administra el acceso a los servidores de Google Maps, la visualización de los mapas y la respuesta a los gestos del usuario, y te permite agregar marcadores, polilíneas, superposiciones de suelo y ventanas de información al mapa.

SDK de Maps para iOS: Datos clave

  • Producto: SDK de Maps para iOS
  • También conocido como: SDK de Google Maps para iOS
  • Categoría: Maps
  • 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 Maps para iOS
  • Disponibilidad regional: Global. Consulta la página de cobertura de Google Maps Platform. Los vínculos de la página de uso y facturación separan las listas de precios globales y de India. (detalles de la cobertura)

Cuándo usar el SDK de Maps para iOS

Usa el SDK de Maps para iOS en los siguientes casos:

  • Necesitas un mapa de Google Maps interactivo con control de gestos dentro de una app para iOS nativa.
  • Necesitas agregar marcadores, polilíneas, superposiciones de suelo o ventanas de información a un mapa en una app para iOS.
  • Necesitas mostrar panorámicas de Street View dentro de una app para iOS.
  • Necesitas geocodificar de forma inversa coordenadas en direcciones desde una app para iOS que muestra un mapa.

No uses el SDK de Maps para iOS en los siguientes casos:

  • Necesitas mapas en 3D fotorrealistas en una app para iOS. En su lugar, usa el SDK de Maps 3D para iOS.
  • Solo necesitas abrir una ubicación o instrucciones sobre cómo llegar en la app de Google Maps en lugar de renderizar un mapa en tu app. En su lugar, usa las URLs de Maps.

SDK de Maps para iOS: Configuración

Paquetes oficiales del SDK de Maps para iOS:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

SDK de Maps para iOS: Errores comunes

  • Problema: El SDK no admite bibliotecas combinables. Habilitar la opción Build Mergeable Library en Xcode provoca fallas del vinculador en las compilaciones de lanzamiento. Solución: Mantén el parámetro de configuración Build Mergeable Library establecido en No (el valor predeterminado). Consulta /maps/documentation/ios-sdk/config.
  • Problema: Sin las entradas de LSApplicationQueriesSchemes, presionar el logotipo de Google en el mapa registra fallas de -canOpenURL para comgooglemaps:// y googlechromes://. Solución: Agrega googlechromes y comgooglemaps a LSApplicationQueriesSchemes en Info.plist. Consulta /maps/documentation/ios-sdk/config.
  • Problema: Es poco probable que el SDK funcione dentro de las extensiones de la app para iOS (por ejemplo, un teclado personalizado) debido a las estrictas restricciones de memoria. Solución: Usa el SDK en la app principal, no en las extensiones de la app. Consulta /maps/documentation/ios-sdk/overview.
  • Problema: El SDK no está optimizado para varias ventanas o instancias simultáneas de iPadOS 13 o versiones posteriores, y puede mostrar un comportamiento indefinido. Solución: Prueba con cuidado las situaciones de Multiventana en iPad o evita varias instancias de mapas simultáneas. Consulta /maps/documentation/ios-sdk/overview.

SDK de Maps para iOS: Funciones heredadas y obsoletas

  • Renderizador de OpenGL y setMetalRendererEnabled: Retirado desde el 19 de mayo de 2025. Reemplazo: Renderizador de Metal (predeterminado desde la versión 8.0.0); quita setMetalRendererEnabled. Symptom: Se dio de baja en la versión 9.0.0 (28 de mayo de 2024) y se quitó en la versión 10.0.0; GMSServices ya no incluye setMetalRendererEnabled:.
  • Módulo GoogleMapsM4B: Retirado desde el 19 de mayo de 2025. Reemplazo: Quita el pod o framework GoogleMapsM4B, ya que se relaciona con un plan de facturación obsoleto. Symptom: Se dio de baja el 20 de febrero de 2024; se quitó del paquete de Swift en la versión 9.0.0 y del SDK en la versión 10.0.0.
  • 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; obsoleto a partir de la versión 11.0.0. Consulta la guía de migración.
  • Instalación de Carthage: Obsoleta desde el 27 de junio de 2022. Reemplazo: Swift Package Manager. Síntoma: Carthage no admite bibliotecas orientadas a iOS 13 o versiones posteriores. La versión más reciente disponible a través de Carthage es la 6.2.1. Consulta la guía de migración.

Qué puedes hacer con el SDK de Maps para iOS

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.

SDK de Maps para iOS: Diseño basado en datos para límites

SDK de Maps para iOS: Diseño basado en datos para conjuntos de datos

SDK de Maps para iOS: Conjuntos de datos

SDK de Maps para iOS: Geocodificación

SDK de Maps para iOS: Maps

SDK de Maps para iOS: Anotaciones de mapas

SDK de Maps para iOS: Diseño de mapas

SDK de Maps para iOS: Street View