Skip to content

CodeandoMexico/mapmap

Repository files navigation

Logo Codeando México Logo Codeando México

website slack

MapMap

MapMap es un kit de código abierto para el mapeo de rutas de transporte público.

Índice

Problemática

En un gran porcentaje de las ciudades latinoamericanas el transporte público se brinda a través de concesiones por medio del sector privado, esto implica un desconocimiento del número de concesiones que transitan por las ciudades, los itinerarios son irregulares así como las rutas por donde circulan los camiones. El no conocer las rutas genera un serio problema para la movilidad de las personas y la administración pública al no lograr gestionar adecuadamente el transporte público de una ciudad.

Descripción

MapMap es un kit de mapeo de transporte público. El proyecto consiste en:

  • Una aplicación móvil para Android
  • Una aplicación de servidor

Este proyecto es una versión modernizada del proyecto MapMap originalmente desarrollado por Codeando Xalapa en el marco del Mapatón Xalapa 2016. En este repositorio está una nueva versión con algunos ajustes, mejoras y corrección de errores.

Con el tiempo el proyecto MapMap se ha usado en mapatones en diferentes partes de México (Veracruz, Michoacán, Baja California Sur) y otros países (Ecuador, Colombia, República Dominicana), y en el proceso se identificaron mejoras y correcciones que era necesario realizar, además de la necesidad de actualizar el stack tecnológico del proyecto para facilitar su mantenimiento y mejorar su estabilidad.

Para más información del proyecto original consultar el respositorio original del proyecto.

Aplicación móvil

Mediante la aplicación móvil es posible capturar trazos georeferenciados sin la necesidad de consumir datos del dispositivo móvil. La información que se recolecta a través de la aplicación es la siguiente:

  • Conteo de pasajeros (subida y bajada de usuarios en las paradas).
  • Puntos que marcan las paradas por donde se detiene el transporte público.
  • Línea de trazo que identifica una ruta.
  • Tiempo inicial y final del recorrido.
  • Fotografía del transporte público que realiza la ruta.

App móvil

Tecnología

  • Android 5.0 (sdk 21)
  • Java 8+

Se recomienda Android Studio como IDE para el desarrollo.

Instalación de la app móvil

La última versión de la aplicación móvil se encuentra en la página de releases.

La aplicación se creó para el Android SDK 21, y en versiones modernas de Android al intentar instalarla puede dar aviso de que no es recomendable instalarla. Esta app apunta directamente a los servidores de Codeando México.

Si realizas una instalación de tu propia instancia de MapMap Server, es necesario configurar la App Android para apuntar a tu servidor y recompilar el APK.

Esto lo puedes realizar en el fichero:

mapmap-app/app/src/main/java/CaptureService.java en la linea 38

public final static String SERVER = "mapaton.org/mapmap";

Aplicación de servidor

La aplicación de servidor sirve para:

  • Recibir los datos recabados mediante la aplicación móvil
  • Visualizar las rutas en un mapa web
  • Descargar las rutas en formatos Shapefile y CSV

Página de inicio Página de mapa

Tecnología

  • Java 17+
  • Spring Boot 3

Se recomienda IntelliJ IDEA o Visual Studio Code (Metals) para el desarrollo.

Instalación de la aplicación de servidor

El proyecto se puede instalar:

  • De manera manual
  • Usando Docker

Más información en el documento de instalación

Metodología

Documento de metodología

Autores:

Codeando Xalapa

Codeando México

Licencia

El proyecto consiste de dos partes, las cuales están publicadas con dos licencias diferentes. Cada proyecto tiene la licencia en su carpeta:

Si estás planeando reutilizar la aplicación web, es necesario que publiques el código bajo la misma licencia, GPL Affero 3, en un repositorio de acceso público y mantengas los avisos de autoría, además de indicar los cambios realizados al código existente.

Te recomendamos leas a detalle la licencia. Puedes contactarnos si tienes alguna duda al respecto.

Agradecimiento

Agradecemos a todos los miembros que pertenecen a la comunidad de Codeando Xalapa por contribuir en este proyecto. También agradecemos al proyecto TransitWand por haber creado la aplicación móvil que sirvió como base para construir MapMap.


Creado con 💜💙💚💛❤️ por la comunidad de Codeando México.