DesarrolloLibre

Desarrollo Web, Android y mucho más

07-07-2014

En este artículo conoceremos los primeros pasos a realizar para integrar la API de Google Maps en nuestras aplicaciones Android.

1. El proyecto

Lo primero que debemos hacer es crear el proyecto en donde más adelante incluiremos la API de Google Maps.

2. Obtener la SDK de Google Play Service

Debemos obtener la SDK de Google Play Service; la misma proporciona la API de Google Maps que es la que deseamos utilizar en nuestro proyecto:

Windows >> Android SDK Manager

Y descargamos el paquete llamado "Google Play Service":

console developers google

3. Obtener la API Key

La API key no es más que una clave (key) que permite utilizar el servicio de Google Maps en una aplicación para Android; antes de detallar los pasos a seguir para obtener la API key, es necesario obtener cierta información sobre nuestro proyecto para dejarla "a mano"; la misma será solicitada cuando vayamos a crear la API key:

3.1 Obteniendo información del proyecto

  • El nombre del paquete empleado en el proyecto: Ejemplo: com.desarrollolibre.googlemapsv1.
  • La huella digital de la aplicación: Ya hemos hablado sobre este tema en un artículo pasado "¿Cómo firmar las aplicaciones Android?"; este es uno de los pasos que tenemos que hacer cuando queremos distribuir la aplicación de manera pública; por ejemplo cuando vamos a subirla a la Google Play.

    Podemos saber cual es la firma de nuestra aplicación desde:

    Windows >> Preferences >> Android >> Build

    Y copiamos el campo SHA1 = 61:46:40:##:##:##:##:##:##:##:##:##:##:##:##:##:##:##:##:##

3.2 Obteniendo la API key

La API key es necesaria para poder emplear el servicio de mapas en las aplicaciones Android que vayamos a desarrollar; para conseguirla hay que realizar los siguientes pasos:

  • Vamos a la Consola de Desarrolladores de Google.
  • Presionamos en el botón "Create Project": create project console developers google
  • Colocamos un nombre al proyecto y presionamos en el botón "Create": name project console developers google
  • Ingresamos en el proyecto (click en el enlace generado con el nombre del proyecto).

    Click en la opción "APIS & AUTH" ubicado en el menú de la izquierda y se desplegará una serie de opciones.

    Click en la opción "APIs":

    menú opciones console developers google
  • Buscamos la API llamada "Google Maps Android API v2": console developers google google maps api
  • Y la habilitamos: console developers google google maps api habilitada
  • Click en la opción "Credentials":

    menú opción credentials console developers google
  • Presionamos en el botón "Create new key": botón create new key console developers google
  • Presionamos en el botón "Android key": botón android key console developers google
  • Nos solicitará que ingresemos la información que hemos recopilado en el paso 3.1 (el SHA1;nombre del paquete de la aplicación):

    botón create android key console developers google
  • Presionamos en el botón "Create": botón create console developers google
  • Copiamos la API key: api key console developers google

4. Configurando el proyecto Android con la API de Google Maps

Primero abrimos el AndroidManifest.xml de la aplicación y agregamos las siguientes líneas dentro de la etiqueta application:

<meta-data
    android:name="com.google.android.gms.version"
    android:value="4323000" />
<meta-data
    android:name="com.google.android.maps.v2.API_KEY"
    android:value="my_api_key" /> 	

En donde my_api_key es la API key que copiamos hace un rato.

Los permisos necesarios para que la aplicación pueda acceder a los servicios de Google Maps:

    <permission
        android:name="com.desarrollolibre.googlemapsv1.permission.MAPS_RECEIVE"
        android:protectionLevel="signature" />
    <permission
        android:name="com.desarrollolibre.googlemapsv1.permission.C2D_MESSAGE"
        android:protectionLevel="signature" />
    <uses-permission android:name="com.desarrollolibre.googlemapsv1.permission.C2D_MESSAGE" />
    <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />;
    <uses-permission android:name="com.desarrollolibre.googlemapsv1.permission.MAPS_RECEIVE" />
    <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <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" />

La librería gráfica:

    <!-- opengl for maps -->
    <uses-feature
        android:glEsVersion="0x00020000"
        android:required="true" />

Reemplazamos el contenido del layout de la actividad por lo siguiente:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        class="com.google.android.gms.maps.SupportMapFragment"/>

Colocamos que la actividad herede de:

android.support.v4.app.FragmentActivity

5. Agregar Google Play Service al proyecto

Este paso puede resultar un poco confuso; ¿ya no agregamos el Google Play Service en el paso 2? la respuesta corta, no. Solo descargamos la SDK y la registramos dentro del proyecto; ahora falta agregarla al mismo:

Click derecho sobre el proyecto; en el menú emergente:

Android Tools >> Add Support Library:

eclipse menu add support library

Ahora referenciamos en el proyecto la librería que acabamos de importar; click derecho sobre el proyecto; en el menú emergente:

Properties >> Android >> google-play-service_lib:

agregar google play service al proyecto android

6. Ejecutar la aplicación

Si has seguido los pasos anteriores, al ejecutar la aplicación deberías ver una pantalla similar a la siguiente:

ejemplo de google maps corriendo en un dispositivo android

En el próximo artículo veremos como agregar los marcadores (Markers) en el mapa e interactuar con ellos.

Ayúdanos a seguir creciendo

Publicidad

Give me for a beer!

Algunos recursos que te pueden interesar

Paleta de colores para el Material Design

Paleta de colores para el Material Design

Creando increibles Drawer en Android con MaterialDrawer

Creando increibles Drawer en Android con MaterialDrawer

Librería oficial de PayPal para Android

Librería oficial de PayPal  para Android

Algunos artículos que te pueden interesar

Geolocalización con JavaScript y Google Maps

Geolocalización con JavaScript y Google Maps

Utilizando la API de Google Maps para mostrar la ubicación del usuario.

Andrés Cruz 30-09-2013

Lo nuevo del Material Design: el Snackbar

Lo nuevo del Material Design: el Snackbar

En esta entrada veremos cómo emplear el Snackbar el cual da la posibilidad de revertir algunas de las operaciones críticas que se han realizado, como borrar un correo en el caso de Gmail.

Andrés Cruz 14-09-2015

Cómo generar una apk en Android Studio para la Google Play

Cómo generar una apk en Android Studio para la Google Play

Se explica como generar una apk firmada que puede ser empleada para subir a la Google Play desde Android Studio.

Andrés Cruz 30-11-2016