Configuración de API key de Google Maps para Android

Curso de Android: Integración de APIs nativas

Contenido del curso

Introducción a la Integración Nativa en Android

Google Maps SDK

Servicios de Localización

Integración Maps con Localización

Manejo de permisos

Integración cámara

Servicios en Android

Transmisiones en Android (Broadcast)

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:005:30

Configuración de API key de Google Maps para Android

Curso de Android: Integración de APIs nativas

Clase 3 de 33

Clase 3 / 33

Recursos

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:

Dirígete a la parte superior izquierda y haz clic en la sección de proyectos.
Crea un nuevo proyecto, por ejemplo, Track It Tress, y asígnale el nombre que desees.
Selecciona tu cuenta de facturación (billing account); aunque Google Maps no implica costos adicionales, siempre existirá esta asociación.
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:

Selecciona la aplicación en Android Studio y ejecuta el emulador.
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.

Resumen

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

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

Dirígete a la parte superior izquierda y haz clic en la sección de proyectos.
Crea un nuevo proyecto, por ejemplo, Track It Tress, y asígnale el nombre que desees.
Selecciona tu cuenta de facturación (billing account); aunque Google Maps no implica costos adicionales, siempre existirá esta asociación.
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:

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

Introducción a la Integración Nativa en Android

API nativas de Android con Kotlin y Compose

Configuración inicial de proyecto Android con Kotlin DSL y Hilt

Google Maps SDK

Configuración de API key de Google Maps para Android

Creación de marcadores personalizados en Google Maps con Compose

Cómo dibujar polilíneas en mapas con Jetpack Compose

Centrado automático de mapas con Camera Update Factory

Servicios de Localización

Kotlin Flows para medir tiempo en Android

Simulación de ubicación GPS en emulador y dispositivo Android

Modelos de localización propios con Clean Architecture

Callbacks de Android convertidos en Flows

Inyección de dependencias para observar localización en Android

LocationTracker con StateFlow para rastreo en Android

State Flows para controlar localización y tiempo en Kotlin

Configuración y pruebas de Location Tracker en Android

Integración Maps con Localización

Integración de ubicación actual en mapas interactivos

Creación de polilíneas con datos reales en mapas de Android

Integración de intents y estados en pantalla mapa con Compose

TrackingMapViewModel con Hilt y StateFlow

Manejo de permisos

Permisos de Android en tiempo de ejecución

Creación de diálogos de permisos reutilizables en Android

Gestión de permisos de localización y notificaciones en Android

Implementación de solicitud de permisos con LaunchedEffect en Compose

Integración cámara

Cómo guardar fotos en Android con PhotoHandler

Conversión de Bitmaps a Byte Arrays con Extension Functions

CameraViewModel con Hilt y StateFlow

Configuración de métodos del ViewModel para gestión de cámara

Integración de CameraX con Jetpack Compose en Android

Creación de pantalla de previsualización de fotos con Jetpack Compose

Galería de fotos en marcadores del mapa

Servicios en Android

Servicios en segundo plano en Android

Configuración de foreground services y notificaciones en Android

Transmisiones en Android (Broadcast)

Broadcast Receivers para escuchar eventos del sistema en Android

Prueba completa de aplicación Android con cámara y localización

Configuración de API key de Google Maps para Android