Como utilizar Google Maps API in Android Applications
Presentación
Para crear una aplicación que utiliza Google Maps Android API v2 tenemos que:
- Descargar y configurar Google Play Services SDK, lo cual incluye Google Maps Android API.
- Obtener una clave de API. Para hacer esto, tendremos que registrar un proyecto en Google APIs Console.
- Configurar el application manifest
- Añadir una mapa en nuestra aplicación
1 - Instalar y configurar the Google Play services SDK
Para instalar Google Play services SDK tenemos que:
- Ejecutar el SDK Manager
- En Android Studio le damos al boton SDK Manager en el toolbar
- Instalar el Google Play services SDK.
- Desplazamos la pantalla hasta el final de la lista de los paquetes, le damos a Extra, selecionamos Google Play services, y lo instalamos.
Si estamos utilizando Android Studio, tambien tenemos que instalar Google Repository. - Instalar una version compatible de Google APIs platform.
- Si queremos testar nuestra aplicación utilizando el emulator de Android Studio, tendremos que instalar, a travez del SDK manager, Google APIs desde Android 4.2.2 (API 17) o una versión mas reciente.
En segundo lugar, tendremos que crear un nuevo AVD ponendo Google APIs como platform target.
Configurar un proyecto que utilize Google Play Services en Android Studio:
1. Abrimos el fichero build.gradle que esta dentro de nuestra aplicación.
2. Añadimos esta linea abajo de dependencies en el build.gradle
compile ‘com.google.android.gms:play-services:4.3.23'
Si estamos utilizando una versión actualizada de Google Play services tenemos que cambiar también el numero de versión
en esta linea.
3. Guardamos los cambios que acabamos de hacer y le damos a “Sync Project with Grade files”
4. Abrimos el app manifest y añadimos este tag abajo del elemento <application>
<meta-data android:name="com.google.android.gms.version"
; android:value="@integer/google_play_services_version" />
2 - Obtener un certificado Android y la clave Google Maps API
Para acceder a los servidores de Google Maps tenemos que añadir una clave de Google Maps API a nuestra aplicación.
Para obtener una clave por nuestra aplicación tenemos que:
1. Obtener la SHA-1 fingerprint de nuestra aplicación
Para Linux o OS X, abrimos un terminal y damos el comando
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
Copiamos la SHA-1 (20 numeros hexadecimales)
2. Registramos un proyecto en el Google APIs Console
- Navigamos en un browser a la pagina de Google APIs Console.
- Elegimos “Services” en el menu de izquierda y en la lista que aparece buscamos
Google Maps Android API v2.
- Una vez encontrado, cambiamos el indicador en ON
3. Pedimos una clave
- En el menu de izquierda damos a API access
- Despues, tenemos que darle a Create New Android Key
- Ahora introducimos la clave SHA-1 que hemos guardado anteriormente
- Copiamos la clave de Google API que aparece
4. Finalmente tenemos que añadir la clave, que acabamos de obtener, en nuestra aplicación.
En el Android Manifest añadimos el siguiente código abajo de <application>
<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="API_KEY"/>
3 - Configuramos el Application Manifest
Tenemos que especificar los permisos que nuestra aplicación necesita añadiendo elementos
<uses-permission> abajo del tag <manifest>
Abrimos el application manifest y añadimos los siguientes permisos que necesitamos para utilizar las API de Google Maps
<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/><!-- The following two permissions are not required to use Google Maps Android API v2, but are recommended. --><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permission android:name=“android.permission.ACCESS_FINE_LOCATION"/>
4 - Añadimos una mapa a nuestra aplicación y testamos
Finalmente solo nos falta de añadir una mapa a nuestra aplicación para testar su correcto funcionamiento.
Añadimos este código en el fichero XML de layout de nuestra aplicación
<?xml version="1.0" encoding="utf-8"?> <fragment xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/map" android:layout_width="match_parent" android:layout_height="match_parent" android:name=“com.google.android.gms.maps.MapFragment”/>
Ahora, vamos a modificar el código JAVA en MainActivity.java
package com.example.mapdemo;
import android.app.Activity;
import android.os.Bundle;
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
Construimos y ejecutamos nuestra aplicación, si hemos seguido todo el tutorial correctamente nos debe salir una mapa!
Referencia
