En esta página, se describe cómo configurar la biblioteca de utilidades del SDK de Maps para Android y cómo ejecutar la app de demo que se incluye en la biblioteca.
Requisitos previos y notas
La biblioteca de utilidades del SDK de Maps para Android admite el nivel de API de Android 15 y superiores. Al configurar el destino de compilación de tu proyecto, asegúrate de usar el nivel de API de Android más reciente.
La documentación de referencia está disponible en GitHub.
Paso 1. Instala la biblioteca de utilidades del SDK de Maps para Android
Agrega la siguiente dependencia al archivo build.gradle de tu app:
dependencies {
// Utility Library for Maps SDK for Android
// You do not need to add a separate dependency for the Maps SDK for Android
// since this library builds in the compatible version of the Maps SDK.
implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}
Usa una de las utilidades de la biblioteca, como el agrupamiento de marcadores en clústeres, los mapas de calor o las demás utilidades.
Paso 2. (Opcional) Instala la biblioteca de utilidades de KTX del SDK de Maps para Android
La biblioteca de utilidades del SDK de Maps para Android incluye la biblioteca de extensiones de Kotlin (KTX) correspondiente. Esta biblioteca proporciona elementos del lenguaje Kotlin (como funciones de extensión, argumentos asignados y predeterminados), para que puedas escribir de forma idiomática y concisa. Si no utilizas Kotlin para desarrollar, puedes omitir este paso.
Para usar esta biblioteca, agrega la siguiente dependencia, además de android-maps-utils, al archivo build.gradle de tu app:
dependencies {
// KTX for the Maps SDK for Android Utility Library
implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}
Consulta la página de KTX para Maps en GitHub a fin de obtener información adicional sobre esta biblioteca.
Paso 3. Consulta el código fuente de la biblioteca de utilidades del SDK de Maps para Android
Dado que la biblioteca de utilidades es de código abierto, puedes descargar la biblioteca android-maps-utils en tu máquina para personalizarla y ver la app de demostración, o bien si solo quieres entender cómo funciona. Para hacerlo, clona el repositorio (se recomienda para recibir actualizaciones automáticas) o descarga un archivo ZIP. Si deseas personalizar la biblioteca, debes bifurcar el repositorio.
En el repositorio se incluye lo siguiente:
- Una app de demostración, en el directorio
demo - La biblioteca de utilidades, en el directorio
library - Varios archivos que contienen información sobre las licencias, los colaboradores y el archivo readme
- La configuración de compilación de Gradle para su uso con Android Studio
Cómo ejecutar la app de demostración de utilidades
El repositorio de GitHub de la biblioteca de utilidades se envía con una app de demostración que incluye implementaciones de muestra de cada utilidad. Para ejecutar la app de demostración en tu dispositivo Android, sigue los pasos que se proporcionan a continuación.
- Descarga el repositorio mediante una de las opciones antes mencionadas.
- En Android Studio, selecciona Archivo > Nuevo > Importar proyecto.
- Explora y selecciona (con doble clic) el directorio android-maps-utils que se creó cuando clonaste la biblioteca de utilidades. Android Studio compilará el proyecto.
- Si usas un dispositivo Android en lugar de un emulador, asegúrate de habilitar el modo de desarrollador. Luego, conecta el dispositivo Android a tu computadora.
Agrega una sola línea a
local.propertiescon el siguiente aspecto:MAPS_API_KEY=YOUR_API_KEY
YOUR_API_KEY es la clave de API que obtuviste como se describe en Cómo usar las claves de API.
- Compila y ejecuta la app de demostración.
La app se abrirá en el dispositivo Android y se mostrará una lista de utilidades que incluye clústeres, poyutil y mapa de calor, entre otros elementos. También puedes encontrar la app en tu lista de apps, con el nombre Maps Utils Demo.