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:
- Necesitas navegación paso a paso en tu app de mapas para Android. En su lugar, usa el SDK de Navigation para Android.
- Necesitas mapas en 3D fotorrealistas, modelos en 3D o animaciones de rutas de cámara en una app para Android. En su lugar, usa el SDK de Maps 3D para Android.
- Necesitas un mapa en una app para iOS nativa. En su lugar, usa el SDK de Maps para iOS.
SDK de Maps para Android: Configuración
- Servicio que se habilitará:
maps-android-backend.googleapis.com - Autenticación: Clave de API
- Atribución de uso: Llama a
MapsApiSettings.addInternalUsageAttributionId(context, id)para agregar un ID de atribución de uso al inicializador (solo se admite conMapsInitializer.Renderer.LATEST). Para inhabilitar esta opción, borra la llamada o pasa una cadena vacía. - Comienza a usar el SDK de Maps para Android: Configura el SDK de Maps para Android
- Referencia: Referencia del SDK de Maps para Android
- Precios: Uso y facturación del SDK de Maps para Android
- Políticas: Políticas del SDK de Maps para Android
- Notas de la versión: Notas de la versión del SDK de Maps para Android
Paquetes oficiales del SDK de Maps para Android:
- maven:
com.google.android.gms:play-services-maps
SDK de Maps para Android: productos relacionados
- Se suele usar con: SDK de Places para Android
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 conjava.lang.NoClassDefFoundError. Solución: Agregadentro de la etiquetadel archivoAndroidManifest.xmlde 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 deMapsInitializer.Rendererque se pasa aOnMapsSdkInitializedCallback.onMapsSdkInitialized(), o bien verificaGoogleMap.getMapCapabilities(). Si el dispositivo usaLEGACY, 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
- 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 Android: 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 Android: 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 Android: 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.
- Agrega un mapa a una app para Wear OS.
SDK de Maps para Android: Anotaciones de Maps
- 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 Android: 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 Android: Street View
- Agrega una vista de Google Street View interactiva y configurable a una página web o app para dispositivos móviles.
- 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.