Mapeo es un conjunto de herramientas gratuito, fácil de usar y de código abierto para recopilar y mapear información.

Mapeo fue creado por Digital Democracy con y para personas defensoras de la tierra para documentar fácilmente información ambiental y de derechos humanos y recopilar datos sobre su tierra. Fue diseñado para funcionar en entornos completamente fuera de línea, es altamente personalizable y se basa en una base de datos de pares (peer-to-peer) descentralizada que permite a las comunidades poseer sus propios datos.

Sobre esta guía

Este sitio ofrece una introducción a las herramientas de Mapeo y una colección de recursos técnicos y de capacitación para ayudar a las personas usuarias de Mapeo.

El sitio está dividido en las siguientes secciones:

• Visión de conjunto Información básica sobre las herramientas de Mapeo

• Guía de inicio rápido Instrucciones para instalar y probar la funcionalidad predeterminada de Mapeo

• Guía de referencia completa Una colección completa de recursos para la planificación e implementación de proyectos de Mapeo y la personalización de las herramientas

Uso de esta guía

A Digital Democracy le gustaría que tanto Mapeo como los materiales de referencia de Mapeo que desarrollamos ayuden a las comunidades a encontrar formas de apoyar la autonomía, la accesibilidad y la colaboración en sus proyectos. Sabemos que las personas que accedan a este recurso en línea tendrán diversos intereses, objetivos, necesidades y conocimientos técnicos. Por esta razón, existe una variedad de caminos para acceder a la información y niveles de detalles que los usuarios pueden estar buscando. Todas las páginas de esta guía también se pueden guardar en formato PDF e imprimir para usarlas sin conexión.

Siéntase libre de hacer uso de estos recursos bajo los términos de la licencia creative commons: Attribution-NonCommercial 4.0 International.

Traducción Nos esforzamos por hacer que nuestras herramientas y recursos sean accesibles y estén disponibles para las comunidades en sus idiomas locales. Si desea contribuir a la traducción de esta guía, consulte la sección Traducir Mapeo para saber cómo comenzar.

Desarrollo de código abierto Mapeo y todo el desarrollo técnico de Digital Democracy es de código abierto. Visita la sección PARA DESARROLLADORES para más información.

Mapeo es un proyecto de Digital Democracy, una organización sin fines de lucro que trabaja en solidaridad con comunidades marginalizadas para usar la tecnología para defender sus derechos. Para obtener más información sobre Digital Democracy y cómo apoyar nuestro proceso de desarrollo conjunto centrado en el usuario, visite nuestro sitio web.

Mapeo es un conjunto de herramientas digitales, diseñado para respaldar la recopilación de datos y el mapeo colaborativo en entornos fuera de línea.

Hay dos aplicaciones de Mapeo altamente personalizables que se pueden usar juntas o individualmente, según sus objetivos:

• Mapeo Mobile

• Mapeo Desktop

Mapeo Mobile y Desktop se basan en Mapeo Core, una base de datos de pares (peer-to-peer) integrada que permite a los usuarios poseer sus propios datos directamente en sus dispositivos, sin necesidad de una conexión a Internet o de compartir información con un servidor centralizado.

Mapeo Mobile

Mapeo Mobile es una aplicación para celulares (actualmente solo para Android) que permite recopilar y mapear información. Usando el GPS de tu teléfono, puedes marcar puntos en un mapa para tu ubicación actual y agregar fotos, notas y otros detalles sobre lo que está sucediendo. La información se puede compartir con colaboradores que utilizan Mapeo o con contactos externos a través de correo electrónico u otras aplicaciones de mensajería.

Mapeo Mobile puede traducirse a los idiomas locales, personalizarse para usar mapas sin conexión y adaptarse para recopilar tipos específicos de información.

Mapeo Desktop

Mapeo Desktop es una aplicación informática que permite agregar, ver y administrar los datos recopilados con Mapeo Mobile. Los datos de Mapeo Desktop se pueden compartir con colaboradores que usan Mapeo o exportarse a informes PDF, archivos CSV, archivos GeoJSON o publicarse en la web usando mapas web de Mapeo.

Mapeo Desktop también ofrece una interfaz simple para agregar o crear información territorial para hacer mapas. Proporciona un conjunto básico de funciones de mapeo que son más accesibles para los nuevos usuarios de tecnología que otras herramientas de información geográfica disponibles, pero exportar mapas requiere conocimiento de otro software.

Al igual que Mapeo Mobile, Mapeo Desktop puede traducirse a los idiomas locales, personalizarse para usar mapas sin conexión y adaptarse para recopilar tipos específicos de información.

Mapeo Core

Mapeo Mobile y Mapeo Desktop están construidos sobre Mapeo Core para almacenar de forma segura los datos geográficos, los detalles y los medios creados por los usuarios. Mapeo Core es una base de datos integrada de pares (peer-to-peer) que permite a los usuarios poseer sus propios datos, directamente en sus dispositivos, sin necesidad de una conexión a Internet o de compartir información con un servidor centralizado.

Mapeo Core se basa en Hypercore, que es un registro solo de acciones para agregar (crear, editar, eliminar datos). Los datos están protegidos por pruebas criptográficas: cada registro escrito tiene una firma que también hace referencia a la firma de cada registro/fila anterior en el registro, por lo que nunca podrá cambiar o editar nada que ya esté escrito en el registro. Para obtener más información sobre Mapeo Core y la integridad de los datos, consulte aquí.

En las siguientes páginas, encontrará una colección de recursos que lo ayudarán a iniciar un proyecto de Mapeo.

• Planeando un proyecto de Mapeo

• Evaluación de riesgos y seguridad (Próximamente)

• Creando protocolos de usuario (Próximamente)

Puede encontrar información adicional sobre cómo ejecutar capacitaciones en Mapeo en Capacitaciones en Mapeo.

Puede que sea demasiado pronto para empezar a pensar en los resultados, pero si ya tiene una idea de cuáles podrían ser, podrían proporcionarle una dirección útil para su proceso de planificación. Por resultados no nos referimos a la meta o los resultados de su proyecto, aunque estos pueden superponerse, nos referimos particularmente a los materiales concretos que resultan de su proyecto Mapeo.

Por ejemplo estos podrían ser:

• Mapa/mapas impresos: Estos pueden ser para una audiencia externa, como el gobierno o un organismo legal, o pueden ser para que la comunidad misma los use para otros fines. Si planea crear un mapa, considere qué información puede mostrar en el mapa; tal vez pasa mucho tiempo recolectando datos y le es difícil encontrar espacio, o recolecta tanta información que el mapa es difícil de leer.

• Informes de datos: es posible que desee producir informes regulares sobre los datos que recolecta, o esperar hasta el final de su proyecto y luego producir un informe con todos los datos o los aspectos más destacados. ¿Sus informes incluyen datos cuantitativos (cantidades) que desea analizar y presentar de una manera particular o son principalmente datos cualitativos (descripciones) que deberán editarse o compilarse antes de ser presentados? Pensar en esto puede ayudarlo a organizar sus equipos y la recolección de datos para que tenga los datos cuando los necesite, en el formato correcto.

• Alertas: si está recolectando evidencia de algo que necesita una acción rápida, entonces podría ayudar tener un sistema de alertas integrado en su metodología. Mapeo Mobile puede exportar puntos de datos a WhatsApp y otras aplicaciones para que pueda enviar alertas de ilegalidades directamente a las fuerzas del orden para que tomen medidas inmediatas.

• Mapa web interactivo: este podría ser un buen resultado si espera crear una campaña y desea compartir parte del proyecto con el público o los medios de comunicación, o incluso para su propia comunidad, como un recurso educativo o narrativo. También permite presentar más tipos diferentes de información que en un mapa impreso, ya que puede incluir videos y audio más fácilmente. Sin embargo, puede implicar un nivel de experiencia técnica o presupuesto más allá del alcance de su proyecto, y definitivamente no es el resultado adecuado para todos los objetivos.

Cuando hayas aclarado el objetivo principal del proyecto, el siguiente paso es pensar detenidamente qué datos desea recolectar o crear. Esto no solo dependerá del objetivo final, sino también de otros factores, como el tiempo y los fondos disponibles, la situación de seguridad y las pautas legales. Por lo tanto, puede ser una buena idea volver a leer esta sección después de leer la sección Cuáles son los parámetros?

Dependiendo de sus necesidades y capacidad, es posible que la configuración predeterminada y las categorías que vienen con Mapeo funcionen lo suficientemente bien, o es posible que desee establecer una configuración personalizada con sus propios íconos y preguntas adaptadas a sus necesidades específicas. Para obtener más información sobre cómo hacer esto, consulte Creando configuraciones personalizadas. Tal vez, si su proyecto es nuevo y todavía está averiguando qué se necesita, es posible que desee comenzar a recolectar datos utilizando las configuraciones predeterminadas y durante el proceso pensar sobre qué categorías y preguntas realmente necesita.

La respuesta simple a la pregunta de qué información recolectar es probablemente bastante obvia a partir de su objetivo, pero cuando profundiza, la respuesta no siempre es tan fácil. Por ejemplo, si necesita un mapa del territorio para un reclamo de tierras, entonces probablemente necesite recolectar información sobre el uso del territorio, así como los límites o límites del territorio, pero exactamente qué información necesita, en qué formato debe estar, con cuánto detalle. necesita, etc. Y si desea recopilar evidencia de minería de oro ilegal, puede recopilar fotos georreferenciadas y responder una serie de preguntas sobre la escala y la naturaleza de los impactos encontrados, pero ¿cuál es la mejor manera de enmarcar las preguntas? para obtener las respuestas, su comunidad y tal vez el equipo legal necesitan evaluar lo que está sucediendo y cómo tomar medidas, y ¿de qué debería tomar fotos exactamente?

La recopilación de datos puede ser un proceso costoso y lento, y puede aumentar las expectativas sobre los resultados. Por lo tanto, pensar esto detenidamente con anticipación le ayudará a asegurarse de que a) no desperdicie su tiempo y recursos ni los de otros recolectando información que no será útil y b) no se encuentre en la situación en la que se da cuenta al final de un mes de viaje que necesita volver a todos los lugares nuevamente porque olvidó recopilar un dato crucial.

Piense en las siguientes preguntas para aclarar más exactamente qué datos debe recolectar y cómo configurar cualquier configuración personalizada:

• Primero piensa en tu objetivo y en lo que sabes de tus necesidades. Haga una lluvia de ideas con cualquier otro miembro del equipo o con la comunidad sobre todas las posibles cosas sobre las que podría recolectar información, categorías y preguntas, y luego comience a organizar y refinar.

• Si es posible, investigue hablando con aliados o buscando en línea para ver cómo se establecieron otros proyectos similares y qué datos recopilaron.

• ¿Existen reglas, restricciones o pautas que puedan determinar el tipo de información que recopila y cómo garantizar que se pueda utilizar? Por ejemplo, algunos gobiernos/autoridades pueden requerir que los datos se recopilen en un formato GPS particular, o que sigan una plantilla de información particular, para que se acepten o se actúe fácilmente.

• Es posible que los datos deban usarse en un proceso legal, si es así, puede haber formas específicas de recolectarlos o preguntas adicionales que hacer, lo que permitirá que se usen de manera más efectiva. Si es posible, obtenga asesoramiento legal local sobre esto, ya que diferirá según el tipo de datos y el país en el que se encuentre.

• Saber cuando es demasiada información. Una vez que comienzas a hacer un mapa o recolectar información, es bastante divertido... tal vez demasiado divertido 🙂. Si tiene todo el tiempo del mundo, entonces esto puede no ser un problema, pero si las personas o las tierras están amenazadas, es posible que deba hacer concesiones en términos de limitar los datos que recolecta y centrarse en los que se necesitan con urgencia.

Instalar

Descargue Mapeo Desktop desde el sitio web de Mapeo y haga doble clic en el archivo para iniciar el instalador. Para obtener más información sobre la instalación, consulte Instalar Mapeo Desktop.

Mapeo Desktop para gestionar datos de Mapeo Mobile data (Modo observaciones)

El modo Observaciones en Mapeo Desktop está diseñado para ver, administrar y exportar datos recopilados con Mapeo Mobile. Los pasos a continuación cubrirán los conceptos básicos para probar el modo Observaciones.

Sincronizar datos de Mapeo Mobile

Para comenzar, sincronice los datos recopilados desde un dispositivo Mapeo Mobile. Para sincronizar a través de Wi-Fi, como se detalla a continuación, los dispositivos Mapeo Mobile y Mapeo Desktop deben estar cerca uno del otro.

Conectar a una red Wi-Fi

Entra el modo Sincronización

Empezar sincronización

Ver observaciones

Para ver los datos sincronizados, haga clic en Observaciones en el panel de modos de Mapeo.

Vista de Mapa

De forma predeterminada, las observaciones se muestran como puntos en un mapa. Haga clic en un punto individual para ver los detalles de esa observación.

Vista de Fotos

Para ver las observaciones como una galería de imágenes, haga clic en Fotos en la Barra de herramientas sobre el mapa. Haga clic en una imagen individual para ver los detalles de esa observación.

Vista de Informe

Para ver las observaciones en forma de informe, haga clic en Informe en la Barra de herramientas.

Filtrar observaciones

Para ver un subconjunto de sus observaciones en la vista de Mapa, Fotos o Informe, use el panel Filtros para seleccionar un rango de datos específico, un subconjunto de categorías o valores de datos específicos de los campos de detalles.

Editar observaciones

Con los detalles de la observación abiertos, haga clic en un campo para agregar o editar información. Haga clic en GUARDAR para guardar los cambios.

Borrar observaciones

Exportar datos

Los datos se pueden exportar a múltiples formatos desde el modo Observaciones en Mapeo Desktop. Las instrucciones básicas de exportación se incluyen a continuación.

• Guardar como Informe PDF

• Exportar a GeoJSON, CSV, o SMART CSV

• Exportar como Web Map (En la Guía de referencia completa)

Guardar como Informe PDF

Exportar a GeoJSON, CSV, o SMART CSV

Seleccione Exportar observaciones... luego seleccione el formato de datos deseado y las opciones en la ventana emergente Exportar observaciones. Haga clic en GUARDAR para nombrar el archivo de exportación y elija la ubicación en su computadora donde se guardará.

La Guía de inicio rápido está destinada a ayudarlo a instalar y probar la funcionalidad básica y por defecto de Mapeo para evaluar si le encajaría bien. Esta sección no cubre todas las funciones ni la personalización de las herramientas.

La Guía de referencia completa a continuación incluye información crítica sobre cómo diseñar e implementar un proyecto utilizando Mapeo, así como guías detalladas para la configuración y personalización de las herramientas. Recomendamos utilizarlo para iniciar una nueva iniciativa o como referencia para capacitaciones.

There are many tools and pieces of software that you could use for making maps and collecting data. Mapeo was designed to meet the needs of specific users, who:

• are collecting data in primarily offline environments

• often have limited previous experience with technology

• are working collaboratively on mapping or monitoring projects and using shared data sets

• want ownership over their data and the power to decide if and when data is shared with external actors or centralized servers

• have specific data collection requirements

• want to view and gather information in their native languages

• need a tool that is free to use

Mapeo may not be the right tool for all projects. When evaluating whether Mapeo will be a good choice, we encourage you to try out the tools (see the Quick Start Guide) and please keep in mind the following:

• Equipment requirements Mapeo Mobile is currently available for Android only. (An iOS version is in development for 2022.) Mapeo Desktop works on Windows, Mac and Linux machines. Mapeo Mobile uses Wi-Fi networks to synchronize data between devices. To synchronize data with Mapeo Mobile in offline areas, you will need a portable router (this does not require an internet connection) or a third device capable of creating a local network offline or hotspot.

• Peer-to-peer architecture The Mapeo tools are based on a peer-to-peer database, which means there is no centralized server aggregating information collected by users. Two devices that are participating in the same Mapeo project can synchronize or exchange data at a time. Synchronized devices have identical copies of the Mapeo database and can serve as backups if a device is lost or damaged. Please note that data that has not been synchronized will not have a backup. For more details on peer-to-peer architecture and syncing, see Base de datos de pares y sincronización de Mapeo. It is important to think through in advance how the participating users or devices in your project will share information, as there are a variety of possible synchronizing patterns. For more on this, see Creando protocolos de usuario.

• Customization and required technical skills Mapeo comes with out-of-the box options that can be used right away, without any customization. To learn more about whether these default options will work for your project, see Mapeo funcionará de inmediato para mí? Mapeo was also built to be highly customizable and allow users to adapt its interface to meet the needs of specific projects. Mapeo is currently available in many languages and can easily be translated into new ones. Adapting Mapeo to use custom categories, icons, questions and background maps currently requires significant technical knowledge and will not be accessible to all users. If you believe customization will be necessary for your project, please consult the section on Opciones de personalización to determine whether your team has the required technical skills.

• Security As an offline-first, peer-to-peer set of tools, Mapeo can offer a path for data collection and exchange with fewer technological vulnerabilities than other available tools. However, the use of any technology can introduce new security concerns and risks. Before choosing to use Mapeo or other alternatives, we strongly encourage reviewing the section on Evaluación de riesgos y seguridad.

Alternative tools

If Mapeo doesn't seem like the right fit for your needs, check out the Toolfinder on our Earth Defenders Toolkit site to learn more about other tools for territory mapping and monitoring.

Bien, parece que desea comenzar a recolectar información, tal vez para hacer un mapa, o tal vez desee recolectar evidencias de los impactos en su tierra o recolectar otros datos o información. La primera pregunta que debe hacerse claramente a usted mismo oa su comunidad es ¿POR QUÉ? ¿Qué es lo que espera ganar, cambiar o aprender a través del proyecto?

Cuanto más detallada sea la respuesta que pueda dar a esta pregunta, mejor preparad@ estará; asegurándose de que todas las personas involucradas en el proyecto estén trabajando hacia el mismo objetivo y poder determinar la mejor metodología para alcanzarlo.

Por ejemplo, si desea hacer un mapa, para qué es su mapa, qué impacto quiere que tenga para usted, su equipo, en el mundo, etc. Quizás el mapa sea el producto final, o quizás solo un paso en un proceso más largo, o tal vez el objetivo principal es construir relaciones, y el mapa es el medio para que las personas se centren en trabajar juntas.

¿Qué pasa si aún no lo sabes? Tal vez sepas que deseas recopilar datos sobre algo que le interesa, pero aún no estás seguro de cómo los vas a utilizar. No se preocupe, puede refinar su objetivo y desarrollar su proyecto a medida que avanza y aprende más.

Y recuerde: todos los planes cambian y es imposible predecir todo por adelantado. Habrá resultados imprevistos, algunos beneficiosos, algunos posiblemente desafiantes, en su proyecto. Sin embargo, tener en mente su objetivo principal al comenzar a planificar su metodología y definir qué información va a recopilar lo prepara para enfrentar cualquier desafío y aceptar cualquier cambio positivo de la mejor manera.

In terms of data types, Mapeo Mobile can collect:

• GPS points: so you can georeference particular points and places, and gather data associated with them. When saving a GPS point in Mapeo Mobile you need to categorize it with an icon.

• Photographs: photographs get tagged with the GPS point of their particular location - is this right? - as well as being attached to the place they are associated with.

• Details fields: if you set up a custom configuration you can add any number of questions into Mapeo so that you could carry out household surveys, collect quantitative information or evidence, or likewise write down detailed stories. Your questions can be text fields for open descriptions; select one or select many.

Mapeo Desktop can display and manage the above data types and additionally you can create georeferenced points, lines and areas with a basemap in the background. These data types can similarly have questions or fields associated with them that you fill in, and which can then be used for analysis.

Mapeo es un conjunto de herramientas gratuitas y fácil de usar para recopilar y mapear información.

Mapeo fue codiseñado y desarrollado con comunidades indígenas que enfrentan amenazas a sus tierras, como la minería ilegal de oro, la contaminación por petróleo y la caza furtiva. Fue creado para ayudar a los grupos en la primera línea de la defensa ambiental a documentar estas actividades con el fin de tomar medidas comunitarias contra ellas, reportar información clave a las autoridades, presentar demandas, lanzar campañas en los medios o crear mapas para reclamos de tierras. Para obtener más información sobre cómo se utiliza actualmente Mapeo, consulte ¿Cómo se está usando Mapeo?.

Mapeo es un software de código abierto que se beneficia de la retroalimentación y comentarios continuos de nuestros usuarios en todo el mundo.

Funciones clave de Mapeo

• Fácil de usar y aprender Incluso si nunca antes has usado un teléfono inteligente, puedes aprender a recopilar datos, puntos de GPS y fotos con Mapeo Mobile en unas pocas horas. Mapeo Desktop requiere algunas habilidades informáticas, pero tiene una interfaz simple con un número limitado de funciones. Para análisis más complejos o trabajos de mapeo, puedes exportar tus datos a otras herramientas. La simplicidad de las herramientas ayuda a respaldar la amplia participación de la comunidad y la propiedad de los proyectos.

• Funciona en entornos completamente fuera de línea Todos los datos recopilados o creados con Mapeo se almacenan directamente en tu dispositivo en la base de datos integrada de Mapeo, sin necesidad de una conexión a Internet o un servidor centralizado. Las personas usuarias de Mapeo Mobile y Desktop pueden sincronizar o intercambiar datos a través de una red Wi-Fi local. Los datos nunca salen de su red Wi-Fi local y no requieren una conexión a Internet. Mapeo Desktop también puede intercambiar información a través de un archivo utilizando una unidad USB.

• Utiliza una base de datos de pares, de igual a igual Todos los datos que recopilas con Mapeo se almacenan localmente en tu dispositivo, no en un servidor ni en Internet. Cuando sincronizas con otros usuarios de Mapeo en tu proyecto, cada uno obtiene una copia de los datos que cada persona ha recopilado, por lo que cada dispositivo termina con una copia completa de todos los datos del proyecto.

• Altamente personalizable Puedes personalizar el idioma, los mapas y el tipo de información que recopilas. Puedes agregar mapas detallados de tu área para su uso sin conexión y cambiar los íconos y las preguntas utilizadas para la recopilación de datos. Mapeo ya se ha traducido a varios idiomas y cualquiera puede agregar más.

• Datos seguros e infalsificables Todos los datos recopilados con Mapeo tienen registros encriptados cuya autenticidad se puede verificar. Similar a una cadena de bloques, los datos están protegidos por pruebas criptográficas, por lo que puedes verificar que ninguna entrada en el registro haya sido modificada o manipulada. Los proyectos privados se pueden crear utilizando claves de proyecto seguras que limitan con quién se pueden sincronizar los datos.

Mapeo está siendo utilizado actualmente por una variedad de comunidades en todo el mundo para respaldar los esfuerzos de monitoreo y mapeo de territorios. Abajo hay algunos ejemplos. Para obtener estudios de casos más detallados, historias de nuestros socios e información sobre otras herramientas para el mapeo y el monitoreo, visite nuestro sitio web de Earth Defenders Toolkit.

Monitoreo ambiental en Perú

Los monitores de la comunidad indígena que trabajan dentro de ECA Amarakaeri en el sureste de Perú están utilizando Mapeo Mobile y Desktop como parte de un programa de cogestión de una reserva comunal. Junto con los guardaparques, recopilan datos sobre la extracción ilegal de oro y otros impactos en la reserva y los utilizan para la toma de decisiones y acciones internas, así como para compartir con las autoridades cualquier ilegalidad que se aborde.

Mapeo territorial en Kenia

El Pueblo Indígena Ogiek del Monte Elgon está utilizando Mapeo Mobile y Desktop para mapear sitios importantes en sus tierras como parte de un reclamo histórico de tierras.

Mapeo ancestral en Ecuador

El pueblo Siekopai del norte de Ecuador usó Mapeo Desktop en sus aldeas para explorar imágenes satelitales de sus tierras ancestrales con las personas ancianas y documentar historias asociadas con lagos y asentamientos antiguos. Ver video.

Gestión del riesgo de desastres para poblaciones vulnerables al clima en Tailandia

Los voluntarios de salud de las aldeas en la costa de Tailandia están utilizando Mapeo para recopilar datos sobre personas vulnerables, a fin de garantizar que puedan recibir ayuda inmediata y específica en caso de un desastre natural.

La base de datos de pares (peer-to-peer) de Mapeo

A diferencia de las aplicaciones tradicionales donde todos los datos se almacenan en un servidor central (en la nube o en una oficina), la base de datos de Mapeo está integrada en la aplicación de su dispositivo, y cada dispositivo (celular o computadora) que participe en su proyecto puede tener una copia de todos los datos. Esto se llama una base de datos de pares. Tomamos esta decisión para que Mapeo pueda funcionar completamente fuera de línea y no requiera que el usuario configure ninguna base de datos o máquina para almacenar datos.

Esta base de datos de pares permite a los usuarios transferir datos a otros usuarios en el campo sin internet, y varios usuarios con computadoras o celulares pueden trabajar en el mismo conjunto de datos y compartir ediciones.

Características principales:

• Control y propiedad de los datos Los datos recopilados con Mapeo se almacenan directamente en los dispositivos utilizados para la recopilación de datos y se pueden compartir con otros celulares o computadoras que participen en el mismo proyecto. De esta manera, la información no existe únicamente en un dispositivo. Nadie más, ni siquiera nosotros, tiene acceso a estos datos. Las personas usuarias de Mapeo son dueñas de la información recolectada y tienen control total sobre ella. En otras palabras, sus datos se quedan en su equipo, en su comunidad. Para obtener más información sobre la base de datos integrada en la que se basa Mapeo, consulte la sección Mapeo Core.

• Intercambio de datos entre pares Todos los dispositivos conectados a una red de pares pueden tener la misma posición jerárquica dentro de la red. La información se comparte directamente entre diferentes dispositivos mediante un proceso de sincronización en el que cada dispositivo recibe y comparte datos. Dos dispositivos Mapeo pueden sincronizarse entre sí a la vez, y los dispositivos deben ser parte del mismo proyecto (es decir, usar la misma configuración) para sincronizarse entre sí. Todos los dispositivos que se sincronizan terminan teniendo la misma información y los cambios realizados en un dispositivo se reflejarán en los otros dispositivos después de la sincronización.

• Requiere un protocolo de sincronización Recomendamos enfáticamente tener un protocolo de sincronización metódico para dispositivos dentro de su proyecto para garantizar que todos los datos se incluyan en la base de datos compartida y que no se pierdan datos en el camino. Para que toda la información recopilada en un proyecto esté presente en los diferentes dispositivos, es fundamental planificar cómo, cuándo y dónde se producirá el proceso de sincronización entre dispositivos. Esto es especialmente importante en proyectos donde los participantes trabajan en lugares distantes y no coinciden con otros miembros de su equipo de manera regular.

• Who made Mapeo?

• Is Mapeo free to use?

• What kind of data can Mapeo collect?

• What languages is Mapeo available in?

• Is Mapeo Mobile available for iOS?

• Do I need to customize Mapeo to use it?

• How does Mapeo work offline?

• Does Mapeo use a Blockchain?

• Who will have access to my data?

• Does Mapeo collect information on users?

• What happens if Mapeo loses financial support? Will my data be inaccessible?

• Can you help me deploy Mapeo?

• How can I report bugs or problems using Mapeo?

Who made Mapeo?

Mapeo was built by Digital Democracy in close collaboration with Indigenous partners in the Amazon who are on the front lines of defending their rights and territories. Digital Democracy is a non-profit organization that works in solidarity with marginalized communities to use technology to defend their rights. For more information on Digital Democracy and our partners, visit our website.

Is Mapeo free to use?

Yes, all Mapeo tools and features are free to install and use.

What kind of data can Mapeo collect?

For more on Mapeo's default categories and details fields, see Configuración por defecto. To learn about customizing these options, see Configuraciones personalizadas.

What languages is Mapeo available in?

Mapeo is currently available in over 8 languages, including:

• English

• Spanish

• Portuguese

Mapeo can be translated into additional languages on Crowdin. For more information, see Traducir Mapeo y configuraciones predeterminadas

Is Mapeo Mobile available for iOS?

Mapeo Mobile is currently available for Android only. It is on our roadmap to release a version for iOS in the future.

Do I need to customize Mapeo to use it?

When you install Mapeo, it comes with default options that can be used right away, without any customization. To learn more about whether these options will work for you, see Mapeo funcionará de inmediato para mí?

Some projects may require customization of data fields or background maps in order to best meet the needs of the project or context. Customization currently requires some technical skills. For more on customization options and technical requirements, see Opciones de personalización.

How does Mapeo work offline?

Mapeo is built on an embedded peer-to-peer database, so all data collected with Mapeo is stored directly on your device, with no need for an internet connection or centralized server. Users of Mapeo Mobile and Mapeo Desktop can synchronize or exchange data over a local Wi-Fi network. The data never leaves your local Wi-Fi network and does not require an internet connection. Mapeo Desktop can also exchange information via a synchronization file using a USB drive.

For more on how Mapeo stores and synchronizes data, see Base de datos de pares y sincronización de Mapeo.

Does Mapeo use a Blockchain?

Mapeo uses secure peer-to-peer technology with a distributed ledger, which does not include a public blockchain or consensus.

Public blockchains are designed for a scenario where public transactions must be mediated between participants which are all potentially malicious. These “trustless” transactions are the key assumption of a blockchain that distinguishes it from peer-to-peer technology.

Applications like Mapeo assume that data is managed by the community generating it - and some of that data may never be publicly accessible. Mapeo's approach, in contrast, creates a closed group, where data creators are also data stewards, managing their own data and controlling who has access. We take security seriously and maintain protections from third-party attacks such as targeted hacks and surveillance by third-parties. For users of Mapeo, privacy is critical for protecting their ancestral knowledge and environmental monitoring information until it’s ready to be shared with trusted partners.

For more information, read this blog post and this paper from Article 19 about why blockchain is not a recommended tool for human rights and freedom of expression.

Who will have access to my data?

Mapeo was designed to be an offline-first set of tools that centers data sovereignty for its users. That means that the data you collect with Mapeo will only exist on the device it is collected or created with until you choose to share it with other Mapeo project participants or external actors. The data you create will never be stored on external servers or shared with app maintainers or other actors, unless you choose to send it or enable and use Web sync options through Mapeo.

Does Mapeo collect information on users?

Mapeo collects only basic, anonymized statistics for debugging, designing and understanding to what extent the applications are being used.

What happens if Mapeo loses financial support? Will my data be inaccessible?

Mapeo is built with long-term sustainability as a focus. This goes beyond financial sustainability - we ensure that no single entity or technology is responsible for data storage or access.

Mapeo does not lock your data into a particular data format. You can easily move your data around, and it is kept in its original form. Mapeo Desktop can export data to SMART, Shapefile, CSV, and GeoJSON. You'll never be locked into using Mapeo software. For more on export options, see Exportar datos y compartir externamente.

Can you help me deploy Mapeo?

There is a community of active users and maintainers of Mapeo that participate in our public chat channel on Discord and on our Earth Defenders Toolkit Forum. We encourage you to consult these spaces for additional tips and ideas on how people are using Mapeo.

Digital Democracy's core team is very small and we have limited capacity to provide direct accompaniment for implementing Mapeo outside of our existing partnerships. In some cases we are able to offer support. To read more about the way we work with partners and different levels of support, see here.

How can I report bugs or problems using Mapeo?

There is community of active users and maintainers of Mapeo that participate in our public chat channel on Discord. To join the conversation or seek help on technical issues, you can access the channel here.

Mapeo fue creado para ser altamente personalizable y permitir a los usuarios adaptar su interfaz para satisfacer las necesidades de proyectos específicos. Esta sección cubre tanto la traducción de la aplicación como el desarrollo de configuraciones personalizadas y mapas base en las siguientes páginas:

• Traducir Mapeo y configuraciones predeterminadas (novato, intermedio)

• Configuraciones personalizadas(avanzado)

• Mapas de fondo personalizados (avanzado)

Es posible que esté interesado en participar y comenzar con la recolección de datos, sin embargo, dedique un poco de tiempo a pensar por adelantado cómo se ejecutará el proyecto, la metodología, la configuración del equipo, la logística de recolección de datos y cómo los datos recolectados o creados con Mapeo puede ahorrarle mucho tiempo y evitar problemas y problemas más adelante.

Esta guía no tiene como objetivo brindarle un modelo de cómo ejecutar su proyecto. Hay tantos usos diferentes de Mapeo, algunos de estos los podemos imaginar nosotros (Digital Democracy), pero otros no los conocemos, y cada uno tiene sus propias necesidades, prioridades y contextos locales particulares. Lo que funciona en un lugar puede necesitar configurarse de manera muy diferente para otro lugar, incluso si el resultado deseado es muy similar. Y del mismo modo, lo que funciona en algún lugar en un momento dado, podría tener que ajustarse para otro momento a medida que cambien las situaciones locales, la política, etc.

Con suerte, dedicar tiempo a pensar en las preguntas a continuación le permitirá crear un proceso adaptado a sus necesidades y proyecto, y le dará la mejor oportunidad posible de éxito.

Vamos a pensar en las siguientes preguntas:

• ¿Por qué recopilar información? ¿Cuál es el objetivo de su proyecto de mapeo, monitoreo o recolección de datos, cuál es su objetivo o producto o resultado final deseado?

• ¿Qué resultados quieres? Si ya sabe que desea crear un story map interactivo, producir un informe cuantitativo o presentar un caso legal, esto puede ayudarlo a dar forma al diseño de su proyecto.

• ¿Qué información necesita recopilar para cumplir con este objetivo?

• ¿Quién debería estar involucrado? ¿Qué estructura de proyecto cumplirá mejor con sus objetivos, quiénes deben participar, qué roles necesita, quién toma las decisiones y ante quién es responsable?

• ¿Cuáles son los parámetros o factores limitantes con los que está trabajando? Esto se refiere a su contexto geográfico, infraestructura, accesibilidad a áreas, presupuestos y disponibilidad de equipos, limitaciones de tiempo, riesgos de seguridad, etc.

• ¿Es Mapeo la herramienta adecuada para usted? Creemos que Mapeo es genial :) pero sabemos que tiene límites y que no es la herramienta adecuada para cada trabajo. Queremos asegurarnos de que, si elige Mapeo, comprenda en qué destaca y también sus debilidades, para asegurarnos de que esté preparado de la mejor manera posible para el éxito de su proyecto.

Condiciones

Mapeo fue desarrollado conjuntamente con comunidades defensoras de la tierra en la Amazonia. Lo hemos probado, testeado y recibido comentarios de personas de todo el mundo que lo utilizan para una variedad de propósitos, y esperamos que pueda satisfacer una amplia gama de necesidades. Sin embargo, está construido teniendo en cuenta las necesidades de personas defensoras de la tierra y los derechos y, por lo tanto, esta guía y muchos de los materiales producidos para Mapeo también están construidos con estas necesidades en primer plano.

En parte debido a su proceso de diseño y a los socios con los que ha trabajado Digital Democracy, a menudo nos referimos a procesos comunitarios y colaborativos. Definitivamente, Mapeo también puede ser utilizado por individuos y una variedad de equipos diferentes, pero muchos de nuestros socios lo están utilizando en contextos comunitarios locales de primera línea, por lo que el lenguaje de esta guía se centra en esto. También entendemos que las comunidades no son homogéneas y significan diferentes cosas en diferentes lugares, y esperamos que pueda leer entre líneas cuando sea necesario para extraer las partes útiles de esta guía para lo que sea que signifique para usted.

Esta guía se basa en el trabajo de nuestro equipo durante las últimas dos décadas en derechos y defensa de tierras indígenas y comunitarias. Sin embargo, las comunidades indígenas y marginalizadas han estado defendiendo su tierra durante siglos. Hay muchos proyectos e iniciativas que han guiado e inspirado el desarrollo de Mapeo y las metodologías sugeridas aquí. Esta guía de referencia no pretende proporcionar una lista exhaustiva de tales proyectos, pero al final de la guía hay una sección de Referencias adicionales que destaca algunos materiales de otras fuentes e iniciativas que pueden serle de ayuda en la planificación de su proyecto.

Todos los ejemplos incluidos en la guía son solo eso, ejemplos. Esperamos que sean útiles y proporcionen algo de contexto e ilustración de los procesos descritos, pero no están destinados a ser tomados y copiados como metodologías 'listas para usar'. Como esperamos que se describa en esta sección de planificación, el contexto lo es todo, y la metodología debe ser cuidadosamente considerada y adaptada para adaptarse mejor a las necesidades del proyecto y del contexto particular de la comunidad.

No hay dos proyectos de Mapeo que tengan el mismo aspecto, incluso si tienen los mismos objetivos y usan la misma configuración. Hay tantos factores que influirán en cómo se ejecuta un proyecto, incluida la línea de tiempo; presupuesto; tecnología; paisaje; estaciones; clima; cultura; contexto social y político; etc.

Si bien podemos brindar algunas ideas aquí, cualquier proyecto debe adaptarse a su contexto particular teniendo en cuenta las respuestas a las siguientes preguntas. Pensar en estas preguntas con anticipación también será útil si solicita ayuda a un aliado u otra organización para armar un proyecto de mapeo.

¿Cuál es tu línea de tiempo?

¿Hay una urgencia particular para el trabajo, una fecha en la que necesita producir un mapa o recolectar datos? Si no hay una fecha límite interna, ¿hay fechas significativas externas al proyecto en las que desee trabajar o incluir dentro de su calendario (por ejemplo, visitas de autoridades al área, reuniones internacionales como COP o Grupos de Trabajo de la ONU, Foro Social Mundial, etc.).

¿Cómo es el paisaje geográfico? ¿Qué problemas de accesibilidad hay?

Piensa en cómo se ve la tierra y cómo planeas viajar. Algunos proyectos pueden centrarse en un área pequeña de la ciudad, donde la gente puede viajar a pie por caminos pavimentados, otros proyectos pueden cubrir decenas de miles de hectáreas y requieren viajar por río, colinas empinadas, pantanos, etc. Tal vez hay áreas a las que desea acceder que están fuera de los límites (por ejemplo, las fronteras nacionales o las instalaciones industriales pueden tener zonas prohibidas a su alrededor, o tener reglas sobre el uso de GPS o drones, etc.) Dibujar un mapa rápido del área en la que planea trabajar, y marcar puntos de referencia significativos, rutas de acceso, barreras, etc. puede ayudarlo a planificar cómo usted o su equipo se desplazarán y cuánto tiempo llevará, y ayudar a identificar cualquier desafío que pueda encontrar con anticipación.

¿Las estaciones afectan tu trabajo?

Si planea recopilar datos en una época particular del año, considere cómo la estación o el clima podrían afectarle. Por ejemplo, las estaciones secas y lluviosas pueden afectar la facilidad con la que puede moverse por el territorio y también pueden afectar el tipo de datos que puede recopilar (por ejemplo, viajar por río puede ser más fácil en la temporada de lluvias, pero viajar por carretera o a pie puede ser más duro); Del mismo modo, algunas operaciones o actividades que desea mapear o monitorear pueden ocurrir solo en ciertas épocas del año (por ejemplo, la tala ilegal está vinculada a las estaciones, al igual que los árboles frutales y los movimientos de peces/animales).

¿Tienes un presupuesto?

¿Tienes o necesitas un presupuesto?, y si es así ¿cuánto necesitas? ¿Tiene la intención de pagar a las personas para que participen o el proyecto está dirigido por personas voluntarias? Si aún no tiene un presupuesto, hay partes del trabajo que necesitarán fondos, como comprar equipos, viajar o cualquier reunión que tenga la intención de celebrar.

¿Tienes o necesitas equipos para tu proyecto?

Mapeo Mobile funciona en celulares y tabletas Android y Mapeo Desktop funciona en sistemas operativos Windows/Mac/Linux. Si bien es posible que solo necesite un celular para su proyecto (¡que quizás ya tenga en su bolsillo trasero!), dependiendo de su plan, y particularmente si va a trabajar con equipos de personas en entornos complicados, es posible que deba pensar en otros dispositivos y equipos como paquetes de baterías de repuesto si está realizando viajes de varios días en áreas remotas; unidades USB o discos duros para copias de seguridad; botiquines de trekking y botiquines médicos para las personas del equipo; impermeabilización para tecnología que podría estar expuesta a lluvia, viento, etc., hojas grandes de papel, rotuladores y cuadernos para talleres comunitarios.

Consulte la lista de equipos para obtener una lista de las cosas que los socios con los que hemos trabajado han encontrado útiles.

¿Cuál es la situación de seguridad?

Desafortunadamente, muchas personas defensoras en la primera línea son atacadas por su trabajo, a menudo arriesgando sus vidas para defender los derechos, las tierras y el futuro de sus pueblos. Considere su propia seguridad y la de cualquier otra persona involucrada en el proyecto y tome las medidas que pueda para identificar los riesgos con anticipación y mitigarlos cuando sea posible, mientras realiza el trabajo que debe hacer.

Por ejemplo:

• ¿Necesita mantener en secreto a los miembros del equipo, o los nombres de las personas entrevistadas o involucradas en el proyecto, o sería mejor involucrar a los medios de comunicación y asegurarse de que haya atención en el trabajo?

• ¿Hay lugares a los que puede evitar ir y preguntas que puede evitar hacer para no desencadenar respuestas peligrosas?

• ¿Los miembros del equipo necesitan algún tipo de respaldo para mantenerlos seguros, un teléfono satelital, un rastreador o acompañamiento de la sociedad civil?

Seguridad de datos

A veces, no son las personas las que están en riesgo, sino los datos; por lo tanto, considere si está recopilando datos que podrían ser valiosos para otros y cuál es la mejor manera de mantenerlos seguros.

La información también puede ser delicada de otras maneras: tal vez solo ciertos miembros de una comunidad normalmente tienen acceso a ella (pero todavía quieren que se documente) o tal vez es información que la comunidad no quiere hacer pública.

Mapeo no hace público ninguno de sus datos a menos que usted elija compartirlos. Puede crear informes o exportar datos, y puede filtrar los datos que se muestran para excluir lugares confidenciales o partes de información que no desea compartir. Además, puede compartir información con otros miembros del equipo sin que estén conectadas a internet. Sin embargo, hay otras medidas que puede tomar para proteger su información si es necesario, creando contraseñas para sus dispositivos ... ¿qué más?

Bienvenid@s personas defensoras de la tierra, mapeadoras comunitarios, monitoras de recursos e impacto, recolectoras de datos, estudiantes, científicas: quienquiera que sea, esperamos que haya disfrutado jugando con Mapeo utilizando la Guía de inicio rápido anterior.

Si cree que Mapeo podría ser la herramienta adecuada para su proyecto, esta Guía de referencia completa está diseñada para brindarle materiales de aprendizaje y capacitación, flujos de trabajo sugeridos y algunos ejemplos de proyectos reales para ayudarlo a configurar y utilizar Mapeo en la mejor manera posible para sus necesidades.

Hay MUCHA información en las secciones a continuación, y hay muchas formas diferentes de usar Mapeo. No esperamos que los usuarios hagan uso de todas las funciones de Mapeo ni necesiten leer todas las secciones, pero sí esperamos que lo que proporcionamos aquí pueda ayudar a los usuarios a estar bien informados sobre los detalles técnicos que afectarán sus proyectos.

Acerca de las configuraciones

Mapeo usa configuraciones para determinar qué categorías, íconos y preguntas ven los usuarios cuando recopilan datos. Para cada punto de datos recopilado con Mapeo, los usuarios seleccionan una categoría para clasificar el punto y pueden responder preguntas o responder a indicaciones para proporcionar más detalles sobre lo que se está documentando.

Configuración de Mapeo por defecto

Cuando instala Mapeo, viene con una configuración predeterminada que incluye categorías generales y preguntas para el mapeo y monitoreo del territorio.

Categorías

La configuración predeterminada incluye las siguientes categorías de recopilación de datos:

Las observaciones que no se ajustan a estas categorías siempre se pueden recopilar utilizando la categoría Punto nuevo.

Preguntas

Para revisar todos los campos incluidos en la configuración predeterminada, instale Mapeo y explore la sección Agregar detalles para cada categoría.

Más allá de la configuración predeterminada

Mapeo ofrece la opción de crear configuraciones personalizadas para adaptarse a las necesidades de proyectos específicos. Para obtener más información sobre la personalización, consulte Configuraciones personalizadas.

Instalar

Para instalar Mapeo Mobile en su dispositivo Android, descargue la última versión en Google Play. También puede descargar la aplicación como APK e instalarla manualmente en su teléfono. Para obtener más información sobre la instalación, consulte Instalar Mapeo Mobile.

Recolectar datos

Ver observaciones

Haz clic en una observación del mapa o de la lista para ver sus detalles.

Editar una observación

Compartir datos externamente

Borrar una observación

Sincronizar datos

Mapeo Mobile le permite sincronizar datos con otros usuarios de Mapeo que son participantes del mismo proyecto. Durante la sincronización, TODOS los datos de un dispositivo se enviarán al otro dispositivo y viceversa. Para obtener más información sobre la sincronización, consulte:

Base de datos de pares y sincronización de Mapeo.

Para sincronizar datos entre 2 dispositivos Mapeo Mobile que están cerca uno del otro:

1. Conecte ambos dispositivos a la misma red Wi-Fi. (No es necesario tener una conexión a Internet.)

3. En la pantalla Sincronizar, identifique el dispositivo con el que desea sincronizar en la lista y toque el botón Sincronizar junto a su nombre. Mantenga abierta la pantalla Sincronizar en ambos dispositivos hasta que se complete la sincronización.

La respuesta a esta pregunta de quién debería estar involucrado podría variar enormemente. Tal vez sea solo usted y su celulares, o tal vez involucre a miles de personas en varios países que trabajen juntas para recopilar una gran cantidad de datos. La mayoría de los socios con los que hemos trabajado directamente están en algún punto intermedio, a menudo una comunidad o grupo de comunidades con un equipo dedicado a colaborar para recopilar datos.

Sin embargo, incluso los proyectos en los que nos hemos asociado directamente, que pueden parecer superficialmente muy similares, han establecido sus estructuras de proyecto de formas muy diferentes, a veces por necesidad y otras por preferencia. Así que aquí hay algunas cosas a considerar.

¿Hay alguna autoridad tradicional o de otro tipo que deba consultarse antes de comenzar, o que deba participar en algun rol? Esto es particularmente relevante si está recopilando datos de tierras indígenas (propias o pertenecientes a otros) y/o si podría estar recopilando datos potencialmente confidenciales.

¿Ante quién es responsable su proyecto y cómo puede asegurarse de satisfacer sus necesidades? La respuesta a esto podría ser las autoridades tradicionales mencionadas anteriormente, o podrían ser sectores particulares de su comunidad, financiadores, las generaciones futuras u otros. Considere cómo mantenerlos actualizados con el progreso del proyecto si es relevante y cómo producir materiales que estas personas encuentren accesibles y útiles.

¿Diferentes miembros de su comunidad tienen diferentes conocimientos que desea asegurarse de que estén representados? ¿Cómo puedes honrar e involucrar a estas personas y su conocimiento? Piense aquí en las mujeres, los ancianos y los jóvenes en particular, y cómo asegurarse de que participen en el trabajo y que no se utilicen simplemente para extraer información. Luego, dependiendo de los detalles de su proyecto, pueden surgir otros grupos: personas curanderas tradicionales; artesanas expertas; narradoras; trabajadoras de la salud, etc.

Considere la propiedad del proyecto: si el proyecto satisface las necesidades identificadas por su comunidad, o recopila datos intrínsecos a ella o su futuro, considere cómo garantizar que la comunidad se sienta involucrada en el trabajo y se sienta responsable de cualquier resultado. Mapeo se creó para tratar de facilitar la propiedad comunitaria tanto de los proyectos como de los datos al tener una interfaz simple que podría explicarse a las personas sin capacitación en recopilación de datos y a las personas que pueden ser analfabetas o que no están acostumbradas a las computadoras o los celulares. Involucrar a las personas en las diferentes etapas del proyecto, incluida la fase de planificación, puede ayudar a aumentar este sentimiento de propiedad, al igual que mantener los datos localmente, proporcionar comentarios e informes frecuentes sobre lo que está sucediendo, y crear resultados que las personas puedan usar o ver.

¿Qué otras partes interesadas o personas con interés o autoridad desea involucrar? Quizás haya personas a las que sería útil involucrar porque podrían ayudar a que el proyecto alcance su objetivo, como las autoridades locales, las fuerzas del orden público, la prensa, los guardaparques. Piense en qué papel podrían tener en el proyecto, si se les consulta sobre las cosas con anticipación o simplemente se les informa y se les mantiene actualizados sobre el progreso del proyecto. Considere también si hay personas de las que desea mantener el trabajo y los datos en secreto debido a aspectos de seguridad u otras consideraciones.

¿Quién va a recoger los datos? A menos que el suyo sea un proyecto en solitario, necesitará trabajar con un equipo o equipos de personas para recopilar sus datos. Esto será particularmente necesario si necesita cubrir una gran área de terreno, tiene limitaciones de tiempo o necesita diferentes habilidades en su equipo. Piense en la composición del equipo y cómo lo va a construir: ¿es algo para lo que la gente se ofrecerá como voluntaria o se les pedirá? ¿Necesita garantizar una representación diversa y, de ser así, cómo lo hará? ¿Quieres involucrar a tantas personas como sea posible o tener un pequeño equipo que se mueva?

¿Qué otros papeles necesitas? Si está trabajando con un equipo o equipos de personas recolectoras de datos o cartógrafas, es probable que necesite a alguien que los coordine, ayude a planificar viajes, recolecte los datos que recolectan, los analice y prepare cualquier informe o salida. Esta podría ser la función de una sola persona coordinadora, o podría necesitar varias personas debido a la cantidad de personas involucradas o debido a las sensibilidades culturales o políticas o la forma en que se establece la propiedad del proyecto. También puede tener personas involucradas en la capacitación, la toma de decisiones, el enlace con organismos externos, la ayuda con el trabajo legal y de comunicaciones, etc.

¿Qué habilidades necesita la gente? Esperamos que Mapeo sea fácil de aprender y usar, pero si está trabajando en un equipo y desea recopilar datos comparables, las personas necesitarán capacitación sobre cómo usar la aplicación y cómo usarla de la manera que su proyecto necesita. Puede haber otras capacitaciones necesarias, como capacitación en el uso básico de celulares si las personas no están acostumbradas; formación en la toma de buenas fotografías que ilustren lo que se quiere mostrar; entrenamiento en gps; drones; video; grabación de audio; grabación de historia oral; software GIS, etc. resolución de conflictos, desescalada, etc. dependiendo de los detalles de su proyecto.

Crear un protocolo de proyecto: Redactar un protocolo, si es posible de manera colaborativa, que establezca los diferentes roles dentro del proyecto, su relación con los datos, los acuerdos sobre el uso y la propiedad de los datos, los pagos que se realicen, lo que sucederá a los equipos y los datos al final de un proyecto, etc. puede ser una forma de mantener las cosas transparentes, establecer responsabilidades y ayudar a evitar problemas durante y después del trabajo.

Cuando instalas Mapeo, viene con opciones predeterminadas que se pueden usar de inmediato, sin ninguna personalización. En las siguientes páginas, esta sección detalla lo que se incluye automáticamente con Mapeo para que puedas determinar si la aplicación satisfará tus necesidades desde el primer momento.

• Configuración por defecto

• Mapa de fondo por defecto

Mapeo ofrece muchas opciones para personalizar categorías, íconos, preguntas y mapas de fondo, pero el proceso de personalización actual requiere un conocimiento técnico significativo y no será accesible para todos los usuarios.

Acerca de las configuraciones personalizadas

Las configuraciones personalizadas son una poderosa herramienta para la personalización en Mapeo, que permite a los usuarios definir categorías, íconos y cuestionarios específicos para sus proyectos. La categoría personalizada y el texto del cuestionario se pueden escribir en cualquier idioma que se pueda escribir, lo que garantiza que las partes clave de la interfaz de recopilación de datos de Mapeo puedan aparecer en el idioma nativo de los grupos que la utilizan.

En la versión actual de Mapeo, las configuraciones también contienen una clave de proyecto que permite a los participantes del mismo proyecto de Mapeo sincronizar datos entre sí y evita la sincronización con otros dispositivos.​

Creación de configuraciones personalizadas

Si ha identificado que la Configuración por defecto de Mapeo no se adapta a las necesidades de su proyecto, tiene la opción de crear una configuración personalizada.

El proceso de personalización, detallado en Creando configuraciones personalizadas, requiere familiaridad y conocimientos para editar archivos JSON, generar archivos de imagen SVG y usar acciones de GitHub o instalar y usar paquetes de nodos a través de la línea de comandos.

Sobre los mapas de fondo de Mapeo

Mapeo utiliza mapas de fondo (también llamados mapas base) para mostrar a los usuarios su ubicación actual en la aplicación móvil y como fondo para mostrar los datos recopilados o creados con Mapeo.

Mapa base de Mapeo predeterminado

De forma predeterminada, cuando el dispositivo tiene acceso a Internet, Mapeo Mobile y Mapeo Desktop en el modo Observaciones utilizan un mapa de fondo detallado que incluye elementos geográficos como ríos y montañas, así como algunos elementos políticos y urbanos como fronteras, ciudades, carreteras, y otros.

Si el dispositivo no está conectado a Internet, el mapa de fondo que se muestra por defecto es mucho menos detallado. En Mapeo Mobile, el mapa de fondo sin conexión muestra las fronteras de los países y las principales masas de agua. En Mapeo Desktop, actualmente no hay un mapa de fondo sin conexión predeterminado.

Ejemplo de mapa de fondo con conexión a Internet:

Ejemplo de mapa de fondo sin conexión a Internet:

Más allá del mapa de fondo predeterminado

Mapeo ofrece la opción de agregar un mapa de fondo personalizado para usar tanto sin conexión como en línea. Para obtener más información sobre cómo crear y agregar mapas de fondo personalizados, consulteMapas de fondo personalizados.

Resumen del proceso

Hay varios pasos para crear una configuración personalizada que requerirán diferentes habilidades y la participación de diferentes actores dentro de un proyecto. Debe dejar suficiente tiempo antes del inicio previsto de la recopilación de datos para permitir la consulta, las pruebas y las iteraciones de su configuración por parte de la comunidad.

Si bien las estructuras de datos en Mapeo se pueden modificar durante el curso de un proyecto, muchos cambios a lo largo del tiempo pueden generar datos desordenados. Vale la pena probar y refinar su configuración en la medida de lo posible antes de ponerla en uso para la recopilación de datos.

Una vez que haya completado este proceso, tendrá un archivo de configuración de Mapeo (.mapeosettings) que se puede importar y usar en Mapeo Mobile y Destop.

Las siguientes páginas lo guiarán a través de los pasos clave para crear una configuración personalizada:

• Planeando la configuración y la estructura de datos Esta sección describirá los elementos personalizables clave en una configuración y algunas consideraciones al trazar cada área. *No se requieren conocimientos técnicos.

• Codificar la configuración Esta sección lo guiará para adaptar de la estructura de datos planificada al formato requerido para su proyecto y la compilación del archivo de configuración de Mapeo. *Es necesario editar archivos JSON, generar archivos .svg y trabajar con la línea de comandos o GitHub.

Mapeo tiene como objetivo ser accesible para una amplia gama de comunidades en sus idiomas nativos y facilitar el proceso de traducción de la aplicación y la configuración predeterminada a nuevos idiomas según sea necesario.

Si bien el desarrollo de configuraciones personalizadas actualmente requiere un conocimiento técnico significativo, el proceso de traducir Mapeo y la configuración predeterminada a un nuevo idioma local puede ser una forma más fácil de personalizar la herramienta para usarla en su proyecto.

Traducción usando Crowdin

Las traducciones para Mapeo se manejan a través de la plataforma Crowdin. Es gratis crear una cuenta en Crowdin y cualquiera puede contribuir con traducciones a Mapeo para idiomas nuevos o existentes.

Para comenzar a traducir, visite la página del proyecto para el área que le gustaría traducir.

• Mapeo Mobile Texto y títulos para pantallas y botones en la aplicación móvil

• Mapeo Desktop Texto y títulos para pantallas y botones en la aplicación de escritorio

• Configuración predeterminada de Mapeo Nombres de categorías de recopilación de datos y campos de detalles

Visualización de idiomas disponibles

En la página de inicio del proyecto, puede ver todos los idiomas disponibles actualmente para el proyecto y qué tan completas son las traducciones.

Agregar un nuevo idioma

Si el idioma que desea traducir no está disponible en la página de inicio del proyecto, comuníquese con el propietario del proyecto (enumerado en la parte inferior derecha de la página) para solicitar una adición a la lista.

Contribuir a las traducciones

Para comenzar a traducir, cree una cuenta con Crowdin, visite la página de inicio del proyecto correspondiente y seleccione el idioma de destino. Haga clic en Traducir todo para que aparezcan todas las cadenas de texto relevantes.

Aunque algunos pasos clave de la codificación de configuraciones requieren habilidades técnicas, la planificación inicial y la consulta con las personas participantes del proyecto son esenciales para diseñar estructuras de datos efectivas y no requieren habilidades de codificación.

Para comenzar el proceso de personalización, las personas participantes del proyecto deben reflexionar sobre los objetivos del proyecto, qué tipo de datos se necesitarán y qué propiedades podrían requerirse para los datos de salida.

Si aún no lo ha hecho, siga la sección de la guía Qué información recolectar? como primer paso.

Estructura de datos

Al planificar su configuración, deberá pensar en qué incluir para cada una de las áreas personalizables de Mapeo. Las siguientes páginas lo guiarán a través de algunas consideraciones al determinar el contenido de cada área:

• Categorías Al recopilar o crear datos con Mapeo, los usuarios asignan una categoría de nivel superior a cada observación o elemento del mapa.

• Iconos Cada categoría que incluya debe tener un icono o un pequeño gráfico para mostrar a los usuarios al seleccionar una categoría.

• Campos de detalles (opcional) Para cada categoría en su configuración, puede incluir uno o más campos de datos estructurados (como un mini formulario o cuestionario) que los usuarios pueden completar opcionalmente al crear una nueva observación o elemento de mapa con esa categoría.

Documentación de la estructura de datoso

Para crear un archivo de configuración de Mapeo, la información que asigne para las áreas anteriores deberá traducirse a archivos JSON y archivos de imagen .svg y luego compilarse. Los detalles de este proceso se cubrirán en Codificar la configuración.

Si no tiene las habilidades técnicas necesarias para codificar la configuración usted mism@, la información que defina en las siguientes páginas para Categorías, Iconos y Campos de detalles se puede documentar y pasar a una persona desarrolladora o persona con habilidades técnicas para codificar y compilar el archivo de configuración.

Una vez que se haya decidido por el diseño o el concepto de sus íconos, deberá generar archivos .svg para que cada uno se guarde en el directorio de icons. Los iconos deben crearse como gráficos de 100x100 píxeles que sean claros cuando se visualizan al 100 %.

Actualmente, hemos documentado dos flujos de trabajo para generar archivos .svg compatibles con Mapeo mediante software, uno con un producto comercial (Adobe Illustrator) y otro con un producto de código abierto (Inkscape).

• Crear y exportar archivos SVG usando Adobe Illustrator

• Crear y exportar archivos SVG usando Inkscape

Nombrar archivos de iconos

Los iconos deben ser leídos por MAPEO en dos tamaños: 100 píxeles y 24 píxeles. Por ese motivo, existe una convención de nomenclatura de archivos específica:

• nombre-icono-100px.svg

• nombre-icono-24px.svg

Cada icono se puede duplicar y renombrar para que haya uno de cada tamaño. Son abiertos y leídos por los archivos .json en la carpeta de presets. Verifique que el nombre se haya ingresado correctamente donde sea necesario (más sobre esto en la siguiente sección). El script de compilación procesará el sufijo de tamaño de píxel.

Recursos adicionales

• Troubleshooting SVG image errors in Mapbox Studio

¿Qué son las categorías?

Al recopilar o crear datos con Mapeo, a cada observación o elemento del mapa se le asigna una categoría. Los usuarios deben seleccionar una sola categoría al crear una nueva observación o elemento de mapa. Las categorías pueden ser amplias o específicas, según el contexto y las necesidades del proyecto.

¿Cómo se ven las categorías en Mapeo?

Listado de categorías en el panel de Filtros de Mapeo Desktop (usando la configuración predeterminada):

Consideraciones al definir categorías

Para cada categoría que elija incluir en su configuración, deberá determinar lo siguiente:

• Nombre La etiqueta que verán los usuarios en Mapeo al visualizar o seleccionar la categoría

• Geometría Cada elemento en el mapa se marcará como un punto, línea (p. ej., un camino) o área (p. ej., una zona o un lago). Deberá determinar cuál de estas geometrías podrán usar las personas usuarias para cada categoría.

  • Todos los datos recopilados con Mapeo Mobile serán puntos. Si está utilizando Mapeo Mobile, debe incluir punto como geometría para cada categoría.

  • Si utiliza el modo Territorio de Mapeo Desktop como parte de su proyecto, también puede incluir una línea o un área para las categorías cuando corresponda.

• Color (opcional) Tiene la opción de establecer un color personalizado para los puntos o marcadores del mapa para cada categoría en el modo de observaciones de Mapeo Mobile y Mapeo Desktop.

• Orden de clasificación (opcional) Tiene la opción de determinar el orden en el que desea que aparezcan las categorías en la pantalla Categorías de Mapeo Mobile (en la imagen de arriba). Si no se agrega ningún orden, las categorías aparecerán en orden alfabético por nombre.

Al definir categorías, tenga en cuenta lo siguiente:

• Las categorías son una de las formas clave en que se pueden filtrar los datos en Mapeo. Pensar en cómo verá y usará los datos una vez que se hayan creado ofrece una perspectiva útil al definir categorías.

• Como regla general, las categorías no deben superponerse: los usuarios deben ver solo una opción que se ajuste al hacer una selección.

• Las categorías y lo que caería dentro de ellas deben ser claro para quienes recopilarán datos. Las sesiones de capacitación e información pueden ser críticas para garantizar que las personas participantes del proyecto sepan cómo recopilar datos de manera consistente, pero la claridad y la simplicidad en la creación de configuraciones son de gran ayuda.

• El espacio disponible para mostrar los nombres de las categorías es limitado, especialmente en Mapeo Mobile, por lo que, en general, los nombres deben ser breves.

Generación de archivos de categoría

Toda la información que defina para las categorías se formateará en JSON en el proceso Codificar la configuración, que se detalla en la siguiente sección.

¿Qué son los campos de detalles?

Para cada categoría en la configuración, puede incluir uno o más campos de datos estructurados (como un mini formulario o cuestionario) que los usuarios pueden completar opcionalmente al crear una nueva observación o elemento de mapa con esa categoría.

Los campos de detalles pueden ser campos de texto (escriba su propia respuesta) o de opción múltiple (seleccione una o varias de un conjunto de respuestas predefinidas).

¿Cómo se ven los campos de detalles en Mapeo?

Pantalla de campo de detalles que se muestra durante la recopilación de datos con Mapeo Mobile:

Consideraciones al definir campos de detalles

Al planificar su estructura de datos, debe pensar qué campos de detalles (si corresponde) le gustaría incluir para cada categoría. El mismo campo de detalles se puede utilizar para muchas categorías.

Para cada campo de detalles que desee incluir, deberá definir lo siguiente:

• Etiqueta El texto principal que se mostrará a los usuarios ("Nombre" en la imagen de arriba).

• Marcador de posición Una pista o subtexto que puede aclarar el campo a los usuarios o brindar orientación sobre cómo usarlo ("Nombre común de este lugar" en la imagen de arriba).

• Tipo de campo Cómo los usuarios podrán ingresar información para el campo o pregunta.

  • Escriba su propia respuesta en texto (en la imagen de arriba)

  • Seleccione uno de una lista de opciones

  • Seleccione varios de una lista de opciones

  • Opciones Para los campos Seleccionar uno y Seleccionar varios, deberá definir una lista de posibles respuestas para mostrar.

Al definir campos de detalles, tenga en cuenta lo siguiente:

• Puede ser muy difícil para los usuarios escribir información detallada al recopilar datos en el campo. Los usuarios pueden estar bajo un estrés significativo, en situaciones de riesgo o interactuando con la pantalla de Mapeo bajo el sol o la lluvia. Al crear campos de texto, tenga en cuenta las condiciones a las que se enfrentarán las personas usuarias y tenga expectativas razonables sobre la cantidad de detalles y el trabajo necesarios para completar sus campos de detalles.

• Si hay un conjunto consistente de respuestas que puede anticipar para un campo o pregunta, puede ser mucho más rápido o más fácil para los usuarios seleccionar de una lista como parte de un campo Seleccionar uno o Seleccionar varios. Tenga en cuenta que no hay una opción automática para escribir información para "Otro" o una opción no incluida en la lista.

• Puede ser muy claro para usted al crear su configuración lo que cada campo de detalles significa o pretende comunicar. Sin embargo, tenga en cuenta quiénes recopilarán datos como parte de su proyecto y cómo podrían leer o interpretar cada campo. Un lenguaje muy claro y explícito puede contribuir en gran medida a garantizar que su configuración se utilice según lo previsto.

• Mapeo Desktop actualmente le permite filtrar las observaciones por opciones en los campos Seleccionar uno. Para filtrar por opciones en los campos Seleccionar varios o campos de texto, deberá exportar sus datos y verlos en otra herramienta de software.

Generación de archivos de campo de detalles

Toda la información que defina para los campos de detalles se formateará en JSON en el proceso Codificar la configuración, que se detalla en la siguiente sección.

Exportar archivos .svg con las propiedades adecuadas

Cuando esté listo para exportar un archivo gráfico vectorial a un formato de archivo .svg compatible con Mapeo, el proceso es el siguiente:

• En el menú superior de Adobe Illustrator, haga clic en Archivo y luego seleccione Exportar, seguido de Exportar como.

• Asegúrese de que Use Artboards esté marcado.

• Guarde su archivo .svg en el directorio correcto (icons para las configuraciones de Mapeo) y con el nombre de archivo deseado, y haga clic en Exportar.

• En la siguiente ventana, asegúrese de que las siguientes propiedades estén configuradas y luego haga clic en Aceptar:

¿Qué es un icono?

Cada una de las categorías que incluya en su configuración debe tener asignado un icono o un pequeño gráfico para mostrar a los usuarios al seleccionar una categoría. Puede asignar el mismo ícono a varias categorías, o cada categoría puede tener su propio ícono.

¿Cómo se ven los íconos en Mapeo?

Consideraciones al diseñar iconos

Si bien la creación de los archivos de íconos .svg requiere cierto conocimiento de las herramientas de edición de imágenes, esbozar y generar ideas para los íconos puede ser una excelente manera de involucrar a los miembros de la comunidad y a los participantes del proyecto que pueden no tener habilidades técnicas. Con papel y lápices, los grupos pueden generar ideas para íconos que representen cada categoría en su proyecto.

Si no está preparado para diseñar sus propias imágenes de íconos, hay bibliotecas de imágenes en línea con licencias Creative Commons que puede utilizar.

Al diseñar iconos, tenga en cuenta lo siguiente:

• Los iconos se muestran como imágenes muy pequeñas en Mapeo Mobile (24x24px) y Mapeo Desktop (100x100px). Los diseños muy simples con detalles mínimos se mostrarán más claramente a los usuarios.

  • Cuando piense en el tamaño y la escala, imagine dibujar sus íconos con un marcador en una moneda de diez centavos.

• Las líneas y formas en negrita y de colores sólidos serán más claramente visibles.

Generación de archivos de iconos

Estructura de la carpeta de configuración

Al crear configuraciones personalizadas, editará archivos dentro de las siguientes carpetas de configuración:

• icons (iconos)

• fields (campos)

• presets (categorias)

Y los siguientes archivos de configuración:

• metadata.json

• defaults.json

• package.json

Preparar estructura de carpetas

Usando el explorador de archivos

3. Cambie el nombre de la carpeta de "mapeo-default-settings" para usar su propio nombre de proyecto, "mapeo-config-projectname".

Usando el terminal (linux y mac) - línea de comandos

In fields directory customize the .json files

Each .json file in the fields directory needs a key, type, label, and placeholder.

type can be one of select_multiple, select_one, or text.

For select_one and select_many fields, you will need to define an array of answer options.

Example fields file (name.json):

{
    "key": "name",
    "type": "text",
    "label": "Name",
    "placeholder": "Common name of this place"
}

In the presets directory, customize the .json files

In the presets directory, each .json file needs:

• icon must mach the name of an icon in the icons folder - use prefix only, excluding the size refernce and file extension (eg. for fishing-24px.svg/fishing-100px.svg use fishing).

• name will be the human-readable label shown to the user

• geometry must be an array of point ,area, and/or line (All categories for use in Mapeo Mobile must include point.)

• sort (optional) is an integer that will determine the order in which categories are displayed on the Categories screen of Mapeo Mobile. If no sort is included, categories will be listed alphabetically by name.

• an array of fields (optional) which should match the key created in the fields directory. Fields will be displayed to users in the order they are listed in the fields array.

Example preset file (fishing-site.json):

Using Inkscape to vectorize images

A common workflow for generating Mapeo icons is to find photos or other raster images, and turn them into vector images, simplifying them until they will render well at a small size. In Adobe Illustrator, this can be done using the Image Trace tool.

In Inkscape, this can be done using the Trace Bitmap tool found in the Path menu. There are some options to manipulate like Smoothing corners, Optimizing corners, and setting the number of colors.

Saving .svg files with the right size and Viewbox in Document Properties

Once you have a vector image that is to your satisfaction (and in a square format), you need to set the correct width & height and Viewbox size before saving the .svg file. You can do this in Document Properties (File menu).

First, set the Display units to pixels (px). This dropdown is located at the very top of the Document Properties menu.

Locate the "Custom Size" and "Scale" boxes in Document Properties.

First, you may need to set the unit of measurement for the Custom size, if it is not in pixels. If Units is in a format like milimeters (mm), change this to px.

Set the Width and Height to 100 each.

Next, the Viewbox needs to be set to 100 as well. The easiest way to do this — once you've set the Display units and Custom size units to pixels — is to set the Scale x to 1. It should copy over the Width and Height values from the Custom Size to the Viewbox. If that didn't do the trick, manually enter 100 for both Width and Height here.

Once you've done this, you may need to resize the art to match the full size of the Viewbox:

The easiest way to do this is to use the sizing and placement parameters right above the Viewbox, as shown in the screenshot above. Set W and H to 100 (px), and make sure X and Y are set to 0 (px). The image will then fill the entire Viewbox:

You can now save the .svg file by going to File → Save / Save As / Save A Copy.

Verify that your SVG file is built correctly

It should have an initial <svg> tag with width and height set to 100, and viewBox set to "0 0 100 100."

After some tags like <defs>, <sodipodi:namedview>, <metadata>, which don't matter for the purposes of creating icons for Mapeo, you should see tags like <g> with layer properties, and a series of <path> with vertices and style properties, which constitute your vectors.

If your .svg file looks like this, the Mapeo configurations builder script should process your icons just fine.

Additional resources

What is a Project Key?

In the metadata.json file in your Mapeo configuration, you can include a projectKey, which is a random cryptographic string of characters to prevent unwanted devices from getting access to the data.

Once a Mapeo Mobile or Mapeo Desktop device has imported a configuration with a project key, it can only sync with another Mapeo Mobile or Mapeo Desktop device that has the same project key.

You can edit the project key (for example, if you want to make first 4 characters identifiable to a project) but it can only contain letters a-f and numbers 0-9.

It can also only be 64 characters long -- no more, no less.

Creating a Project Key

To create a projectKey, first open the Terminal.

Using mapeo-settings-builder

Copy and paste the following command into the terminal

mapeo-settings-builder generate-key

You'll see something like this (but with x replaced with real characters and numbers)

'380c02d32xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx1d'

Copy this string and add it to the metadata.json file so it looks like this:

{
  "dataset_id": "mapeo-jungle",
  "projectKey": "380c02d32xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx1d"
}

Notice that there are double quotes " around each value.

The defaults.json file is currently used by Mapeo Desktop to determine which categories (presets) to list for each type of map geometry (point, line, area).

Before building your configuration, ensure that defaults.json includes an array of presets for each geometry that corresponds to the geometries you've listed in your preset files.

Example defaults.json file:

{
    "area": [
        "area", 
        "airstrip",
        "animal",
        "community",
        "fishing-site",
        "gathering-site",
        "hills",
        "hunting-site",
        "lake",
        "palm",
        "special-site",
        "swidden",
        "threat",
        "tree",
        "plant"
    ],
    "line": [
	"line",
	"boundary-line",
	"river",
	"path",
	"stream",
	"threat"
    ],
    "point": [
        "point",
        "airstrip",
        "animal",
        "boundary-line",
        "building",
        "camp",
        "clay",
        "community",
        "fishing-site",
        "gathering-site",
        "house",
        "hunting-site",
        "palm",
        "cave",
        "plant",
        "salt-lick",
        "waterfall",
        "special-site",
        "swidden",
        "threat",
        "tree"
    ],
    "vertex": [
    ],
    "relation": [
    ]
}

The package.json file stores the name and version information users will see in Mapeo when using the configuration.

Edit the name and version properties when creating a new configuration. Additional information on incrementing versions will be covered in Building configuration file.

You can also add description, author, and license information to this file but these properties will not be rendered in the Mapeo interface.

Example package.json file:

{
  "name": "project-config",
  "version": "1.0.0",
  "description": "Mapeo configuration",
  "dependencies": {
    "mapeo-settings-builder": "^3.0.0",
    "mkdirp": "^0.5.1"
  },
  "devDependencies": {},
  "scripts": {
    "build": "basename=\"${npm_package_name}-v${npm_package_version}\"; mkdirp build/${basename}; mapeo-settings build -l 'en' -o build/${basename}.mapeosettings && tar -C \"build/${basename}\" -xf build/${basename}.mapeosettings",
    "test": "mapeo-settings lint"
  },
  "author": "Your Name",
  "license": "UNLICENSED",
  "private": true
}

Compiling your configuration into a .mapeosettings file is the final step for testing and using your configuration in Mapeo Mobile and Desktop.

Building a configuration can be done in two ways:

• Via the command line(with Node.js and mapeo-settings-builder)

• Using GitHub Actions

Prepare computer for building the configuration

Mapeo is built with JavaScript programming language. To get started, you'll need to install Node.js development environment. If you already have Node.js installed you can skip this section.

You need to be at least on Node.js version 8 (or higher) for the mapeo-settings-builder to work properly. Head over to Node.js download page and select installer for your operating system.

Alternatively you can also use NVM (Node Version Manager) to install and manage multiple versions of Node.js on your computer.

Install nvm

touch ~/.bash_profile

curl -o- <https://raw.githubusercontent.com/creationix/nvm/v0.32.1/install.sh> | bash

Then close terminal and open again

Install homebrew (macOS)

http://brew.sh/

Install npm

https://docs.npmjs.com/cli/install

Install and use node 12

nvm install 12
nvm alias default 12

Install Mapeo Settings Builder

You'll see output on the terminal, but this is OK

npm install -g mapeo-settings-builder

Is your computer ready?

If your computer is ready to create configurations, type

mapeo-settings-builder

You should see output that looks something like

→ Using version x.x.x of mapeo-settings-builder
Usage: mapeo-settings-builder [options] [command]

Options:
  -h, --help                   display help for command

Commands:
  build [options] [sourceDir]  Build config from presets in current working dir
  lint [sourceDir]             Lint preset files for errors
  extract-messages [options]   Extract messages for translation
  generate-key                 Generate a random project key
  help [command]               display help for command

Now you're ready to move to build your configuration!

Package Config Assets for MAPEO

Prep folder and build

Type, 'cd`, then a space, then drag and drop the folder where the prepared assets are and press enter. It will look something like this

cd /Users/jen/Documents/Dd_LOCAL_project-files/Dd-Tools/Mapeo/Presets/CREATION\\ LAB/Strathcona-KX-v1.0.0

You will then be ready to run scripts directly in the folder.

npm install

npm run -s build

This -s tells npm to be silent, so that you only see errors that are meaningful to you.

You will see something like the following output. Errors will be highlighted in RED with hopefully some helpful description so that you can remedy the issue.

→ Using version x.x.x. of mapeo-settings-builder
! Warning: no category json files found in /home/okdistribute/node_modules/mapeo-default-settings/mapeo-default-settings-2.1.0/categories
✓ Built presets and categories (37ms)
✓ Generated svg sprite for iD (544ms)
✓ Generated png sprite for Mapbox (81ms)
✓ Generated png icons for Mapeo Mobile (607ms)
✓ Successfully created file 'build/mapeo-default-settings-v2.1.0.mapeosettings' (total 1299ms)

You'll also see a .mapeosettings file inside of the build directory.

What is a .mapeosettings file?

A .mapeosettings file is a tar file, similar to a zip file. You can see the contents of the file by changing the file extension to .tar and using any application that can extract tar files (such as 7zip, mentioned above).

Troubleshooting Checklist

Type the following into the terminal

node -v

You need to be at least on Node version 8 for the mapeo-settings-builder to work properly. If you need help, review the 'Preparing Computer' section and ensure you're on the latest version of mapeo-settings-builder.

npm install -g mapeo-settings-builder@latest

You also may want to delete node_modules and install updated versions of the dependencies.

In Mac or Linux, in the terminal:

npm install

If you're having more issues, please open an issue on the GitHub repository or e-mail our support hotline.

Versioning

It's important to increment the version when releasing new changes to your configuration. When you are ready to release a new version, you can use standard-version in the command line to automatically increment your config version and update the CHANGELOG.md file in your repository.

It is possible to build a Mapeo configuration file using GitHub Actions. This requires setting up your custom configuration directory as a repository on Github.com, adding a /.github/workflows/build.yml script to your repository, and committing changes to that repository.

Setting up a configuration repository on GitHub

The first step will be to set up your configuration as a repository on github.com, with the requisite build script files that will trigger a GitHub Actions Workflow to generate your .mapeosettings file. There are a few ways to do this.

If you do not have your own custom configuration already, and are starting from scratch:

1. You can fork or upload either the Mapeo Default Configuration or the Empty Mapeo Configuration template to your own GitHub account. The choice you make will depend on how you will go about creating your own configuration, as detailed in Planeando la configuración y la estructura de datos.

2. Make sure that you have the .github/workflows directory in your configuration repository.

If you already have your own custom configuration:

1. Create a repository on GitHub for your custom configuration.

2. Commit your existing configuration content to the repository.

3. Download either the Mapeo Default Configuration or the Empty Mapeo Configuration, and copy over the .github directory to the root directory of your custom configuration.

4. Commit these files to your repository on Github.com. (Github may ask you for additional permissions to add these files, by confirming via the browser.)

Getting ready to build

Navigate to the Actions screen, and Click "I understand my workflows, go ahead and enable them."

This will bring you to a view of your Workflows. You should see a message "There are no workflow runs yet" if you just enabled Workflows for the first time. You are now ready to start building .mapeoconfig files.

How it works

Once you have enabled Action Workflows on your configuration repository, GitHub will generate a Workflow to build a new version of your configuration every single time that you commit a change to your repository.

Once you have committed a change to your repository, and navigate to the Actions tab, you should see your commit message listed as a workflow.

You can click on your commit message to find out more about the status of your build. For example, if your build has encountered an error, there will be a log that can give you an idea of what went wrong. You can commit a change to fix the error, and return to the Actions screen to see if a new Workflow successfully bypasses the problem.

By opening the Workflow with your commit message, you can also download a .zip file of your configuration, which includes a temporary .mapeosettings file. This is helpful for testing out your configuration before building a versioned file to distribute to users, as described in Probando e iterando.

Use conventional commit messages to increment your configuration version

The Mapeo GitHub Actions Workflow is set up to dynamically bump the version of your configuration per each workflow. It does so using conventional commit messaging of adding feat:, fix:, or chore: before your commit message. For example, if you have a configuration with version 1.1.0, the specific version bumps are as follows:

• feat: this will increase your version to 1.2.0. This commit prefix could be used for major configuration updates.

• fix: this will increase your version to 1.1.1. This commit prefix could be used for small updates like changing an icon, or adding a field to a category.

• chore: this will not increase your version. This commit prefix could be used for correcting typos or fixing errors.

You can also manually update the first number in your 1.1.0 version in your package.json file, but Digital Democracy's convention is to only do so to indicate breaking changes. That said, you are free to choose a versioning convention that makes the most sense to you.

Compile a final, versioned release of your configuration

Once you are done making changes, have tested your configuration using a temporary .mapeosettings file (as described in How it works) and in accordance to the process described in Probando e iterando, you can generate a versioned release of your configuration. The way to do so is as follows:

• Navigate to the Actions tab for your GitHub repository. You should see all of your Workflows again.

• On the left sidebar, click on the Build & Release link.

• You should now see a box with the text "This workflow has a workflow_dispatch event trigger" and a button Run workflow. Click the button, and then click Run workflow again in the popup that will appear.

• Doing so will trigger another Workflow titled "Build and Release."

• Click on the release to download the versioned .mapeosettings file.

Acerca de los mapas de fondo personalizados

Los mapas de fondo personalizados permiten a los usuarios de Mapeo incorporar una amplia gama de conjuntos de datos geográficos y elementos relevantes en los mapas utilizados para mostrar la posición actual y los datos recopilados. Una vez agregados a Mapeo, los mapas de fondo personalizados están disponibles completamente fuera de línea dentro de la aplicación.

Crear mapas de fondo personalizados

Una vez que haya compilado su configuración personalizada, tendrá un archivo .mapeosettings que se puede importar a Mapeo Mobile y Desktop para probarlo y usarlo.

¿Qué es un archivo .mapeosettings?

Un archivo .mapeosettings es un archivo tar, similar a un archivo zip. Para fines de depuración, puede ver el contenido del archivo cambiando la extensión del archivo a .tar y usando cualquier aplicación que pueda extraer archivos tar.

Importar una configuración a Mapeo

For instructions on how to import a configuration file (.mapeosettings) into Mapeo, see:

Probando tu configuración

Vale la pena probar a fondo su nueva configuración antes de introducirla en su proyecto y comenzar la recopilación formal de datos.

Algunas cosas a tener en cuenta al probar configuraciones:

• Iconos ¿Los íconos se muestran claramente? Compruebe cómo aparecen los iconos, especialmente en Mapeo Mobile en dispositivos con pantallas más pequeñas.

• Colores Si agregó color a los marcadores del mapa de categoría, ¿se distinguen entre sí y se ven en el fondo del mapa?

• Nombre y versión ¿El nombre y la versión de su configuración aparecen como se desea en la pantalla de Configuración del proyecto en Mapeo Mobile o en la pantalla de Sincronizar de Mapeo Desktop?

Hacer cambios

A diferencia de otras herramientas de recopilación de datos o encuestas, Mapeo permite mucha flexibilidad para cambiar las configuraciones con el tiempo y no requiere que se borre la base de datos cuando se realizan cambios. Si bien los cambios en los íconos o los campos de color, nombre, etiqueta o marcador de posición serán menores, las modificaciones más importantes, como eliminar una categoría, afectarán la forma en que se muestran los datos existentes en Mapeo y las exportaciones de datos. Independientemente de estos cambios, ningún dato anterior se perderá o no se podrá ver.

En esta sección, encontrará todos los recursos necesarios para aprender a instalar y configurar Mapeo Mobile:

• • Idioma

  • Formato de coordenadas GPS

Antes de comenzar, asegúrese de que:

Para comenzar a usar una configuración personalizada, deberá importar el nuevo archivo de configuración a Mapeo Mobile. Para obtener más información sobre las configuraciones, consulte Configuraciones personalizadas.

Localizar el archivo de configuración

Descargue o copie el archivo de configuración (p. ej., ejemplo_proyecto.mapeosettings) en su dispositivo Android. Tenga en cuenta en qué carpeta se guardó el archivo.

Ir a configuración

Importar el archivo de configuración

Seleccione Configuración del Proyecto, luego haga clic en Importar config.

Navegue a la carpeta que contiene su archivo de configuración y haga clic en el archivo.

Confirmar importación

Haga clic en OK en la ventana de confirmación de importación y verifique que la pantalla de Configuración del Proyecto ahora muestra el nombre de la nueva configuración.

▶ Vídeo disponible: Cómo identificar qué configuración usa Mapeo Mobile

▶ Vídeo disponible: Cómo importar una configuración personalizada a Mapeo Mobile

Hay 2 formas de instalar Mapeo Mobile en su celular:

Instalar desde Play Store

Antes de comenzar, asegúrese de que:

• Tienes suficiente espacio disponible en su celular para la aplicación Mapeo y los datos que recopilará; le recomendamos que tenga al menos 1 GB (gigabyte) disponible.

Para instalar Mapeo Mobile en su celular desde Google Play Store:

4. En la pantalla de Mapeo Mobile en la aplicación Play Store, haga clic en Instalar.

5. Cuando se complete el proceso de instalación, haga clic en Abrir.

6. Cuando se abra Mapeo Mobile, se le pedirá que permita el acceso de Mapeo a la cámara y al GPS de su teléfono para que la aplicación funcione correctamente. Después de eso, la pantalla de inicio de Mapeo Mobile se abrirá automáticamente.

▶Vídeo disponible: Cómo instalar Mapeo Móvil desde Play Store

Instalar desde un archivo APK

Puede instalar Mapeo Mobile en un celular que no tenga conexión a Internet utilizando un archivo de instalación previamente descargado (.apk).

Si ya tiene el archivo de instalación en su dispositivo, continúe aquí: Instalar desde un archivo APK

Descargar el archivo de instalación

Mientras haya una conexión a Internet disponible, descargue el archivo de instalación de Mapeo (.apk).

Instalar desde un archivo APK

1. Localice el archivo de instalación de Mapeo (.apk) en el dispositivo.

2. Haga clic en el archivo de instalación (.apk) para abrirlo.

3. En la ventana emergente, haga clic en INSTALAR. El proceso de instalación puede tardar varios minutos.

4. Una vez completada la instalación, haga clic en ABRIR en la ventana emergente.

5. Cuando se abra Mapeo Mobile, se le pedirá que permita el acceso de Mapeo a la cámara y al GPS de su celular para que la aplicación funcione correctamente. Después de eso, la pantalla de inicio de Mapeo Mobile se abrirá automáticamente.

▶ Vídeo disponible: Cómo instalar Mapeo Mobile desde un archivo APK

Las siguientes configuraciones se pueden cambiar fácilmente en Mapeo Mobile:

• Idioma

• Formato de coordenadas GPS

• Experimentos (activar funciones experimentales)

Idioma

Mapeo Mobile está actualmente disponible en más de 15 idiomas, pero se puede traducir a cualquier idioma adicional mediante la plataforma Crowdin. Para más información sobre la traducción, consulte: Traducir Mapeo y configuraciones predeterminadas

Para cambiar el idioma de Mapeo Mobile:

2. En la pantalla Idioma, seleccione el idioma que le gustaría usar para Mapeo Mobile. El idioma de la aplicación cambiará automáticamente.

▶ Vídeo disponible: Cómo cambiar el idioma de Mapeo Mobile

Formato de coordenadas GPS

Mapeo Mobile admite tres formatos de coordenadas GPS: Universal Transverse Mercator (UTM), Grados/Minutos/Segundos (DMS) y grados decimales (DD).

Para cambiar el formato de coordenadas utilizado:

2. En la pantalla Formato de Coordenadas, haga clic en el formato que le gustaría usar y cambiará automáticamente dentro de la aplicación.

Experimentos

La pantalla Experimentos contiene nuevas funciones experimentales que se encuentran en desarrollo continuo. Se pueden activar y utilizar en su estado actual y se mejorarán y eliminarán de la sección Experimentos en futuras actualizaciones de la aplicación.

Actualmente hay 2 funciones disponibles en Experimentos:

• Flecha direccional

• Actualizaciones de la aplicación P2P

Flecha Direccional

La nueva función de Flecha Direccional utiliza la brújula digital de su celular para proporcionar información sobre la dirección en la que mira su teléfono. La proximidad a objetos metálicos grandes o un fuerte campo magnético puede afectar la precisión de la brújula.

Si su celular no tiene una brújula, la Flecha Direccional aún puede determinar la dirección según el movimiento. La dirección basada en el movimiento puede ser menos precisa.

Activar Flecha Direccional

Para activar la función de Flecha Direccional:

2. Seleccione Flecha Direccional, luego haga clic en la casilla de verificación para Usar Flecha Direccional.

Esta sección proporciona una guía paso a paso sobre el uso de las funciones principales de Mapeo Mobile:

Ver observaciones en el mapa

Para ver los detalles de una observación, haga clic en el punto que marca la observación para abrir la pantalla Ver observación.

Ver las observaciones en una lista

Para ver los detalles de una observación, haga click en cualquier observación en la lista para abrir la pantalla Ver observación.

Like most existing apps, Mapeo Mobile is in continuous development. We frequently release new versions of the application to fix technical issues or add new functionality. When you update Mapeo Mobile, you do not lose data you have collected or synchronized using a previous version.

The process to update Mapeo Mobile is very similar to the installation process and there are 3 ways to do it:

Other content related to Mapeo updates

Mapeo versions - information and naming conventions

Mapeo uses a numerical system to name versions ( for example v.5.4.0). The numbers are labeled as follows: v.MAJOR.MINOR.PATCH.

• The MAJOR number indicates a breaking change - a change in this number could be related to how the software work or a change in how you use it. The MAJOR number increases if features that were previously part of the app are now removed.

• The MINOR number increases when new features have been added to Mapeo.

• The PACTH number increases if there are small updates or fixes that don’t introduce any new behavior or features.

If the MAJOR number increases, the MINOR and PATCH numbers are reset to 0. If the MINOR number increases, the PATH number is reset to 0.

Installation files for older versions of Mapeo Mobile

Actualizar Mapeo Mobile a través de Actualizaciones de App P2P (peer-to-peer)

Peer-to-peer (P2P) App Updates is an experimental feature that allows you to share and receive newer versions of the Mapeo app by connecting to other Mapeo devices via Wi-Fi (no internet connection required).

When updating the Mapeo app version in this way, NONE of your Mapeo data (observations, configurations, or maps) is shared between devices.

To search for and share Mapeo app updates between Mapeo Mobile devices, both smartphones must:

• have the P2P App Updates feature enabled

• have Mapeo open to the Synchronize screen

• be connected to the same Wi-Fi network

Enable the P2P App Updates feature

Check for available updates

If a newer version of the app is available from another Mapeo device on the network, the update will be automatically downloaded.

(If your device has a newer version than other devices the network, you will see the message "Sharing app updates with other devices.")

Install app update

To install the newer version of Mapeo, wait until the download completes, then tap INSTALL on the Synchronize screen.

Allow installs from Mapeo

After tapping INSTALL, you may see a security pop-up window saying that your phone is not allowed to install apps from this source.

To enable Mapeo to install updates, tap Settings in the pop-up window and toggle the switch to Allow from this source in the following Android Settings screen.

Reopen Mapeo

When the installation is complete, Mapeo will close automatically. When you re-open Mapeo, you will see an update confirmation window. Tap OK to close the window and start using the new version of Mapeo.

Activa el GPS en tu dispositivo

Mapeo Mobile utiliza el GPS de tu dispositivo, por lo tanto, antes de comenzar a usar la aplicación, asegúrate de que el GPS o la Ubicación en tu celular estén habilitados.

Será diferente en cada celular, pero los servicios de GPS o Ubicación generalmente se pueden encontrar en el menú Configuración rápida, al que se puede acceder deslizando hacia abajo desde la parte superior de la pantalla.

Confirmar acceso GPS en Mapeo Mobile

En la pantalla de inicio de Mapeo Mobile, podrá ver si Mapeo está accediendo con éxito al GPS de su dispositivo.

View GPS details in Mapeo Mobile

Ver posición actual

De manera predeterminada, Mapeo Mobile marcará su posición actual con un punto azul en el centro del mapa y ajustará el mapa a medida que se mueva.

Recolecta datos con Mapeo Mobile en forma de observaciones. Una observación se basa en una ubicación geográfica (un punto en el mapa) y puede tener fotos, notas y detalles asociados.

Crear una nueva observación

Seleccionar una categoría

Seleccione la categoría que mejor represente lo que está documentando en la observación. Mapeo viene con un conjunto predeterminado de categorías e íconos asociados que se pueden usar para recopilar y clasificar datos.

Añadir una descripción

Haga click en el marcador de posición ¿Qué está pasando aquí? para agregar una descripción de lo que está documentando.

Añadir fotos

Para confirmar la eliminación, haz click en Eliminar imagen en la ventana de confirmación. Tenga en cuenta que una vez eliminadas, las imágenes no se pueden recuperar.

Añadir detalles

Haga clic en SIGUIENTE para pasar a la siguiente pregunta y haga clic en LISTO una vez que hayas respondido la última.

Guardar una observación

* Nota sobre la precisión del GPS

Si la señal GPS al momento de guardar la observación tiene una precisión menor a ± 10 m, Mapeo automáticamente te ofrecerá tres opciones:

1. Haga clic en SEGUIR ESPERANDO para esperar a que la señal GPS mejore.

2. Haga clic en GUARDAR para utilizar los datos GPS actuales, incluso si la precisión es inferior a ± 10 m.

Por defecto, Mapeo Mobile utiliza un mapa de fondo que muestra algunos elementos geográficos como ríos y montañas, así como algunos elementos políticos y urbanos como fronteras, ciudades, carreteras, etc.

Si tiene preparado un mapa de fondo personalizado, puede agregarlo y usarlo en Mapeo Mobile sin afectar los datos que ha recopilado. (Para más información sobre la creación de mapas de fondo personalizados, consulteMapas de fondo personalizados.)

Agregar un mapa de fondo usando una computadora

Conecta tu celular a una computadora

Desbloquee la pantalla del celular y conecte el dispositivo a una computadora mediante un cable USB. Haga clic en la notificación Cargando este dispositivo a través de USB. En "Usar USB para", selecciona Transferencia de Archivos.

En su computadora, busque y copie el contenido del paquete de mapas de fondo de Mapeo

Los mapas de fondo de Mapeo a menudo se comparten como un archivo comprimido (.zip). Si su mapa de fondo es un archivo .zip, haga doble clic en el archivo para descomprimirlo.

Un mapa de fondo de Mapeo consta de varias carpetas y archivos que deben copiarse en el sistema de archivos de Mapeo Mobile. Los mapas de fondo vectoriales estándar para Mapeo contendrán los elementos de archivo que se enumeran a continuación: 3 carpetas y 2 archivos.

Seleccione y copie todos los elementos que se encuentran dentro de su carpeta de mapa de fondo.

Paste the background map elements onto your smartphone

Once you have copied the contents of the background map folder, use the computer to browse through your smartphone to the correct folder within the Mapeo Mobile file system.

Click on Internal Shared Storage, then on Android, data, com.mapeo. Then click on files, then on styles, and finally on default. Paste the background map elements into the default folder.

The complete path of the default folder where you will paste the map elements is Internal Shared Storage/Android/data/com.mapeo/files/styles/default

Restart Mapeo Mobile

Restart the Mapeo Mobile app. The new background map will appear on the home Map screen.

Editar detalles

En la pantalla Editar observación, puede cambiar la categoría del punto, editar la descripción y los detalles, o añadir fotos adicionales.

Guardar cambios

Eliminar observaciones

Esta sección cubrirá todos los pasos necesarios para instalar y configurar Mapeo Desktop en su computadora:

Antes de comenzar, asegúrese de que:

Changing the language of Mapping Desktop is a simple step and does not affect the data collected or the categories used to create observations. Mapeo Desktop should open initially in the current language you have selected for your computer's operating system. To change the Mapeo Desktop language:

2. On the Top menu bar, click on View and select Change language.

3. Select the desired language and click on SUBMIT. You may see a white screen for a few seconds as the interface language changes.

Acerca de la Sincronización de Mapeo

Mapeo Mobile le permite sincronizar los datos que ha recopilado con otros usuarios de Mapeo que son miembros del mismo proyecto. La sincronización de datos no requiere una conexión a Internet y se puede realizar en áreas completamente fuera de línea.

Conectarse al WiFi

Conecte ambos dispositivos a la misma red Wi-Fi. La configuración de Wi-Fi generalmente se puede encontrar en el menú Configuración rápida, al que se puede acceder deslizando hacia abajo desde la parte superior de la pantalla.

Entrar en modo Sincronización

La pantalla Sincronizar mostrará si está conectado a una red Wi-Fi. Si está conectado, podrá ver el nombre de la red a la que está conectado en la parte superior izquierda de la barra azul marino. También podrá ver el número de identificación único de su dispositivo en el lado derecho de la barra azul marino.

Sincronizar datos

Una vez que los dispositivos disponibles aparecen en la lista, confirme la identidad del dispositivo con el que planea sincronizar consultando el número de identificación único en el teléfono del otro usuario.

Haga clic en el botón Sincronizar junto al nombre del dispositivo para comenzar el intercambio de datos.

Ver observaciones sincronizadas

En la pantalla de la lista de Observaciones, las observaciones recopiladas por otros dispositivos aparecerán con una barra azul en el lado izquierdo.

Descargar el archivo de instalación

Si tiene una conexión a Internet, puede descargar el archivo de instalación de Mapeo Desktop de forma gratuita desde http://mapeo.app.

Una vez que haya descargado el archivo de instalación, siga los pasos detallados en las secciones a continuación para instalar Mapeo Desktop en el sistema operativo apropiado para su computadora:

Instalar en Windows

2. Busque el archivo de instalación de Mapeo (.exe) en su computadora y haga doble clic en él para instalarlo. Si recibe un mensaje de seguridad de su sistema operativo, haga clic en Ejecutar de todos modos.\

Instalar en macOS ​

2. Busque el archivo de instalación de Mapeo (.dmg) en su computadora y haga doble clic en él para abrirlo.

Instalar en Linux

Descagar archivo de instalación

Habilitar permisos ejecutables

Para instalar desde el archivo .AppImage, deberá asegurarse de que el archivo tenga permisos para ejecutarse como un programa. Busque dónde se guardó el archivo de instalación en su computadora y haga clic derecho en el archivo. Seleccione Propiedades en el menú.

Haga clic en la pestaña Permisos en la parte superior de la ventana Propiedades, luego haga clic en la casilla de verificación Permitir que este archivo se ejecute como un programa.

Instalar

Haga doble clic en el archivo .AppImagey Mapeo Desktop debería abrirse automáticamente.

Instalación offline

Ahora que ha pegado el archivo de instalación en otra computadora, siga estos pasos para instalar Mapeo:

Esta sección explora cómo usar Mapeo Desktop para ver y administrar datos de Mapeo Mobile, así como las opciones disponibles para exportar datos a diferentes formatos. La información se encuentra en las siguientes páginas:

• Sincronizar datos

• Ver observaciones

• Editar y borrar observaciones

• Exportar datos y compartir externamente

To start using a custom configuration, you'll need to import the new configuration file into Mapeo Desktop. For more on configurations, see Configuraciones personalizadas.

Locate the configuration file

Download or copy the custom configuration file (eg. example_project.mapeosettings) onto your computer. Note which folder the file was saved in.

Import the configuration

2. On the Top menu bar, click File and select Import Configuration.

3. In the pop-up window, navigate to the folder on the computer where you saved the configuration file (.mapeosettings) you want to import. Click on the file, then click Open. You may see a white screen for a few seconds while the configuration changes.

Mapeo Desktop es una aplicación informática que se puede utilizar para dos propósitos diferentes:

• Mapeo Desktop para gestionar datos de Mapeo Mobile (modo Observaciones) Mapeo Desktop le permite agregar, ver y administrar los datos recolectados con Mapeo Mobile. El modo de observaciones ofrece opciones para filtrar y exportar datos en múltiples formatos, como GeoJSON, CSV y PDF, y también permite la publicación de mapas interactivos en internet con los datos recolectados con Mapeo Mobile.

• Mapeo Desktop para la creación de datos territoriales (modo Territorio) Mapeo Desktop también ofrece una interfaz para agregar o crear datos territoriales directamente dentro de la aplicación para computadoras. El modo Territorio proporciona un conjunto de herramientas básicas para mapear elementos. Estas herramientas son más accesibles para los usuarios de nuevas tecnologías que otras herramientas de sistemas de información geográfica (SIG) disponibles. También ofrece la opción de importar información geográfica desde una fuente externa y exportar datos de mapas en un formato .GeoJSON. La manipulación o visualización adicional de los datos de mapas exportados requiere el conocimiento de otro software.

Like most existing apps, Mapeo Desktop is in continuous development. We frequently release new versions of the application to fix technical issues or add new functionality.

When you update Mapeo Desktop, you do not lose data you have collected or synchronized using a previous version.

Mapeo versions - information and naming conventions

For details on Mapeo version numbers and naming conventions, see:Mapeo versions - information and naming conventions

Installation files for older versions of Mapeo Desktop

To view all previous versions of Mapeo Desktop, including release notes for changes made in each version, see the Mapeo Desktop Releases page on GitHub.

By default, Mapeo Desktop in Observations mode uses a background map that shows some geographical elements such as rivers and hills, as well as some political and urban elements such as borders, cities, roads, etc. Mapeo Desktop in Territory mode offers a range of background maps including satellite imagery, OpenStreetMap, and more.

If you have a custom background map, you can add it and use it in Mapeo Desktop without affecting the data collected. (For more on creating custom background maps, see Mapas de fondo personalizados.)

To add a background map to Mapeo Desktop, follow the instructions below for your operating system:

Windows computer

Locate and copy the contents of the Mapeo background map package

Mapeo background maps will often be shared as a compressed file(.zip). If your background map is a .zip file, double click the file to unzip it.

Standard vector background maps for Mapeo will contain the file elements listed below: 3 folders and 2 files.

Select and copy all of the elements found inside your background map folder.

Paste the copied elements into the Mapeo/styles/default folder

1. In the Windows search engine, type %APPDATA% , and open the folder that appears with this name.

2. Inside the AppData folder, click on the Mapeo subfolder, then click on the styles subfolder.

3. If there is not already a default folder inside your styles folder, you will need to create one. To do so, right-click inside the styles folder and create a new folder named default.

4. Paste the background map elements you copied into the default folder.

Reload Mapeo Desktop

macOS computer

Locate and copy the contents of the Mapeo background map package

Mapeo background maps will often be shared as a compressed file(.zip). If your background map is a .zip file, double click the file to unzip it.

A Mapeo background map consists of several folders and files that need to be copied into the file system of Mapeo Desktop. Standard vector background maps for Mapeo will contain the file elements listed below - 3 folders and 2 files.

Select and copy all of the elements found inside your background map folder.

Navigate to the Mapeo/styles folder

1. Click on Finder on your computer.

2. In the top menu bar, click on Go, then select Go to Folder...

3. Type in ~/Library/Application Support/Mapeo/styles in the address bar and click on Go.

Paste the copied elements into the Mapeo/styles/default folder

If there is not already a default folder inside your styles folder, you will need to create one. To do so, control-click inside the styles folder and create a new folder named default.

Paste the background map elements you copied into the default folder.

Restart Mapeo Desktop

Editar los detalles de una observación

Para editar una observación, abra sus detalles completos en la ventana Ver observación.

Con la ventana Ver observación abierta, haga clic en un campo para agregar o editar información. Haga clic en GUARDAR para guardar los cambios.

Borrar una observación

Mapeo le permite sincronizar los datos recolectados con otros usuarios o dispositivos de Mapeo que sean miembros del mismo proyecto. La sincronización se usa regularmente a lo largo del curso de los proyectos para agregar datos recolectados por diferentes participantes y garantizar que existan múltiples copias de la base de datos completa. La sincronización de datos no siempre requiere una conexión a Internet y se puede realizar en áreas completamente fuera de línea.

Hay 2 formas de sincronizar con Mapeo Desktop:

• • Si los dispositivos están en el mismo lugar, incluso sin una red Wi-Fi.

  • Si los dispositivos no están en el mismo lugar y ambos tienen conexión a Internet.

Sincronizar a través de Wi-Fi

Requisitos:

Para sincronizar, siga los pasos a continuación:

Conectarse al Wi-Fi

Entrar al modo de Sincronización

Para sincronizar, ambos dispositivos deben tener abierta la pantalla Sincronizar.

Los dispositivos disponibles para la sincronización aparecerán en la pantalla Sincronizar.

Comenzar sincronización

Una vez que los dispositivos disponibles aparecen en la lista, confirme la identidad del dispositivo con el que planea sincronizar consultando el número de identificación único en el dispositivo del otro usuario.

Ver observaciones sincronizadas

Para obtener información sobre cómo ver y administrar datos sincronizados:

Esta sección cubre las opciones y formatos disponibles para exportar datos desde el modo Observaciones en Mapeo Desktop.

En Mapeo Desktop puede ver sus datos como un informe. Cada página del informe contiene los detalles de una observación. Desde la vista Informe, puede:

Para exportar sus datos de observación como .GeoJSON:

2. Seleccione Exportar observaciones...

3. En la ventana emergente Exportar observaciones:

• Para el campo Formato de datos, seleccione GeoJSON.

• En el campo ¿Solo datos filtrados o todos los datos? campo, elija si desea que el archivo exportado contenga solo datos filtrados o todos los datos.

• En la opción ¿Exportar fotos también? campo, elija entre no incluir fotos, fotos de tamaño completo o fotos de tamaño prevista en el archivo exportado.