Mozambique/Import Mozambique Education Facilities Workflow
Import Mozambique Education Facilities Workflow
In this wiki we will describe the step-by-step workflow to import the Mozambique schools
- The country schools data has been clipped into District files eg Angoche_Schools.osm
- Each mapper is assigned a District file.
- The mapper processes the file in JOSM using the Todo List plugin.
- A Validator checks the uploaded changesets.
Quick Reference
In case you have read and understood this workflow, you can refresh all steps here.
- Setup: Install the Todo list and UtilsPlugin2 plugins in JOSM.
- Load Data: Open the .osm file provided for your assigned District.
- Prepare OSM Data: Download existing OSM data for the area covered by your district (or download it dynamically as you work).
- Setup Todo List: Select all nodes in the Import layer and add them to the Todo list.
- Process Nodes: Double-click the first node in the Todo list to zoom to it.
- Validation Loop:
- Check Location: Verify against Bing/Maxar imagery. Move if necessary.
- Check Tags: Ensure
name=*,isced:level=*, andoperator:type=*are correct. - Conflation: If a school already exists in OSM nearby, **merge** the new data into the existing node (Ctrl+Shift+G) and delete the duplicate.
- Cleanup: Remove any temporary tags (e.g.,
fixme=*or raw source columns) if strictly necessary.
- Mark as Done: Click "Mark" in the Todo list to move to the next school.
- Upload: Upload your changesets using your **Import Account**.
- Notify Validator: Inform the project coordinator that your district is complete.
Presentation
Import rules in OSM
- Dedicated Account: You must use a specific OSM user account Username_Import separate from your personal account.
- Do not delete existing schools data. Merge the new attributes into existing schools.
The Mozambique Schools Data
The data comes from the Ministry of Education via Giga. It includes names, education levels (EP1, EP2, ESG), and connectivity status.
District Assignment
- You will be assigned a specific District.
- You will receive a JOSM-ready file for that district.
- You are responsible for importing/merging all schools in that district.
- Once finished, a second mapper (Validator) will review your changesets.
Workflow
1. Load the data
Open JOSM. Ensure you have the Todo list and UtilsPlugin2 plugins installed.
- Open the File: File > Open... > Select your assigned District_Name.osm file.
- Imagery: Load Bing and Esri World imagery.
- Background Data: You need existing OSM data to check for duplicates.
- Download OSM data for the area covering your district.
2. Set up the Todo List
Use the Todo List to ensure we visit every single school node without missing any.
- Select All nodes in your Import Data layer (Ctrl+A).
- Click the Add button in the Todo List window.
- Click anywhere on the map to unselect the nodes.
3. Processing the Educational Facilities
Double-click on the first node in the Todo List. JOSM will zoom to that location.
Step A: Check Context & Download OSM Data
If you haven't downloaded the full district data:
- Click File > Download in current vie
- Check if there is already a school mapped at this location in the standard OSM Data layer.
Step B: Check Location
Compare the node location with satellite imagery.
- Visible School: If you see buildings that look like a school, move the node to the center of the compound.
- No Visible School: If the location is in a forest or empty field:
- Try checking different imagery (Maxar, Esri).
- If the point exists in a place that is completely un unihabited and far away from any settlements, delete it, do not import it
- If the point exists in a place with buildings but they do not look like a school, add a
fixme=Please, check the position of the node
Step C: Check Tags
Verify the tags match the OSM schema:
- Name: Ensure
name=*is in Title Case (e.g., "Escola Primária de Maputo", not "ESCOLA PRIMARIA DE MAPUTO"). - Levels: Check
isced:level=*. e.g., 1;2 for Primary + Secondary.
Step D: Merge (Conflation)
Scenario 1: No existing school in OSM.
- Proceed. The node is ready to upload.
Scenario 2: School already exists in OSM.
- Select the Existing OSM Node AND the New Import Node.
- Press Ctrl+Shift+G (Merge Nodes).
- A conflict window may appear. **Resolving Conflicts:**
- Coordinates - Keep the most accurate position (usually the one visible on satellite).
- Tags: Keep the existing OSM history. Add new tags (like
ref:mined=*,internet_access=*) from the import node.
Step E: Mark as Done
Click the Mark button in the Todo List. JOSM will automatically zoom to the next school. Repeat Steps A-D.
4. Uploading
Once you have checked through all the points, upload the data OpenStreetMap
- Press Ctrl+Shift+Up (Upload).
- Changeset Comments:
- Click Upload Changes.
5. Validation
Once you have processed all items in your Todo List:
- Contact the project coordinator.
- A Validator will review your changesets using OSMCha.
- If errors are found (e.g., duplicates, bad tagging), you may be asked to fix them.