Skip to content

Commit

Permalink
[pre-commit.ci] auto fixes from pre-commit.com hooks
Browse files Browse the repository at this point in the history
for more information, see https://pre-commit.ci
  • Loading branch information
pre-commit-ci[bot] committed Jan 7, 2025
1 parent c1779e4 commit 187094b
Showing 1 changed file with 56 additions and 57 deletions.
113 changes: 56 additions & 57 deletions docs/about/FMTM Field Mapping Guidelines.md
Original file line number Diff line number Diff line change
@@ -1,75 +1,74 @@

# Guidelines for project manager

## **During Project creation**

### **Defining the Project Boundary**

- Confirm the exact area for the survey before creating
the project, as the project boundary cannot be
edited once the project is created.
the project, as the project boundary cannot be
edited once the project is created.

### **Preparing Map Features**

- Ensure you have the map features ready for the area
you plan to survey before starting project creation.
you plan to survey before starting project creation.
- The files should be in GeoJSON format, use the WGS coordinate
system with EPSG 4326, and must not include
a Z-coordinate. The map feature file should follow the
osm tags structure.
system with EPSG 4326, and must not include
a Z-coordinate. The map feature file should follow the
osm tags structure.
- Below is a sample of the required file structure:

```json
{
"type": "Feature",
"properties": { "full_id": "r9517874",
"osm_id": "9517874",
{
"type": "Feature",
"properties": { "full_id": "r9517874",
"osm_id": "9517874",
"osm_type": "relation"
"tags": {"building": "yes"},
"type": "multipolygon",
"name": "",
"building:levels": "" },
"geometry": { "type": "MultiPolygon", "coordinates": [ [ [
[ -3.9618848, 5.3041323 ],
[ -3.9615121, 5.3041457 ],
[ -3.9615028, 5.3038906 ],
[ -3.9618755, 5.3038772 ],
[ -3.9618848, 5.3041323 ]
],
[
[ -3.9620167, 5.3042236 ],
[ -3.9620143, 5.3041258 ],
[ -3.9619839, 5.3041266 ],
[ -3.9619757, 5.3037882 ],
[ -3.9614038, 5.3038019 ],
[ -3.9614144, 5.3042381 ],
[ -3.9620167, 5.3042236 ]
] ] ] }
"tags": {"building": "yes"},
"type": "multipolygon",
"name": "",
"building:levels": "" },
"geometry": { "type": "MultiPolygon", "coordinates": [ [ [
[ -3.9618848, 5.3041323 ],
[ -3.9615121, 5.3041457 ],
[ -3.9615028, 5.3038906 ],
[ -3.9618755, 5.3038772 ],
[ -3.9618848, 5.3041323 ]
],
[
[ -3.9620167, 5.3042236 ],
[ -3.9620143, 5.3041258 ],
[ -3.9619839, 5.3041266 ],
[ -3.9619757, 5.3037882 ],
[ -3.9614038, 5.3038019 ],
[ -3.9614144, 5.3042381 ],
[ -3.9620167, 5.3042236 ]
] ] ] }
},
```

- You may download features from OpenStreetMap (OSM)
by clicking on Fetch data from osm with FMTM project
creation; however, note that FMTM is not responsible
for the data quality of features extracted from OSM.
by clicking on Fetch data from osm with FMTM project
creation; however, note that FMTM is not responsible
for the data quality of features extracted from OSM.
- Currently, available types of survey features are Buildings
and Healthcare only. We plan to add more types of features moving ahead.
and Healthcare only. We plan to add more types of features moving ahead.
- Project managers can also upload supporting map features.
Note that these secondary features can’t be surveyed but
selected for respective primary features.
Note that these secondary features can’t be surveyed but
selected for respective primary features.

### **XLS Form Preparation**

- Be prepared with the XLS form for the project.
- If updates are required to the form, you can edit the
XLS form even after the project is created.
XLS form even after the project is created.
- Note that a few fields in the beginning and end of
the form will be injected to ask for some feature verification.
the form will be injected to ask for some feature verification.
- So project managers are requested to fill up the
form through odk or download the form after the project
is created to know about the field injected. You can also
get the fields injected from our documentation
[Here](https://docs.fmtm.dev/manuals/xlsform-design/#3-from-code-api)
form through odk or download the form after the project
is created to know about the field injected. You can also
get the fields injected from our documentation
[Here](https://docs.fmtm.dev/manuals/xlsform-design/#3-from-code-api)

Also read carefully the overview in the left section of
each step to understand the details of the functionalities.
Expand All @@ -81,8 +80,8 @@ during field mapping activity, then you have to add the
TMS link of that imagery during the first step of project creation.

- Click on _I would like to include my own imagery layer
for reference_ in the first step to add TMS URL. You can
get the URL by uploading it in openaerialmap.
for reference_ in the first step to add TMS URL. You can
get the URL by uploading it in openaerialmap.

### **ODK Central Credentials**

Expand All @@ -95,18 +94,18 @@ server by selecting HOT as your organization.
### **During Mapper Training**

1. Make sure mapper has downloaded custom odk collect from
FMTM website. You can also share the apk file if mappers
find it difficult to download by themselves.
FMTM website. You can also share the apk file if mappers
find it difficult to download by themselves.
2. Share the link of the project for the mapper to reach
to the project easily. The URL be:
[https://fmtm.hotosm.org/mapnow/project_id](https://fmtm.hotosm.org/mapnow/project_id)
to the project easily. The URL be:
[https://fmtm.hotosm.org/mapnow/project_id](https://fmtm.hotosm.org/mapnow/project_id)
3. **Updating Metadata**
If you need mappers to include their email
and phone number along with their username, guide them
to update their ODK Collect settings:
- Navigate to **Settings** for the project.
- Click on **User and Device Identity** to update the
metadata fields.
metadata fields.
4. **Test Submissions**
Encourage mappers to submit a few test entries to
familiarize themselves with the workflow and address
Expand All @@ -115,15 +114,15 @@ to the project easily. The URL be:
## **After Training**

1. Collect regular ongoing feedback from mappers to ensure
they face no difficulties during fieldwork.
they face no difficulties during fieldwork.
2. Prepare clear and detailed instructions for mappers and
validators, specific to the project requirements.
validators, specific to the project requirements.
3. Prepare the checklist for validation. The things to
check may depend on the type of project.
check may depend on the type of project.
4. Connect the odk central to powerBI or any other data
visualisation tool via Odata link to customise the charts and
graphs as per your need.
![odk_image](image.png)
visualisation tool via Odata link to customise the charts and
graphs as per your need.
![odk_image](image.png)

To get more info about project management in odk collect
follow the guide [Here](https://docs.getodk.org/collect-using/)

0 comments on commit 187094b

Please sign in to comment.