Skip to content

hotosm/fmtm

Repository files navigation

Field Mapping Tasking Manager (FMTM)

HOT Logo

Coordinated field mapping for Open Mapping campaigns.

Version Version
Deployments Build and Deploy Production
Build and Deploy Staging
Build and Deploy Development
Images Build CI Img Build ODK Images πŸ”§ Build Proxy Images
Docs Publish Docs Publish Docs to Wiki
Tech Stack FastAPI React Postgres Kubernetes Docker
Code Style Backend Style Frontend Style pre-commit
Metrics All Contributors Coverage
Other Info docs user-roadmap 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 in this overview, timeline and the docs page.

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 diaster 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.

Contributors ✨

Thanks goes to these wonderful people:

Ivan Gayton
Ivan Gayton

πŸ“† πŸ’» πŸ‘€ πŸ€”
Rob Savoye
Rob Savoye

🚧 πŸ§‘β€πŸ« πŸ’» πŸ‘€ πŸ€”
Sam
Sam

πŸ’» πŸ‘€ πŸš‡ πŸ€” 🚧
Deepak Pradhan (Varun)
Deepak Pradhan (Varun)

πŸ’» πŸ€” 🚧
Niraj Adhikari
Niraj Adhikari

πŸ’» πŸ€” 🚧
krtonga
krtonga

πŸ’» πŸ“– πŸ”§ πŸ€”
Petya
Petya

πŸ“– πŸ“‹ πŸ€”
Sujan Adhikari
Sujan Adhikari

πŸ’» 🚧
Mohamed Bakari Mohamed
Mohamed Bakari Mohamed

πŸ’»
Nishit Suwal
Nishit Suwal

πŸ’» 🚧
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

πŸ’»
Manjita Pandey
Manjita Pandey

πŸ› πŸ“– πŸ€”
Susmina_Manandhar
Susmina_Manandhar

πŸ“– πŸ€” πŸ›
Add your contributions