Configuración de utilidades del SDK de Maps para Android

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 demostración 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 {
    implementation 'com.google.maps.android:android-maps-utils:2.2.3'
}

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 {
    implementation 'com.google.maps.android:maps-utils-ktx:3.1.0'
}

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
  • La biblioteca de utilidades del SDK de Maps para la versión 3 beta, en el directorio library-v3
  • Varios archivos que contienen información sobre las licencias y los colaboradores, y el archivo Léame
  • 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.

  1. Descarga el repositorio mediante una de las opciones antes mencionadas.
  2. En Android Studio, selecciona Archivo > Nuevo > Importar proyecto.
  3. 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.
  4. 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.
  5. 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.