Configuración de API key de Google Maps para Android

Clase 3 de 33 • Curso de Android: Integración de APIs nativas

Clase anteriorSiguiente clase

Resumen

Para integrar Google Maps en una aplicación Android, es imprescindible contar con una API key generada en Google Cloud Platform. Este proceso es sencillo y totalmente necesario para comenzar a utilizar mapas interactivos en tus desarrollos, permitiéndote densificar la experiencia del usuario con herramientas como marcadores o rutas.

¿Cómo crear un proyecto en Google Cloud Platform?

Para comenzar, accede a Google Cloud Platform y sigue estos pasos:

  1. Dirígete a la parte superior izquierda y haz clic en la sección de proyectos.
  2. Crea un nuevo proyecto, por ejemplo, Track It Tress, y asígnale el nombre que desees.
  3. Selecciona tu cuenta de facturación (billing account); aunque Google Maps no implica costos adicionales, siempre existirá esta asociación.
  4. Haz clic en create y selecciona el proyecto que acabas de crear desde la parte superior del menú.

¿Qué pasos seguir para activar la API de Maps SDK for Android?

Una vez creado y seleccionado tu proyecto:

  • Ve a la sección API and services.
  • Activa mapas buscando específicamente la opción Maps SDK for Android.
  • Presiona en enabled para habilitar la API, y obtendrás automáticamente tu API key.

Recuerda guardar esta API key de manera segura para próximas configuraciones.

¿Cómo restringir la API key para mayor seguridad?

La restricción de la API key es un paso adicional para proteger su uso:

  • Desde Google Maps Platform, selecciona aplicar una restricción para aplicaciones Android.
  • Coloca el nombre del paquete (package name) de tu proyecto Android (por ejemplo, com.1dGuidance.TrackIt).
  • Añade tu certificado SHA (certificate fingerprint), generado desde Android Studio con la tarea sign in report disponible en la barra lateral Gradle.
  • Copia y pega sin espacios la información del SHA fingerprint y presiona en restrict key.

Una vez hecho esto, recibirás una confirmación que indica que la API key está correctamente restringida.

¿Cómo implementar la API key en tu proyecto con Gradle?

Para integrar eficazmente la API key a tu aplicación Android, realiza estas acciones:

  • En el archivo local.properties, añade la constante que guardará tu API key:
mapsApiKey=TU_API_KEY_GENERADA
  • Utiliza el plugin de secretos específicamente diseñado para Google Maps en tu archivo build.gradle:
plugins {
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}
  • Sincroniza tu proyecto pulsando synchronize now.

¿Cómo agregar la API key al archivo Android Manifest?

Con el plugin activo, dirígete a AndroidManifest.xml e introduce una nueva línea metadata dentro de la etiqueta application:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${mapsApiKey}"/>

Ahora, Android Manifest tendrá acceso directo a la API key definida, habilitando oficialmente Google Maps en tu aplicación.

¿Cómo verificar la integración del mapa en tu aplicación?

Tras estos pasos, prueba que todo funciona correctamente:

  1. Selecciona la aplicación en Android Studio y ejecuta el emulador.
  2. Verifica que Google Maps carga correctamente dentro de tu aplicación.

Una vez logrado este paso, tendrás incorporado Google Maps correctamente y podrás seguir avanzando hacia interacciones más avanzadas como marcadores personalizados y polilíneas. Te invitamos a comentar cómo te fue con esta configuración o cualquier duda que surja en el proceso.