Skip to content

Latest commit

 

History

History
224 lines (185 loc) · 23.4 KB

README.md

File metadata and controls

224 lines (185 loc) · 23.4 KB

HOTOSM Logo

Field Mapping Tasking Manager (FMTM)

Coordinated field mapping for Open Mapping campaigns.

Release Version

CI/CD Build and Deploy Build CI Img Build ODK Images
🔧 Build Proxy Images Publish Docs pre-commit.ci
Tech Stack FastAPI React Postgres Kubernetes Docker
Code Style Backend Style Frontend Style pre-commit
Quality Coverage OpenSSF Best Practices
Community Slack All Contributors
Other Info docs dev-roadmap timeline license

Building on the success of HOT's Tasking Manager, a tool for coordinating remote digitization of map features, the FMTM was conceived with the purpose of tagging the features with field-verified information.

While there are many excellent applications for tagging map features already, the FMTM aims to solve the problem of coordinating field mapping campaigns.

More details can be found here: overview, timeline, docs page, and the FAQ.

How FMTM Works

  1. Project is created in an area with three things:
    • Data extract: the features you want to map, say building polygons.
    • ODK XLSForm: the survey for mappers on the ground to fill out for each feature.
    • Task areas divided by feature count and linear features (e.g. rivers, roads).
  2. Users assign a task area for themselves, and generate a QR code that is opened in ODK Collect.
  3. User navigates to the feature and fills out the XLSForm survey, then submits.
  4. The submissions are collected by ODK Central, which feeds the data back into FMTM, for cleaning, conflation with existing data, and pushing back to OSM.

Usage of ODK

This project relies heavily on the ODK ecosystem underneath:

  • XLSForms are used for the underlying data collection survey. The fields in this survey can be mapped to OpenStreeMap tags.
  • ODK Central is used to store the XLSForm and receive data submissions from users.
  • ODK Collect is a mobile app that the user submits data from.

Contributing 👍🎉

In the wake of the 2010 Haiti earthquake, volunteer developers created the Tasking Manager after seeing a similar coordination challenge for mapping areas without existing data.

Now with over 500,000 volunteer mappers, the Tasking Manager is a go-to resource for volunteers to map collaboratively.

To aid future disaster response, we would really welcome contributions for:

  • Backend Python development
  • Frontend Typescript development
  • Documentation writers
  • UI / UX designers
  • Testers!
  • XLSForm creators
  • Mobile developers

Please take a look at our Documentation and contributor guidance for more details!

Reach out to us if any questions!

Install

To install for a quick test, or on a production instance, use the convenience script:

curl --proto '=https' --tlsv1.2 -sSf https://get.fmtm.dev | bash

Alternatively see the docs for various deployment guides.

Roadmap

Status Feature
🖥️ project area splitting avoiding roads, rivers, railways
🖥️ XLSForm generation in ODK Central
📱 mapping of project via survey in ODK Collect mobile app
📱 locking & unlocking of tasks to coordinate mapping
📱 download base imagery & geolocation for in the field
🖥️ view mapper submissions in the FMTM dashboard
📢 Beta Release
🖥️ & 📱 basic user tutorials and usage guides
📱 open ODK Collect with feature already selected
📱 live updates during mapping (if online)
📱 features turn green once mapped
⚙️ 📱 better support for mapping new points, lines, polygons
⚙️ 📱 navigation and capability for routing to map features
📱 integrate ODK Web Forms (to avoid switching apps)
📱 fully offline field mapping
🖥️ organization creation and management
🖥️ simplify project creation with basic / advanced workflows
🖥️ refinements to task splitting algorithm
🖥️ improvements to the validation criteria and workflow
🖥️ export (+merge) the final data to OpenStreetMap
🖥️ better data visualisation and export options
🖥️ Field Admin role

Note

📱 for mobile / mappers

🖥️ for desktop / managers / validators

A more developer-facing roadmap can be found here.

Contributors ✨

Here's how you can contribute:

Thanks goes to these wonderful people:

Ivan Gayton
Ivan Gayton

📆 💻 👀 🤔
Rob Savoye
Rob Savoye

🚧 🧑‍🏫 💻 👀 🤔
Ramya
Ramya

🐛 📖 🤔 🖋 🎨 📆
Sam
Sam

💻 👀 🚇 🤔 🚧 🧑‍🏫
Susmina_Manandhar
Susmina_Manandhar

📖 🤔 🐛 🧑‍🏫
Manjita Pandey
Manjita Pandey

🐛 📖 🤔 🖋 🎨 📆
Sujan Adhikari
Sujan Adhikari

💻 🚧
Nishit Suwal
Nishit Suwal

💻 🚧
Deepak Pradhan (Varun)
Deepak Pradhan (Varun)

💻 🤔 🚧
Niraj Adhikari
Niraj Adhikari

💻 🤔 🚧
krtonga
krtonga

💻 📖 🔧 🤔
Petya
Petya

📖 📋 🤔
Mohamed Bakari Mohamed
Mohamed Bakari Mohamed

💻
G. Willson
G. Willson

💻
JoltCode
JoltCode

💻
Neelima Mohanty
Neelima Mohanty

📖
Tayebwa Noah
Tayebwa Noah

📖
Mohammad Areeb
Mohammad Areeb

📖
AugustHottie
AugustHottie

📖
Ahmeed Etti-Balogun
Ahmeed Etti-Balogun

📖
Uju
Uju

📖
JC CorMan
JC CorMan

📖
Prajwal Khadgi
Prajwal Khadgi

💻
shushila21
shushila21

💻
Kshitij Raj Sharma
Kshitij Raj Sharma

💻
Mahesh-wor 'Invoron'
Mahesh-wor 'Invoron'

🚇
Azhar Ismagulova
Azhar Ismagulova

💻 ⚠️
synneolsen
synneolsen

🤔
Freedisch
Freedisch

💻
prasidha1
prasidha1

💻
Raj Bhattarai
Raj Bhattarai

💻
Sijan Dhungana
Sijan Dhungana

💻
Khushi Gautam
Khushi Gautam

📖
Aayam Ojha
Aayam Ojha

💻
Add your contributions

Repo Activity

FMTM Repo Activity