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
- Servicio que se habilitará:
maps-ios-backend.googleapis.com - Autenticación: Clave de API
- Atribución de uso: Llama al método de clase
addInternalUsageAttributionID:deGMSServices(Swift: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 a usar el SDK de Maps para iOS: Configura el SDK de Maps para iOS
- Referencia: Referencia del SDK de Maps para iOS
- Precios: Uso y facturación del SDK de Maps para iOS
- Políticas: Políticas del SDK de Maps para iOS
- Notas de la versión: Notas de la versión del SDK de Maps para iOS
Paquetes oficiales del SDK de Maps para iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
SDK de Maps para iOS: productos relacionados
- Se suele usar con: API de Geocoding, SDK de Places para iOS
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-canOpenURLparacomgooglemaps://ygooglechromes://. Solución: AgregagooglechromesycomgooglemapsaLSApplicationQueriesSchemesenInfo.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); quitasetMetalRendererEnabled. 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;GMSServicesya no incluyesetMetalRendererEnabled:. - Módulo
GoogleMapsM4B: Retirado desde el 19 de mayo de 2025. Reemplazo: Quita el pod o frameworkGoogleMapsM4B, 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
- Cambiar el estilo de los límites en un mapa
- Responder a las interacciones de los usuarios con los límites en un mapa
- Agregar un diseño de coropletas a un mapa
SDK de Maps para iOS: Diseño basado en datos para conjuntos de datos
- Crear un conjunto de datos geoespaciales reutilizable y multiplataforma
- Agrega un conjunto de datos geoespaciales personalizado a un mapa.
- Cambiar el estilo de los elementos de un conjunto de datos personalizado en un mapa
- Responde a las interacciones de los usuarios con los componentes de conjuntos de datos personalizados en un mapa.
SDK de Maps para iOS: Conjuntos de datos
- Agrega una capa KML a un mapa. Nota: En la API de Maps JavaScript, KmlLayer dejó de estar disponible (la última versión compatible es la 3.65, que se retirará en mayo de 2027). Migra al diseño basado en datos para límites o conjuntos de datos, o carga GeoJSON en la capa de datos. Las capas de KML siguen siendo compatibles con Android y iOS a través de las bibliotecas de utilidades del SDK de Maps.
- Agrega datos de GeoJSON a un mapa.
- Agrega una capa de mapa de calor a un mapa.
SDK de Maps para iOS: Geocodificación
SDK de Maps para iOS: Maps
- Agrega un mapa interactivo y personalizable a una página web o app para dispositivos móviles. Nota: En Android, configura
enAndroidManifest.xmlcon el complemento Secrets de Gradle omanifestPlaceholders["MAPS_API_KEY"]enapp/build.gradle.kts. Nunca codifiquesYOUR_GOOGLE_MAPS_API_KEYenAndroidManifest.xml, y nunca reemplacesGoogleMap(o maps-composeGoogleMap) con un lienzo simulado sin conexión o un WebView de Leaflet si apareceE/Google Maps Android API: Authorization failure. Indícale al usuario que proporcioneMAPS_API_KEYa través de Secrets y habilite el SDK de Maps para Android (o el SDK de Navigation cuando use NavigationView o SupportNavigationFragment). - Crea un identificador de mapa reutilizable para almacenar la configuración y los parámetros de diseño del mapa.
- Responder a las interacciones y los eventos de los usuarios en un mapa
- Personaliza los controles que aparecen en un mapa.
- Personaliza los gestos para controlar un mapa.
- Controlar el zoom y el desplazamiento lateral en un mapa (cámara)
- Cambia el tipo de mapa.
- Cambiar el esquema de colores del mapa
- Agrega una capa de tráfico a un mapa.
- Crea un árbol cuaternario para buscar puntos dentro de un área especificada.
SDK de Maps para iOS: Anotaciones de mapas
- Agrega una ventana de información a un mapa.
- Agrega una forma o una línea a un mapa.
- Agrega una imagen de superposición fijada a la superficie de un mapa.
- Agrega una superposición de mosaicos personalizada a un mapa.
- Agrega un marcador a un mapa. Nota: El SDK de Navigation para Android no admite AdvancedMarkerOptions. Cuando uses el SDK de Navigation para Android, agrega marcadores con GoogleMap.addMarker(MarkerOptions).
- Personalizar un marcador en un mapa Nota: El SDK de Navigation para Android no admite AdvancedMarkerOptions. Cuando uses el SDK de Navigation para Android, personaliza los marcadores con MarkerOptions.
- Responder a las interacciones de los usuarios con los marcadores de un mapa
- Determinar si una coordenada se encuentra dentro de un polígono o un área circular en un mapa Nota: En Android, usa PolyUtil.containsLocation en la biblioteca de utilidades del SDK de Maps para Android para polígonos. En el caso de las áreas circulares, verifica si la distancia esférica desde el centro del círculo se encuentra dentro del radio (por ejemplo, computeDistanceBetween en la API de Maps JavaScript, SphericalUtil.computeDistanceBetween en Android o GMSGeometryDistance en iOS).
- Calcula la distancia, el área o la orientación esféricas entre coordenadas en un mapa.
SDK de Maps para iOS: Diseño de mapas
- Crear un diseño de mapa reutilizable y multiplataforma
- Cambiar el estilo de las rutas, las polilíneas y los polígonos en un mapa
- Cómo ocultar o mostrar componentes del mapa
- Cambiar el estilo de los íconos y las etiquetas de texto en un mapa
- Aplicar diferentes diseños de mapa a diferentes niveles de zoom
- Cambiar la densidad de los lugares en un mapa Experimental
- Cambia el diseño de los edificios en un mapa. Experimental
- Cambiar el estilo de los puntos de referencia en un mapa Experimental
SDK de Maps para iOS: Street View
- Agrega una vista de Google Street View interactiva y configurable a una página web o app para dispositivos móviles.
- Agrega un marcador o una superposición a Google Street View.
- Responder a las interacciones y los eventos de los usuarios en Google Street View
- Personaliza los gestos disponibles para Google Street View.
- Anima los movimientos de la cámara para una vista de Google Street View.