Revolutionizing Field Mapping (with FMTM): Part 2
Posted by spwoodcock on 29 November 2023 in English. Last updated on 6 December 2023.See pt1 of this series here.
First Release
We have been running various versions of FMTM for some time now, but released our first official version not long ago: v0.1.0.
See the excellent release notes written by Susmina Manandhar, product manager for FMTM, for further details of features, bug fixes, and improvements.
Just to reiterate what a wonderful team of devs we have working on the project: https://www.openstreetmap.org/user/varun2948, https://www.openstreetmap.org/user/nrjadkry, https://www.openstreetmap.org/user/Sujanadh, https://www.openstreetmap.org/user/NSUWAL.
Special thanks for https://www.openstreetmap.org/user/JoltCode, an volunteer, who helped to modernise our frontend build tools. And to https://www.openstreetmap.org/user/robsavoye for his work on osm-fieldwork and osm-rawdata that underpin FMTM, plus guidance from the start.
Try it out!
I have been working to ease the installation process for organisations that need to run FMTM.
You can run a version of FMTM yourself with two commands!
curl -L https://get.fmtm.dev -o fmtm.sh
bash fmtm.sh
You will be prompted with a command line interface
Although HOT will endeavour to run a ‘global’ instance of FMTM, in a similar vein to Tasking Manager currently, my main goal is that FMTM is so simple to deploy, that a workflow such as this can be envisioned:
- Requirement for field mapping arises.
- Organisation spins up an instance of FMTM.
- Project manager creates a project, divides tasks.
- Team goes out to map the features.
- Data is validated, conflated with existing OSM data, and exported / uploaded.
- FMTM instance is shut down.
Technical aside / mad idea section:
To run FMTM, currently all you need is a server and a domain name.
In the future, this could be streamlined even further with a technology such as Headscale, creating a virtual private mesh network for mappers to connect to.
HOT could potentially run the Headscale control plane, so all project managers would need to do is run FMTM on their laptop/pc, configure the VPN for their users, then connect phones to the VPN (using an easy mobile app) for mapping!
Mobile First
We realised during various test with end users, that the UI was far from ideal to operate via mobile phone.
Significant updates have been made to the UI design, adopting a mobile-first approach to ease field usage for mappers on the ground.
We now also support map geolocation and orientation.
The project creation workflow has also undergone significant upgrades.
MBTile Output
Often mapping must be undertaken in areas with limited connectivity.
To still use a basemap to locate yourself, the MBTile format is useful. MBTiles can be generated directly in FMTM for download and use within ODK Collect.
Note: we are working with the developers of ODK Collect to make the process of loading MBTiles into the app a more seamless process.
Improved Deployment Process
As mentioned, HOT plans to maintain a series of FMTM servers for usage by the public.
In our newly improved deployment process, this is as follows:
-
https://fmtm.hotosm.org: the stable, well tested, production instance.
-
https://stage.fmtm.hotosm.org: the staging server for early feature adopters and power users.
The purpose behind having a staging server open to the public is to gather feedback and run public tests of new features.
Those wishing to use FMTM for a critical project should use the production server.
However, if you wish to have the latest features on FMTM as quickly as possible (the development pace is quite fast), but are willing to encounter the occasional bug, then feel free to use the staging server (and please provide feedback!).
The staging version should be updated every two weeks.
The stable version should be released every month.
Get Involved
Contributing to FMTM with code, documentation, or ideas would be very welcome!
Software developers, technical documentation writers, software testers, or anyone with a general interest - feel free to get in contact.
Future Posts
This was an update on some of the latest features of FMTM and future plans.
There is much that I could not cover, so please check Github for the latest updates!
I plan to make future posts about developments, technical deep dives, and usage of FMTM’s features.
See you next time.
Discussion
Comment from frozenrabi on 29 November 2023 at 15:01
Great initiation. My one wish with mbtiles- if we can download them with the required zoom level then it can be even better.
Comment from spwoodcock on 29 November 2023 at 23:06
Great feedback, thank you! The underlying code actually supports this, so making it configurable by the user should be easy enough 😄
Comment from Pradip Subedi on 6 December 2023 at 01:59
Amazing to see the evolution of HOT’s Field Mapping Tasking Manager. This tool empowers field mappers to make a difference. If you’re tech-savvy or have a passion for mapping, consider lending your skills to contribute. Let’s collaborate and map the world together🫰
Comment from spwoodcock on 6 December 2023 at 02:33
Thank you Pradip! Excited to see FMTM taking shape - it’s moved from a prototype to a usable tool very quickly!
Comment from mahjabin08 on 6 December 2023 at 03:16
Hi, amazing initiative. I would like to help out with the documentation, also i have interest in the development. Let me know what to do.. Thank you.
Comment from rsavoye on 6 December 2023 at 21:39
We definitely would love documentation contributions! We’re doing ok on technical documentation, but could really use more end-user focused documentation for field mappers and FMTM project managers. We also have a pile of documentation contributed by Outreachy interns which needs review and editing.
Comment from spwoodcock on 7 December 2023 at 10:41
That would be fantastic if you are able to contribute in either docs or code @mahjabin08!
Thank you for the offer 🙏
For code there are two routes: - Check the current issues on GitHub and leave a comment that you would like to work on something. We can have a discussion for how in the issue. - Join the HOTOSM Slack community & send me a message.
For docs, as Rob said having more usage guides and FAQs for mappers and managers would be great.
The best way to write those would be to give FMTM a go! Then write down the steps / any issues you faced =)
In general, all of the docs in the repo could do with proof reading and validating too. Thanks again!