API de Google Maps para Android:

biblioteca externa
Para ayudarte a aadir potentes capacidades de creacin de mapas a tu aplicacin,
el complemento para las API de Google incluye una biblioteca externa de Google
Maps, com.google.android.maps. Las clases de la biblioteca de Google Maps
ofrecen descargas, procesamiento y almacenamiento en cach integrados de
mosaicos de Google Maps, as como numerosos controles y opciones de
visualizacin.
La clase clave de la biblioteca de Google Maps es MapView, una subclase
de ViewGroup de la biblioteca estndar de Android. Una clase MapView muestra
un mapa con datos obtenidos del servicio de Google Maps. Cuando la clase
MapView est enfocada, puede capturar pulsaciones de teclas y formas de tocar la
pantalla para desplazar y acercar o alejar el mapa de forma automtica, incluso
administrar solicitudes de redes para obtener mosaicos de mapas adicionales.
Tambin proporciona todos los elementos de interfaz de usuario que necesitan los
usuarios para controlar el mapa. Tu aplicacin solo puede utilizar los mtodos de
clase MapView para controlar MapView mediante programacin y dibujar algunos
tipos de superposiciones (Overlay) en la parte superior del mapa.
En general, la clase MapView proporciona un envoltorio alrededor del API de
Google Maps que permite a tu aplicacin manipular datos de Google Maps
mediante mtodos de clase y, adems, te permite trabajar con datos de Google
Maps como lo haras con otros tipos de vistas.
La biblioteca externa de Google Maps no forma parte de la biblioteca de Android
estndar, por lo que es posible que no se incluya en algunos dispositivos con
Android que cumplan los requisitos. Del mismo modo, la biblioteca externa de
Google Maps no se incluye en la biblioteca de Android estndar proporcionada en
el kit de desarrollo de software. El complemento para las API de Google
proporciona la biblioteca de Google Maps, de forma que puedes desarrollar, crear y
ejecutar aplicaciones basadas en mapas en el kit de desarrollo de software de
Android con total acceso a los datos de Google Maps.
Para utilizar las clases de la biblioteca externa de Google Maps en tu aplicacin,
debes realizar las siguientes acciones:

instalar el complemento para las API de Google tal y como se describe

en el documento sobre instalacin (si utilizas el kit de desarrollo de software de
Android, no necesitas instalar el complemento, ya se encuentra instalado
previamente en el paquete del kit de desarrollo de software),

configurar un nuevo proyecto de Android (o volver a configurar uno

existente) para que el proceso se lleve a cabo en el complemento para las API
de Google instalado,

establecer una configuracin de dispositivo virtual de Android que utilice

el complemento para las API de Google,

aadir un elemento uses-library al archivo de manifiesto de tu aplicacin

para hacer referencia a la biblioteca de Google Maps,

utilizar las clases de Google Maps en tu aplicacin,

obtener una clave de API de Google Maps para que tu aplicacin pueda
mostrar datos del servicio de Google Maps,

firmar tu aplicacin de forma adecuada mediante el certificado que

corresponda a tu clave de API.
En las secciones que aparecen a continuacin se proporciona ms informacin.

Cmo configurar un proyecto de Google

Maps
Una vez hayas instalado el complemento para las API de Google, podrs aadir
capacidades de Google Maps a cualquier proyecto de Android nuevo o existente.
Para que tu aplicacin pueda acceder a la biblioteca de Google Maps, lo nico que
tienes que hacer es establecer las propiedades del proyecto de forma que las
herramientas de creacin puedan localizar la biblioteca de Google Maps en el
complemento para las API de Google. El procedimiento para hacerlo depende de si
el proceso de desarrollo se realiza en Eclipse con el complemento ADT o si se lleva
a cabo mediante Ant.
A continuacin, se indica cmo establecer el objetivo de desarrollo si realizas el
proceso en Eclipse con ADT.

Si quieres aadir Google Maps a una aplicacin existente, haz clic con el
botn derecho en el proyecto del explorador de paquetes, selecciona la opcin
de propiedades, despus la opcin de Android y, a continuacin selecciona

un objetivo de desarrollo de la lista que se muestra. Debes seleccionar el

objetivo de desarrollo de las API de Google.

Si creas un proyecto de Android nuevo en Eclipse, el asistente para

proyectos nuevos te pedir que especifiques el objetivo de desarrollo de la
aplicacin. Debes seleccionar el objetivo de desarrollo de las API de Google.
Si el proceso de desarrollo se lleva a cabo en Ant, debes utilizar la herramienta de
Android incluida en el kit de desarrollo de software para establecer el objetivo de
desarrollo de tu proyecto.

En el caso de un proyecto existente, utiliza el comando android list

targets para que aparezcan los objetivos de desarrollo disponibles en tu kit de
desarrollo de software. Localiza el objetivo de desarrollo de las API de Google y
anota su ID. A continuacin, utiliza el comandoandroid update project
--target <targetID> --path path/to/your/project/ para que el proyecto
utilice el objetivo del complemento para las API de Google.

En el caso de un nuevo proyecto, sigue los pasos descritos

anteriormente para que aparezcan los objetivos de desarrollo y utiliza el
comando android create project --target <targetID> --path
path/to/your/project/ para que el proyecto utilice el objetivo de las API de
Google.
Ten en cuenta que hay disponibles varias versiones del complemento para las API
de Google y que cada una est orientada a un nivel de API de la plataforma de
Android. Selecciona la versin con el nivel de API apropiado para tu aplicacin en
base al atributo android:minSdkVersion de esta, que se indica en el archivo de
manifiesto de la aplicacin.
Para obtener ms informacin sobre cmo trabajar con proyectos de Android,
consulta la pgina sobre cmo desarrollar aplicaciones en Eclipse con ADT o
sobre cmo desarrollar aplicaciones en otros entornos de desarrollo integrado , en
funcin de tu entorno, en el sitio de Desarrolladores de Android.
Para obtener ms informacin sobre los niveles de API y cmo utilizarlos, consulta
la pgina sobre los niveles de API para Android y la documentacin del elemento
de manifiesto <uses-sdk> .

Cmo configurar un dispositivo virtual de

Android
Una vez hayas creado tu proyecto, necesitas poder ejecutarlo, depurar los errores,
asignar un perfil y probarlo. Para ejecutar tu aplicacin basada en Google Maps en

el Emulador de Android, debes configurar un dispositivo virtual de Android para

que utilice el complemento para las API de Google. Para configurar el dispositivo
virtual de Android, utiliza el administrador del dispositivo virtual de Android.
Inicia el administrador del dispositivo virtual de Android con el
comando android son ninguna opcin. Si llevas a cabo el proceso en Eclipse/ADT,
tambin puedes acceder a la herramienta desde la ventana y, a continuacin,
accediendo al administrador del dispositivo virtual y al kit de desarrollo de
software de Android.
1.

Haz clic en el botn para crear un nuevo dispositivo virtual de Android.

2.

En el cuadro de dilogo que aparece, especifica un nombre para el

dispositivo virtual y selecciona el objetivo de imagen de sistema que quieres
que utilice el dispositivo. Selecciona uno de los objetivos de las API de Google
(Google Inc.) y asegrate de que eliges una versin cuyo nivel de API se
corresponda con el atributo android:minSdkVersion incluido en el manifiesto
de tu aplicacin, tal y como se ha indicado anteriormente.

3.

Configura las otras opciones y, a continuacin, haz clic en la opcin para

crear el dispositivo virtual de Android.
Cuando hayas terminado de crear el dispositivo virtual de Android, puedes
ejecutarlo desde la interfaz de usuario del administrador del dispositivo o utilizar la
interfaz de lnea de comando del emulador. Si llevas a cabo el proceso de
desarrollo en Eclipse, puedes establecer una configuracin de ejecucin para
iniciar el dispositivo virtual de Android e instalar tu aplicacin en l.
Para obtener ms informacin, consulta la seccin sobre dispositivos virtuales de
Android del sitio de Desarrolladores de Android.
Si tienes un dispositivo fsico con la plataforma adecuada (tal y como establece su
nivel de API) e incluye la biblioteca externa de Google Maps, siempre puedes
ejecutar tu aplicacin, depurar los errores de esta y probarla en este dispositivo en
lugar de en el emulador. Para obtener ms informacin, consulta la pgina
sobre cmo desarrollar una aplicacin en un dispositivo .

Cmo hacer referencia a la biblioteca de

Google Maps desde el archivo de manifiesto
de la aplicacin

Para utilizar las clases de la biblioteca externa de Google Maps en tu aplicacin,

debes hacer referencia a la biblioteca desde el archivo de manifiesto de la
aplicacin. De forma especfica, debes aadir un elemento <uses-library> como
elemento secundario del elemento<application>, con un
atributo android:name cuyo valor sea com.google.android.maps. A continuacin
se muestra un ejemplo:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.package.name">
...
<application android:name="MyApplication" >
<uses-library android:name="com.google.android.maps" />
...
</application>
...
</manifest>

La referencia <uses-library> es obligatoria debido a que permite que las

herramientas de creacin vinculen tu aplicacin a la biblioteca externa de Google
Maps. Tambin garantiza que el sistema Android no instale tu aplicacin en un
dispositivo si no est disponible la biblioteca necesaria.

Cmo utilizar las clases de Google Maps en

tu aplicacin
La biblioteca de Google Maps proporciona numerosas clases que te permiten
mostrar y manipular datos de Google Maps en tu aplicacin. Antes de empezar,
primero echa un vistazo a los elementos disponibles en el
paquete com.google.android.maps.
La clase clave de la biblioteca es MapView, una subclase de ViewGroup de la
biblioteca estndar de Android. La clase MapView muestra datos de mapas del

servicio de Google Maps y se encarga de la interaccin con el servicio. Adems,

incluye todos los elementos de interfaz de usuario necesarios para que el usuario
controle el mapa y tambin proporciona mtodos que permiten a tu aplicacin
manipular el mapa, dibujar superposiciones, etc.
Para utilizar Google Maps en tu aplicacin, ampla la clase MapActivity y, a
continuacin crea una distribucin que incluya un elemento MapView. Para hacerte
una idea sobre cmo configurar un elemento MapView, consulta este tutorial del
sitio de Desarrolladores de Android.
Si quieres ver un cdigo de ejemplo, el complemento para las API de Google
incluye una aplicacin de ejemplo denominada MapsDemo que puedes cargar en
tu entorno de desarrollo y ejecutarla. La aplicacin est ubicada en el directorio de
las API de Google.
<sdk>/add-ons/google_apis-<api-level>/samples/MapsDemo
Ten en cuenta que, para que los objetos MapView puedan mostrar datos del
servicio de Google Maps, debes registrarte en el servicio y recibir la clave de API de
Google Maps, tal y como se describe a continuacin.

Cmo obtener una clave de API de Google

Maps
Si no ests familiarizado con el modo en que se firman las aplicaciones de Android,
consulta la pgina sobre cmo firmar aplicaciones del sitio de Desarrolladores de
Android.
Los objetos MapView muestran mosaicos de Google Maps descargados desde el
servicio de Google Maps. Para poder utilizar datos de Google Maps, debes
registrarte en el servicio de Google Maps, aceptar las Condiciones de servicio y
proporcionar una huella digital MD5 de los certificados que utilizars para firmar tu
aplicacin. Para cada huella digital de certificado registrada, el servicio te
proporciona una clave de API de Google Maps (una cadena alfanumrica que
identifica tu certificado y a ti de forma nica). A continuacin, debes almacenar la
clave de API en los objetos MapView, de forma que cuando soliciten datos de
Google Maps, el servidor pueda determinar que te has registrado en el servicio.
Para obtener informacin detallada sobre cmo obtener y utilizar una clave de API
de Google Maps, consulta esta seccin.

Si no almacenas una clave de API de Google Maps vlida en los elementos

MapView, puedes compilar y ejecutar la aplicacin, pero los elementos MapView no
podrn mostrar datos del servidor de Google Maps. Por esta razn, debes
registrarte para obtener una clave de API tan pronto como sea posible una vez
hayas comenzado el proceso de desarrollo. El registro es gratuito y solo te llevar
unos minutos.
Ten en cuenta que cada clave de API de Google Maps est asociada de forma nica
con un certificado de firma especfico. Es decir:

Cuando inicias el proceso de desarrollo, puedes registrarte utilizando el

certificado de depuracin de errores que crean las herramientas del kit de
desarrollo de software.

Cuando ests preparado para publicar tu aplicacin, debes registrarte de

nuevo utilizando el certificado con el que firmars tu aplicacin para publicarla.
A continuacin, debes actualizar los elementos MapView de forma que hagan
referencia a la clave de API de publicacin, en lugar de a la clave de depuracin
de errores y, a continuacin, firma tu aplicacin con el certificado de
publicacin.

Cmo firmar tu aplicacin con el certificado

adecuado
Si has seguido los pasos que se indican en la seccin Cmo obtener una clave de
API de Google Maps, el paso final para permitir la visualizacin de datos de Google
Maps es firmar tu aplicacin con el certificado adecuado. El certificado que utilices
para firmar tu aplicacin debe coincidir con el certificado asociado a la clave de
API en los objetos MapView. Por ejemplo:

Si los objetos MapView hacen referencia a una clave de API que has
obtenido registrando el certificado de depuracin de errores, debes firmar la
aplicacin con este certificado.

Si quieres firmar la aplicacin para publicarla, los objetos MapView deben

hacer referencia a una clave de API que hayas obtenido registrando el
certificado de publicacin.
El servicio de Google Maps permite que los objetos MapView descarguen datos
nicamente si se identifican con la clave de API correspondiente al certificado con
el que se firma la aplicacin. Por esta razn, recuerda que debes actualizar la clave

de API de Google Maps a la que hacen referencia los objetos MapView siempre que
cambies los certificados de firma.