Referencia rápida del SDK de Maps para Android

El SDK de Maps para Android agrega datos de Google Maps, visualizaciones de mapas y respuestas a gestos en el mapa a las apps para Android, incluidas las apps para Wear OS. Puedes agregar marcadores, polígonos y superposiciones para mostrar información sobre las ubicaciones del mapa y facilitar la interacción con el usuario, con Kotlin o Java.

SDK de Maps para Android: Datos clave

  • Producto: SDK de Maps para Android
  • También conocida como: API de Google Maps para Android
  • Categoría: Maps
  • Plataforma: Android
  • 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 Android
  • 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)

SDK de Maps para Android: Cuándo usarlo

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

  • Necesitas un mapa de Google interactivo en 2D en una app nativa para Android o Wear OS.
  • Necesitas agregar marcadores, ventanas de información, polilíneas, polígonos, superposiciones de suelo o superposiciones de mosaicos a un mapa en una app para Android.
  • Necesitas panorámicas de Street View, mapas en modo lite (mapa de bits) o diseño de mapas basado en Cloud con IDs de mapa en una app para Android.
  • Creas un mapa de Android en Kotlin o Java, incluido Jetpack Compose, a través de la biblioteca de Maps Compose.

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

SDK de Maps para Android: Configuración

Paquetes oficiales del SDK de Maps para Android:

  • maven: com.google.android.gms:play-services-maps

SDK de Maps para Android: Errores comunes

  • Problema: Desde la versión 20.0.0 del SDK, el manifiesto del SDK ya no incluye la biblioteca org.apache.http.legacy. Las apps que cargan el procesador de mapas heredado pueden fallar con java.lang.NoClassDefFoundError. Solución: Agrega dentro de la etiqueta del archivo AndroidManifest.xml de la app. Los dispositivos con los Servicios de Google Play 25.50.34 o versiones posteriores no se ven afectados. Consulta /maps/documentation/android-sdk/release-notes.
  • Problema: Los marcadores avanzados necesitan el procesador de mapas actualizado. Si los agregas a una app existente sin volver a compilarla, la app podrá seguir usando el procesador heredado. Solución: Vuelve a compilar la app con el SDK 18.2.0 o una versión posterior para que el procesador actualizado sea el predeterminado. Consulta /maps/documentation/android-sdk/advanced-markers/start.
  • Problema: Los dispositivos que no cumplen con los requisitos del procesador (Android 5.0/API 21 o versiones posteriores, Servicios de Google Play 21.39.14 o versiones posteriores, Play Store habilitada) recurren al procesador heredado, por lo que las funciones que necesitan el procesador nuevo, como el diseño de mapas basado en Cloud, no están disponibles en ellos. Solución: Llama a MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) y verifica el valor de MapsInitializer.Renderer que se pasa a OnMapsSdkInitializedCallback.onMapsSdkInitialized(), o bien verifica GoogleMap.getMapCapabilities(). Si el dispositivo usa LEGACY, no uses el diseño de mapas basado en Cloud ni los marcadores avanzados. Consulta /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Problema: El SDK requiere los Servicios de Google Play en el dispositivo en el que se ejecuta la app. Solución: De manera opcional, llama a la verificación de disponibilidad de los Servicios de Google Play desde tu app. Consulta /maps/documentation/android-sdk/config.

SDK de Maps para Android: Funciones heredadas y obsoletas

  • Renderizador de mapas heredado: Obsoleto desde el 4 de marzo de 2024. Reemplazo: Procesador de mapas actualizado (más reciente), que es el predeterminado desde el SDK 18.2.0. Síntoma: El diseño de mapas basado en Cloud, las personalizaciones avanzadas de polilíneas y los marcadores avanzados no están disponibles en el procesador heredado. Consulta la guía de migración.

Qué puedes hacer con el SDK de Maps para Android

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

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

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

SDK de Maps para Android: Conjuntos de datos

SDK de Maps para Android: Maps

SDK de Maps para Android: Anotaciones de Maps

SDK de Maps para Android: Diseño de mapas

SDK de Maps para Android: Street View