En una entrada anterior habíamos mostrado como configurar y usar Google Maps API v2 para Android. En varias ocasiones tuvimos muchas preguntas de como hacer funcionar y nos dimos cuenta que Google había cambiado algunas cositas par hacer funcionar. Entonces nos vimos con la necesidad de volver a hacer un post sobre el tema. Como configurar y damos un ejemplo para lo que prueben ustedes mismos.

Para poder programar mapas de Google Maps API v2 para Android debemos de hacer algunos pasos para darle permisos a nuestra aplicación y poder usar.
La API v2 de Google Maps se proporciona como parte del SDK de Google Play Services. Será necesario incorporar previamente a nuestro entorno de desarrollo dicho paquete. Haremos esto accediendo desde Eclipse al Android SDK Manager y descargando del apartado de extras el paquete llamado «Google Play Services».

Instalar Google Play services
Instalar Google Play services

Tras pulsar el botón de Install y aceptar la licencia correspondiente el paquete quedará instalado en nuestro Sistema, concretamente en la ruta: /extras/google/google_play_services/. Es importante acordarse de esta ruta porque la utilizaremos más tarde.
El siguiente paso será obtener una API Key para poder utilizar el servicio de mapas de Google en nuestra aplicación. Entramos a este link.

Una vez que hemos entrado al sitio, tenemos que crear un nuevo proyecto presionando el botón Create Project.

Crear nuevo proyecto
Crear nuevo proyecto

Colocamos el nombre del proyecto, y si quieren pueden cambiar también el ID del proyecto, o dejar como te sugiere. Queda a elección de ustedes. 🙂
Ahora hacemos click al proyecto que recién hemos creado, y nos dirigimos en la sección donde dice APIs & auth. Ahí dentro seleccionamos APIs y en este caso sólo activaremos el servicio llamado «Google Maps Android API v2» pulsando sobre el botón OFF situado a su derecha.

Activar Google Maps Android API v2
Activar Google Maps Android API v2

Una vez activado saldrá como se muestra en la imagen de abajo.

Activado Google Maps Android API v2
Activado Google Maps Android API v2

Una vez activado el servicio Google Maps Android API v2, nos volvemos a dirigir en la sección APIs & auth. Ahí dentro seleccionamos Registered apps.Ahora registramos nuestra app, presionando el botón Register app.

Registrar una nueva app
Registrar una nueva app

Colocamos el nombre de nuestra aplicación y luego nos dirigimos a nuestro eclipse. Para identificar en qué carpeta de nuestro sistema está almacenado este certificado accediendo desde Eclipse al menú Window/Preferences y accediendo a la sección Android/Build.

Ruta del certificado
Ruta del certificado

En mi caso la ruta del certificado es: /home/proyectosbeta/.android/. Ahora obtenemos nuestra huella digitall SHA entramos a la consola y escribimos:
cd /home/proyectosbeta/.android/
keytool -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android

Obtenemos la huella digital SHA
Obtenemos la huella digital SHA

OBS:

  • En este caso utilizo GNU/Linux, pero sería prácticamente lo mismo en Windows. :)

Copiamos el SHA que recién obtuvimos y lo añadimos a la ventana de obtención al registrar la app donde nos habíamos quedado antes. En donde dice el nombre del paquete colocamos el nombre del paquete que vamos a usar en nuestra aplicación que vamos a programar. En mi caso el nombre sería net.proyectosbeta.mapas_ejemplo_google_maps_apiv2_1. Mostramos una imagen para que tengan una idea de cómo tendría que ser.

Registrar una app
Registrar una app

Y por último presionamos el botón Registrar.

Para acceder al Key debemos de entrar a la aplicación que recién hemos creado.

Visualizar una KEY de la API de Google Maps v2 para Android
Visualizar una KEY de la API de Google Maps v2 para Android

Con esto ya terminamos los preparativos iniciales necesarios para utilizar el servicio de mapas de Android en nuestras propias aplicaciones. Ahora creamos un proyecto de ejemplo en Eclipse.

Abriremos Eclipse y crearemos un nuevo proyecto estándar de Android, en mi caso lo he llamado «mapas_ejemplo_google_maps_apiv2_1″. Recordemos utilizar para el proyecto el mismo paquete java (en este caso sería net.proyectosbeta.mapas_ejemplo_google_maps_apiv2_1)que hemos indicado durante la obtención de la API key.

Tras esto lo primero que haremos será agregar algunas cosas en el  archivo AndroidManifest.xml la API Key que acabamos de generar. Para ello añadiremos al fichero, dentro de la etiqueta , un nuevo elemento con los siguientes datos:

Archivo AndroidManifest.xml
Archivo AndroidManifest.xml

OBS:

  • Como valor del parámetro android:value tenemos que poner nuestra API Key recién generada.

Siguiendo con el archivo AndroidManifest.xml, también tenemos que incluir una serie de permisos que nos permitan hacer uso de los mapas.

Agregar permisos
Agregar permisos

OBS:

  • En la imagen anterior, lo que esta seleccionado tienen que atender y colocar el nombre de su paquete de java. Los demás permisos se copian tal cual.

Por último, dado que la API v2 de Google Maps Android utiliza OpenGL ES versión 2, debemos especificar también dicho requisito en nuestro archivo AndroidManifest.xml.

Open GL v2
Open GL v2

Una vez que hemos configurado todo lo necesario en el archivo AndroidManifest.xml, y antes de escribir nuestro código, tenemos que seguir añadiendo elementos externos a nuestro proyecto.

El primero de ellos será referenciar desde nuestro proyecto la librería con el SDK de Google Play Services que nos descargamos al principio de este post. Desde Eclipse podemos importar la librería a nuestro conjunto de proyectos mediante la opción de menú File -> Import ->Android -> Existing Android Code Into Workspace. Como ya dijimos este paquete se localiza en la ruta «/extras/google/google_play_services/libproject/google-play-services_lib«.

Importar librería Google Play services en Eclipse
Importar librería Google Play services en Eclipse

Tras seleccionar la ruta correcta dejaremos el resto de opciones con sus valores por defecto y pulsaremos Finish para que Eclipse importe esta librería a nuestro conjunto de proyectos.

El siguiente paso será referenciar esta librería desde nuestro proyecto de ejemplo. Nos vamos a Propiedades pulsando botón derecho Properties sobre nuestro proyecto y accediendo a la sección Android de las preferencias. En dicha ventana podemos añadir una nueva librería en la sección inferior llamada Library. Cuando pulsamos el botón «Add…» nos aparecerá la librería recién importada. Ahora seleccionamos y añadimos a nuestra lista de librerías referenciadas por nuestro proyecto.

Seleccionamos la librería de Google Play services
Seleccionamos la librería de Google Play services

Volvemos a entrar al archivo AndroidManifest.xml y agregamos lo siguiente:

Agregar Google Service en el AndroidManifest.xml
Agregar Google Service en el AndroidManifest.xml

Y con estos pasos, ya tenemos todo configurado para poder empezar a programar una aplicación de Android que incluye un mapa de Google Maps utilizando su versión 2.

Ejemplo del programa:

Ejemplo utilizando la API de Google Maps v2 para Android
Ejemplo utilizando la API de Google Maps v2 para Android

OBS:

  • Probamos con un dispositivo Samsung Galaxy Nexus con Android 4.3
  • Utilicen tu propia key, no usen la que muestro en el ejemplo. Creenla ustedes mismos. En este post lo muestro.

Código Fuente: Ejemplo de Google Maps API v2_1
Descargar: El apk de Ejemplo de Google Maps API v2_1

Comments

comments


Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *