Cómo configurar un proyecto existente de Android Studio

En esta página, se explica cómo configurar un proyecto de Android Studio para utilizar el SDK de Maps para Android sin usar la plantilla de Google Maps que se detalla en la Guía de inicio rápido.

La plantilla de Google Maps configura automáticamente un proyecto de Android Studio nuevo y agrega un mapa básico. Sin embargo, también puedes agregar un mapa a un proyecto de Android que utilice una plantilla de Android Studio diferente. Para ello, debes configurar tu proyecto manualmente y, luego, agregar el mapa.

Cómo configurar Android Studio

  1. Se requiere Android Studio. Si aún no lo tienes, descárgalo y, luego, instálalo.

  2. Agrega el SDK de Servicios de Google Play a Android Studio. El SDK de Maps para Android se distribuye como parte del SDK de Servicios de Google Play, el cual puedes agregar a través de SDK Manager.

Cómo configurar un proyecto de Cloud y una clave de API

Para configurar un proyecto de Cloud y una clave de API, haz lo siguiente:

Cómo actualizar el manifiesto de la app

En esta sección, se explica qué parámetros debes agregar al archivo AndroidManifest.xml.


Número de versión de Servicios de Google Play

Agrega la siguiente declaración en el elemento application. Esto incorporará la versión de Servicios de Google Play con la que se compiló la app.

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

Permiso de ubicación

Si tu app necesita acceder a la ubicación del usuario, debes solicitar el permiso de ubicación en el archivo AndroidManifest.xml. Las opciones son ACCESS_FINE_LOCATION, que proporciona la ubicación exacta del usuario, y ACCESS_COARSE_LOCATION, que es menos precisa. Para obtener más detalles, consulta la guía Datos de ubicación.

Para solicitar el permiso ACCESS_FINE_LOCATION, agrega este código al elemento manifest:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Permiso de almacenamiento externo

Si planeas utilizar la versión 8.3 o una posterior del SDK de Servicios de Google Play, no necesitas el permiso WRITE_EXTERNAL_STORAGE. Si planeas usar versiones anteriores del SDK de Servicios de Google Play, debes solicitar el permiso WRITE_EXTERNAL_STORAGE en el elemento manifest.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Biblioteca Apache HTTP Legacy

Si utilizas com.google.android.gms:play-services-maps:16.0.0 o versiones anteriores, y tu app planea usar el nivel de API 28 (Android 9.0) o uno posterior, debes incluir la siguiente declaración en el elemento <application> del archivo AndroidManifest.xml. De lo contrario, omite esta declaración.

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

Cómo agregar la dependencia de Maps

En el archivo build.gradle a nivel de la app, agrega la dependencia de Maps. Para obtener más información, consulta la guía Control de versiones.

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.1'
    // ...
}

Próximos pasos

Una vez que tu proyecto esté configurado, podrás agregar un mapa.