Índice de contenido
Para comenzar a integrar mapas en nuestra aplicación, el primer paso es consultar la documentación oficial buscando "Google Maps Compose". La implementación consiste básicamente en agregar una dependencia y seguir un ejemplo mínimo que veremos a continuación.
Recuerda que quedamos en cómo usar Room Database (SQLite) en Android Studio con Kotlin.
1. Gestión de Dependencias
Lo primero es acudir al archivo build.gradle. Debes agregar la dependencia de Google Maps para Compose y sincronizar el proyecto. Una vez hecho esto, los errores de importación en tu código deberían desaparecer.
implementation("com.google.maps.android:maps-compose:4.4.1")2. Creación del Composable MyMap
Vamos a crear un Composable llamado MyMap.
Evita llamar a tu función simplemente GoogleMap, ya que ese es el nombre del componente oficial y causarías un conflicto de nombres.
Dentro del componente, definiremos la latitud y longitud (coordenadas para el entorno 2D). En este ejemplo, utilizaremos las coordenadas de Madrid y una segunda posición para los marcadores.
@Composable
fun MyMap() {
// Definimos dónde queremos que mire la cámara (ej. Madrid)
val madrid = LatLng(40.4167, -3.7037)
val marker2 = LatLng(41.4167, -3.7037)
val cameraPositionState = rememberCameraPositionState {
position = CameraPosition.fromLatLngZoom(madrid, 10f)
}
GoogleMap(
modifier = Modifier.fillMaxSize(),
cameraPositionState = cameraPositionState
) {
// Añadimos un marcador (un pin)
Marker(
state = MarkerState(position = madrid),
title = "Mi oficina",
snippet = "Aquí vivo"
)
Marker(
state = MarkerState(position = marker2),
title = "Mi carcelero",
snippet = "Aqui estoy secuestrado, ayuda!"
)
}
}Configuración de la API Key (Paso Crítico)
Si ejecutas la aplicación ahora, es muy probable que falle o muestre un mapa vacío. Para que funcione, debes configurar tu API Key en el archivo AndroidManifest.xml.
En el AndroidManifest.xml:
Dentro de la etiqueta <application>, debes añadir el siguiente bloque de meta-data:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="TU_CLAVE_AQUI" />¿Cómo obtener la clave?
- Dirígete a Google Cloud Console.
- Crea un proyecto nuevo o selecciona uno existente.
- En el menú de navegación (hamburguesa), busca Google Maps Platform.
- Ve a la sección de Claves y Credenciales para generar tu API Key.
En resumen:
- Seleccionar/Crear Proyecto: En la barra superior de Google Cloud (al lado del logo de "Google Cloud"), verás un desplegable. Haz clic ahí y selecciona "Nuevo proyecto".
- Luego le das un click al menu de hamburguesa y habilitas la API de Google Map.
- Ir a APIs y servicios: En el menú lateral izquierdo de tu imagen, haz clic en la sección que dice "APIs y servicios" y luego en "Biblioteca".
- Habilitar Maps SDK for Android: En el buscador de la biblioteca, escribe "Maps SDK for Android" y haz clic en Habilitar.
- Crear Credenciales: Una vez habilitada, ve a la pestaña "Credenciales" en el mismo menú de APIs y servicios. Haz clic en "Crear credenciales" y elige "Clave de API". Esa es la clave que pegarás en tu Android Studio.
Google suele solicitar una tarjeta de crédito/débito para verificar la identidad, aunque generalmente ofrecen un nivel gratuito amplio que no generará cargos si solo realizas pruebas.
Resultado Final
Una vez que hayas configurado la clave correctamente, la aplicación debería funcionar sin errores. Podrás ver el mapa centrado en la posición inicial (Madrid, en nuestro caso) y los marcadores que hayas definido con sus respectivos títulos y descripciones.
Si la clave es inválida o no está configurada, la aplicación podría cerrarse inesperadamente o mostrar un error de "API Key not found" en el Logcat. Con la configuración correcta, ya tendrás todas las opciones típicas de interacción de Google Maps integradas en tu app.
Si has seguido los pasos anteriores, al ejecutar la aplicación deberías ver una pantalla similar a la siguiente:
Y con los marcadores:
Siguiente paso, aprende a hacer animaciones en Android Studio con Compose.