epessina / mapad

A mobile application powered by a RESTFull API to map defibrillators on the field.

Mapad

Table of Contents

• What is Mapad?
• Technologies
• Installation
• Demo
• Contributions
• License

What is Mapad?

Mapad is a cross-platform mobile application that allows users to map defibrillators on the field in an easy and fun way.

All the collected data are stored in a database through a publicly open API that provides endpoints for retrieving, inserting and modifying the defibrillators.

Features

• Secure authentication method through Oauth 2.0 protocol.
• User's position always visible on a map.
• Possibility to insert new defibrillator in the system through a flow of questions (presence of the defibrillator, location category, signage, picture of the machine, etc.).
• Possibility to update or delete mapped defibrillators.
• Users can compete through a system assigns points for each mapped defibrillator and produces a real-time global leaderboard.

Technologies

Client

HTML5, SCSS and JavaScript code wrapped with Apache Cordova to create a native, cross-platform mobile application.

Dependencies

• jQuery
• Leaflet
• Leaflet.markercluster
• i18next
• Babel

Server

RESTFull API written using Node.js and Express.js.

Database

MongoDB.

Installation

Android

The minimum version required is Android 7.0 (API level 24).

1. Download Mapad-x.x.x.apk.
2. Place the file in your phone.
3. Install the apk.
4. Done!

iOS

Coming soon...

Demo

Login screen

The login screen allows to:

• login into the system;
• navigate to the registration page
• reset the password.

---

Map screen

1. Map. Centered on the user's position, it can be moved and zoomed freely.
2. User marker. Shows the current position of the user. It can be moved if the location is not accurate.
3. Defibrillator marker. Shows a mapped defibrillator that is saved on the main database. A click on one of those markers opens a screen that shows the information about the correspondent defibrillator and allows to delete or modify it.
4. Profile button. Opens the profile page.
5. GPS button. Centers the map and the user marker on the current location of the user.
6. New defibrillator button. Opens the screen that allows to insert a new defibrillator.

---

Insert screen

The insert screen. From here the user can insert all the details about a new defibrillator and save it in the database.

---

Profile screen

This screen shows some information about the user and his points status. Furthermore, the settings of the application can be accessed from here.

Contributions

A special thanks to:

License

GPL-3.0 © Edoardo Pessina

mapad's Issues

Add the data in OpenStreetMap

Add the data about the defibrillator to OpenStreetMap. They should be added directly but the best way is with an OSM note.

Some example of the application that add note on OSM is OnOSM (source code), and the same website from the italian osm comunity. Some info about the note creation are available in the OSM wiki.