En esta guía, se muestra cómo instalar el SDK de Maps para Android versión 3.1.0 BETA. Una vez que lo instales, obtén información para usar las nuevas funciones.
Cómo instalar el SDK de Maps para Android versión 3.1.0 beta
Sigue estos pasos para agregar manualmente la biblioteca cliente del SDK de Maps para Android versión 3.1.0 beta a tu proyecto de Android Studio.
-
Descarga la biblioteca estática de Places (puedes omitir este paso si no usas Places):
- places-maps-sdk-3.1.0-beta.aar (opcional, para usar solo con Maps versión 3.1.0 beta)
- Copia el archivo AAR en la carpeta
app/libs
de tu proyecto de Android Studio. -
En la sección
buildscript.repositories
de tu archivobuild.gradle
de nivel superior, asegúrate de que se incluya el repositorio Maven de Google:buildscript { repositories { google() // ... } }
-
En la sección
dependencies
de tu archivobuild.gradle
a nivel de la app, agrega el SDK de Maps para Android y, opcionalmente, la biblioteca estática de Places y sus dependencias requeridas:dependencies { implementation 'com.google.android.libraries.maps:maps:3.1.0-beta' // If you are using Places, add all of the dependencies below implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar' implementation 'com.google.android.gms:play-services-gcm:17.0.0' implementation 'com.google.auto.value:auto-value-annotations:1.6.2' }
En la sección
dependencies
del archivobuild.gradle
a nivel de la app, quita la línea de implementación de la versión anterior (será similar a la siguiente):- Sincroniza tu proyecto de Gradle.
Convierte las configuraciones existentes.
- Si tu app existente usa el SDK de Maps para Android a través de los Servicios de Google Play, reemplaza todas las referencias al paquete
com.google.android.gms.maps
con el paquetecom.google.android.libraries.maps
(usa Edit > Replace in Path... en Android Studio). - Si tu app existente usa el plan premium de Google Maps Platform, reemplaza todas las referencias al paquete
com.google.android.m4b.maps
con el paquetecom.google.android.libraries.maps
. Además, quita el prefijom4b_
de todas las referencias a los atributos de diseño XML. Por ejemplo:m4b_mapType
debe convertirse enmapType
, ym4b_cameraZoom
debe convertirse encameraZoom
.
- Si tu app existente usa el SDK de Maps para Android a través de los Servicios de Google Play, reemplaza todas las referencias al paquete
-
Actualiza tus reglas ProGuard para mantener las clases del SDK de Maps para Android cuando se habiliten la reducción y ofuscación de código en las compilaciones de lanzamiento.
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
La biblioteca del SDK de Maps para Android está disponible a través del repositorio Maven de Google. Para agregar el SDK a tu app, haz lo siguiente:
implementation 'com.google.android.gms:play-services-maps:17.0.0'
Si usas el plan premium de Google Maps Platform, la línea de implementación que se debe quitar será como alguna de estas dos opciones:
implementation(name:'google-maps-sdk-m4b', ext:'aar') implementation project(':googlemapssdkm4b_lib')
Cómo importar la biblioteca de utilidades compatible con la versión beta
Si usas la biblioteca de utilidades de la API de Google Maps para Android, también deberás actualizar las dependencias de tu proyecto para reemplazar la versión existente por una compatible con la versión beta. Para ello, haz lo siguiente:
- Importa la biblioteca de utilidades compatible con la versión beta en tu archivo
build.gradle
:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- Quita lo siguiente de
build.gradle
para quitar la biblioteca de utilidades no compatible con la versión beta:implementation 'com.google.maps.android:android-maps-utils:1.3.1'
Cómo ejecutar las muestras
En el repositorio de muestras de código de Google en GitHub se incluyen apps de ejemplo que muestran el uso del SDK de Maps para Android versión 3.1.0.
- Muestras del SDK de Maps para Android
- Muestras del SDK de Places para Android (solo para usar con el SDK de Maps para Android versión 3.1.0 beta)