martedì 27 maggio 2014

ANDROID - Utilizar API de Google Maps con Android Studio

Como utilizar Google Maps API in Android Applications

Presentación

Para crear una aplicación que utiliza Google Maps Android API v2 tenemos que:

  1. Descargar y configurar Google Play Services SDK, lo cual incluye Google Maps Android API. 
  2. Obtener una clave de API. Para hacer esto, tendremos que registrar un proyecto en Google APIs Console.
  3. Configurar el application manifest
  4. 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:


  1. Ejecutar el SDK Manager
    1. En Android Studio le damos al boton SDK Manager en el toolbar
  2. Instalar el Google Play services SDK.
    1. 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.
  3.  Instalar una version compatible de Google APIs platform.
    1. 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

Nessun commento:

Posta un commento