Mozambique/Import Mozambique Education Facilities Workflow

From OpenStreetMap Wiki
Jump to navigation Jump to search

< Mozambique

Import Mozambique Education Facilities Workflow

In this wiki we will describe the step-by-step workflow to import the Mozambique schools

  1. The country schools data has been clipped into District files eg Angoche_Schools.osm
  2. Each mapper is assigned a District file.
  3. The mapper processes the file in JOSM using the Todo List plugin.
  4. A Validator checks the uploaded changesets.

Quick Reference

In case you have read and understood this workflow, you can refresh all steps here.

  1. Setup: Install the Todo list and UtilsPlugin2 plugins in JOSM.
  2. Load Data: Open the .osm file provided for your assigned District.
  3. Prepare OSM Data: Download existing OSM data for the area covered by your district (or download it dynamically as you work).
  4. Setup Todo List: Select all nodes in the Import layer and add them to the Todo list.
  5. Process Nodes: Double-click the first node in the Todo list to zoom to it.
  6. Validation Loop:
    • Check Location: Verify against Bing/Maxar imagery. Move if necessary.
    • Check Tags: Ensure name=*, isced:level=*, and operator: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.
  7. Mark as Done: Click "Mark" in the Todo list to move to the next school.
  8. Upload: Upload your changesets using your **Import Account**.
    • Comment: comment=Mozambique Educational Facilities import, District [Name]
    • Source: source=Giga
  9. 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.

  1. Open the File: File > Open... > Select your assigned District_Name.osm file.
  2. Imagery: Load Bing and Esri World imagery.
  3. Background Data: You need existing OSM data to check for duplicates.
  4. 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.

  1. Select All nodes in your Import Data layer (Ctrl+A).
  2. Click the Add button in the Todo List window.
  3. 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:

  1. Click File > Download in current vie
  2. 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

  1. Press Ctrl+Shift+Up (Upload).
  2. Changeset Comments:
  1. Click Upload Changes.

5. Validation

Once you have processed all items in your Todo List:

  1. Contact the project coordinator.
  2. A Validator will review your changesets using OSMCha.
  3. If errors are found (e.g., duplicates, bad tagging), you may be asked to fix them.