30/8/2014 Google Earth Solidario

https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 1/11
Google Earth Solidario
Introduccin a la recopilacin de datos
mviles con ODK
Cada vez es mayor el nmero de organizaciones que utilizan dispositivos mviles para recopilar
datos sobre el terreno. Open Data Kit (ODK) es un conjunto de herramientas que permiten
recopilar datos a travs de dispositivos mviles Android y enviar datos a un servidor online
aunque no se disponga de conexin a Internet o de acceso a una red mvil en el momento de
recopilar los datos. Optimiza el proceso de recopilacin de datos con ODK Collect sustituyendo
los formularios en papel tradicionales por formularios electrnicos que permiten subir texto, datos
numricos, GPS, fotos, vdeos, cdigos de barras y audio a un servidor online. Puedes alojar tus
datos online a travs de App Engine, la potente plataforma de alojamiento de Google,
administrarlos a travs de ODK Aggregate y verlos como un mapa con Google Fusion Tables y
Google Earth.
Creado por desarrolladores del departamento de Ingeniera y Ciencias Informticas de la
Universidad de Washington y por miembros de Change, Open Data Kit es un proyecto de
software libre disponible para el pblico general. En la pgina del proyecto ODK del sitio Google
Code, puedes obtener ms informacin para desarrolladores, consultar ms tutoriales y
actualizaciones recientes, y contribuir al proyecto.
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 2/11
En esta imagen, aparecen datos recopilados de forma remota con Open Data Kit y mostrados en
Google Fusion Tables.
Contenido del tutorial:
Requisitos previos
Empecemos
Cmo crear formularios con ODK Build
Cmo crear una instancia de App Engine
Cmo restringir permisos de instancias de App Engine para aumentar la seguridad
Cmo subir formularios a tu instancia de App Engine
Debate y comentarios
Siguientes pasos
Requisitos previos
No es necesario tener conocimientos de programacin.
Necesitars un dispositivo mvil con conexin a Internet que ejecute Android OS 1.6 o una
versin ms reciente.
Tambin necesitars una cuenta de Google para crear una instancia de Google App Engine
(haz clic aqu para obtener una cuenta).
Debers tener instalado y ejecutndose en tu ordenador Java 6 para poder utilizar ODK
Aggregate (puedes descargar la aplicacin en esta pgina de forma gratuita).
Empecemos
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 3/11
1. Busca la aplicacin "ODK Collect" en Google Play en tu dispositivo mvil o en Google Play en
tu navegador. Instala la versin ms reciente en tu dispositivo mvil. Para obtener ms
informacin sobre ODK Collect y sus requisitos, accede a la pgina del proyecto ODK.
2. Descarga el formulario Sample que se va a utilizar durante el tutorial.
Cmo crear formularios ODK con ODK Build
Existen varias formas de crear formularios para ODK. Puedes utilizar ODK Build, XLSforms y
crear formularios XML. Si es la primera vez que creas un formulario, ODK Build puede ser la
forma ms sencilla de empezar, y podrs aprender a utilizarlo con este tutorial. Para crear
formularios ms complejos, consulta la documentacin incluida en la pgina de Formhub
University sobre XLSforms.
1. Accede a ODK Build a travs de la pgina http://build.opendatakit.org.
2. Crea una cuenta nueva o inicia sesin con una cuenta que ya tengas. Recuerda que esta
cuenta es diferente de la cuenta de Google y que puedes utilizar otra contrasea y otras
credenciales de inicio de sesin. Los formularios se guardarn en esta cuenta para que
puedas consultarlos en un futuro.
3. Para aadir preguntas a tu formulario, haz clic en el tipo de preguntas que quieras aadir
(por ejemplo, ubicacin, texto, etc.) en la parte inferior de la pgina.
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 4/11
Cada pregunta tiene varias propiedades comunes, as como propiedades nicas. Para
obtener una explicacin de las propiedades comunes, consulta la informacin que se indica
a continuacin. No necesitas guardar cada pregunta que introduzcas, pero ten en cuenta
que debes guardar el formulario una vez que hayas acabado.
4. Introduce el texto de una pregunta (por ejemplo, "Cmo te llamas?") en la seccin "Caption
Text" (Texto de ttulo).
Rellena las propiedades de la pregunta del campo de texto situadas en la parte derecha de
la pantalla. Opcional: puedes introducir un lmite de caracteres mnimo y mximo para el
campo de texto.
5. Introduce un campo numrico para permitir a los usuarios registrar un nmero en su
formulario (por ejemplo, "Qu edad tienes?") en la seccin "Caption Text" (Texto de ttulo).
En la seccin de propiedades, especifica si quieres registrar el nmero como "Integer"
(Nmero entero) o "Decimal" (0.0).
6. Permite a los usuarios especificar una fecha (Date) en el formulario. El telfono registrar
automticamente la fecha actual y permitir al usuario introducir la fecha o modificarla en tu
formulario.
7. Si los usuarios del formulario tienen un dispositivo mvil con un conjunto de chips de GPS,
puedes aadir una entrada "Location" (Ubicacin) al formulario. La pregunta pedir al
usuario que registre la ubicacin GPS. El usuario podr ver una estimacin de la precisin
del GPS integrado en el telfono mientras el GPS adquiere las posiciones del satlite.
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 5/11
8. Permite a los usuarios del formulario adjuntar archivos de medios a los formularios
enviados. Puedes seleccionar las opciones "Image" (Imagen), "Audio" (Audio) o "Video"
(Vdeo) para el formato del archivo de medios. El formulario cambiar al modo de cmara,
al modo de grabacin de voz o al modo de cmara de vdeo del dispositivo, y el archivo de
medios se almacenar con esta entrada de formulario. Por ejemplo, introduce "Take a
photo" (Hacer una foto) en la seccin "Caption Text" (Texto de ttulo) y selecciona "Image"
(Imagen) en el men desplegable como el tipo de archivo de medios que utilizars.
Sugerencia: si sabes que la conexin a Internet va a ser lenta cuando subas el formulario y
quieres que los formularios incluyan fotos, algunos dispositivos te permiten reducir el
tamao predeterminado de la imagen para que el tamao del archivo sea ms pequeo
cuando enves datos completos a travs de Internet.
9. Utiliza el tipo de pregunta "Choose One" (Seleccionar una) si quieres que el usuario
seleccione una opcin entre varias. Para especificar las opciones que ofreces, haz clic en
"Add Option" (Aadir opcin). Asegrate de aadir un valor subyacente (Underlying Value) a
las opciones; es obligatorio aadir uno a cada opcin. Utiliza texto en minscula y guiones
bajos (_) en lugar de espacios.
10. Utiliza el tipo de pregunta "Choose Multiple" (Seleccionar varias) para preguntas de
seleccin mltiple. Al igual que ocurre con la opcin "Choose One" (Seleccionar una),
asegrate de aadir un valor subyacente a cada opcin y utiliza minsculas y guiones bajos
para los campos de valores subyacentes.
Propiedades comunes en preguntas de formularios
Data name (Nombre de los datos) (obligatorio): es un nombre variable que se
almacena en el cdigo XML del formulario. Debes utilizar minsculas y
guiones bajos (_) en lugar de espacios.
Caption Text (Texto de ttulo) (obligatorio): permite introducir la pregunta
como quieras que la vea el usuario.
Hint (Sugerencia): especifica texto de ayuda o una sugerencia para la
pregunta. Nota: si vas a localizar tu formulario, debes introducir texto en ingls
y texto localizado en esta seccin. Si no quieres introducir texto
predeterminado en ingls, debes crear los formularios en formato XML en un
editor de texto. Consulta la sugerencia que aparece al final de este tutorial
para obtener ms informacin sobre cmo localizar formularios.
Default value (Valor predeterminado): se trata de la informacin
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 6/11
predeterminada que se presentar al usuario. Por ejemplo, si vas a recopilar
informacin de un grupo de nios y sabes que la mayora de los nios tiene
12 aos, puedes introducir "12" como valor predeterminado.
Read-only (Solo lectura): si no quieres que el usuario introduzca informacin
en la pregunta, activa esta casilla.
Required (Obligatorio): los usuarios no podrn guardar un formulario como
completo a menos que hayan introducido informacin en las preguntas
marcadas como obligatorias.
11. Cuando ests satisfecho con el formulario, gurdalo en tu cuenta de ODK Build. Selecciona
File > Save Form As (Archivo > Guardar formulario como). La prxima vez que inicies
sesin en tu cuenta podrs seleccionar File > Open (Archivo > Abrir) para abrir el formulario.
12. To download the form to your computer, select File > Export as XML. You will see xml code.
Click the "Download" button to save the file to your computer as an .xml file. This is the format
that you will import onto your mobile device in the next step.
Tip: One of the advantages of ODK is that you can create localized forms. The functionality to
create localized forms in ODK Build doesn't exist yet, but you can look at these sample forms
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 7/11
(and the Widgets form in particular) as guides to creating your own XML forms that are
localized.
Las preguntas ramificadas, en las que la segunda pregunta de seguimiento depende de la
respuesta a la primera pregunta, tambin se deben escribir en XML. Ten en cuenta que es
ms complicado mostrar datos de preguntas ramificadas en Google Fusion Tables y
Google Earth.
Si quieres obtener ms informacin sobre cmo crear tus propios formularios con XML,
consulta la gua de formacin de XForms de JavaRosa.
Cmo crear una instancia de App Engine
Google App Engine permite alojar fcilmente tus aplicaciones y los datos de tus aplicaciones en
un servidor online. Obtn ms informacin sobre App Engine y consulta las Condiciones de
servicio.
En este tutorial, aprenders a configurar tu propio servidor con la infraestructura de App Engine y
ODK Aggregate. ODK Aggregate te permite configurar un servidor listo para implementarse en el
que podrs subir tus formularios, exportarlos como archivos .csv y enviarlos a otros servicios,
como Google Fusion Tables.
1. En primer lugar, tendrs que configurar una cuenta de Google App Engine. Si es la primera
vez que utilizas App Engine, Google te enviar un mensaje de texto para confirmar tu
identidad, por lo que debes tener un telfono que admita mensajes de texto. Nota: un
nmero de telfono determinado solo se puede utilizar una vez para crear una instancia de
App Engine (ms informacin sobre la verificacin por SMS).
2. Una vez que hayas confirmado tu nmero de telfono mvil y hayas iniciado sesin, haz clic
en "Create an Application" (Crear una aplicacin).
3. Si es necesario, verifica tu cuenta a travs de un mensaje de texto SMS.
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 8/11
4. Asigna un identificador a tu aplicacin. Este identificador formar parte de la URL de tu
instancia de App Engine (por ejemplo, "miurl.appspot.com").
Si quieres restringir los permisos de los usuarios que pueden acceder a los datos, consulta
la seccin sobre seguridad que se indica a continuacin. Puedes editar la configuracin de
seguridad en este paso.
En este tutorial, utilizaremos la opcin predeterminada "Open to all Google Account Users"
(Abierto para todos los usuarios de Cuentas de Google). Una vez que hayas introducido un
identificador, recibirs la confirmacin de que tu aplicacin se ha registrado correctamente.
5. Descarga la versin ms reciente de ODK Aggregate en la pgina de descargas de ODK.
6. Descomprime el archivo (haz clic en el archivo incluido en la carpeta "Descargas" de un
ordenador Mac o haz clic con el botn derecho y descomprmelo en un PC). El archivo se
descomprimir como una carpeta denominada "ODKAggregate-versin-SO-installer".
7. Haz doble clic para ejecutar la aplicacin. Aparecer el asistente de configuracin de ODK
Aggregate. Haz clic en "Next" (Siguiente).
8. Tendrs que aceptar el acuerdo de licencia de ODK Aggregate. A continuacin, selecciona
la ubicacin de tu ordenador en la que quieras que los archivos del programa de instalacin
almacenen el software que se ejecutar en Google App Engine.
9. Ejecuta el asistente de configuracin. Introduce el nombre de la instancia de ODK (por
ejemplo, "odktutorial" para odktutorial.appspot.com) y la cuenta de Google asociada a esa
instancia.
10. Una vez que el asistente de configuracin haya terminado de configurar ODK Aggregate, se
te pedir que ejecutes la secuencia de comandos de instalacin.
11. Debers volver a introducir la cuenta de Google y la contrasea asociadas a la instancia de
App Engine.
12. La secuencia de comandos puede tardar entre tres y diez minutos en ejecutarse. Una vez
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 9/11
que haya finalizado, aparecer un mensaje que confirmar la correcta instalacin. Si te has
equivocado al introducir la informacin en el asistente de configuracin, te encontrars en
este paso. Para volver a ejecutar el asistente de configuracin, vuelve a la carpeta en la que
est instalado ODK Aggregate y haz doble clic en el programa de instalacin para volver a
ejecutarlo.
13. Enhorabuena! Cuando la secuencia de comandos termine de ejecutarse, ODK Aggregate
ya se habr instalado en tu instancia de App Engine. Cuando termine de ejecutarse, accede
a la URL de App Engine para comprobar que se ha configurado correctamente (por
ejemplo, miurl.appspot.com). Para iniciar sesin, puedes utilizar tu cuenta de Google o
hacer clic en "Anonymous Access" (Acceso annimo).
Cmo restringir permisos de ODK Aggregate para aumentar la seguridad
Desde el lanzamiento de ODK Aggregate 1.0.n, los usuarios disponen ahora de varias opciones
para configurar permisos de acceso a sus instancias de ODK Aggregate a travs de la interfaz
de administracin del sitio. Ahora, puedes decidir quin tiene acceso para enviar los datos
recopilados sobre el terreno, quin puede ver los datos enviados y quin puede editar datos y
publicarlos de forma externa. Podrs obtener ms informacin en el siguiente tutorial (Cmo
administrar tus datos con ODK Aggregate). Tambin puedes establecer restricciones a travs de
la instancia de App Engine, aunque este proceso es ms complejo que utilizar ODK Aggregate
para establecer permisos de acceso. Ms informacin sobre la autenticacin en App Engine
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 10/11
Cmo subir tus formularios a tu instancia de App Engine
Ahora que has configurado tu instancia de App Engine con ODK Aggregate, puedes subir tus
formularios (el ltimo paso antes de empezar a recopilar datos sobre el terreno con tus
formularios). Antes de empezar, revisaremos las tres pestaas principales de la interfaz de ODK
Aggregate, "Submissions" (Envos), "Form Management" (Gestin de formularios) y "Site Admin"
(Administrador del sitio), en el siguiente tutorial denominado Cmo recopilar datos mviles con
ODK Collect. Puedes subir un archivo XML que hayas descargado de ODK Build. ODK Build
tambin te permite enviar formularios directamente a tu instancia de ODK Aggregate sin
necesidad de descargar el archivo XML real.
1. Accede a tu instancia de App Engine (tambin puedes consultar un ejemplo que hemos
creado en la pgina http://odk-tutorial.appspot.com, aunque debes utilizar tu propia instancia
para subir tus formularios personalizados).
2. Inicia sesin con tu cuenta de Google si es necesario.
3. Haz clic en la pestaa "Form Management" (Gestin de formularios).
4. Selecciona el formulario que quieras subir a tu instancia y haz clic en "Upload" (Subir). Si
tienes archivos de medios que formen parte de tus formularios (por ejemplo, imgenes
incluidas en preguntas), tambin puedes subirlos a travs de esta opcin.
5. Si tu formulario se ha subido correctamente, puedes cerrar la ventana "Upload Forms"
(Subir formularios). Tus formularios aparecern ahora en la pestaa "Form Management"
(Gestin de formularios) y podrs aceptar envos.
Debate y comentarios
30/8/2014 Google Earth Solidario
https://www.google.es/intl/es/earth/outreach/tutorials/odk_gettingstarted.html 11/11
Tienes alguna pregunta acerca de este tutorial o algn comentario? Accede a la pgina del
grupo de debate de Google Earth Solidario para debatir este tema con otros usuarios.
Siguientes pasos
Accede al siguiente tutorial: Cmo recopilar datos mviles con ODK Collect.
Consulta la pgina de tutoriales en vdeo.
Consulta todos los tutoriales.