Wunder Territories Updates with the Mapgen Tool¶

This guide explains how to update territories in Wunder using the Mapgen tool.

Prerequisites¶

• Mapgen Repository: The core tool for the update process.
• MyMaps Access: The source of truth for territories:
  • For access issues, please contact Dom Conneely Hughes.

Map Update Request Process¶

Dom typically requests map updates via Slack after making changes in MyMaps.

To upload these changes to Wunder, follow these steps:

1. Download the required KML and CSV files from MyMaps.
2. Place them in the mapgen/input folder.
3. Run the Mapgen tool to generate the processed files in mapgen/output.

You can view Wunder territories here:
👉 Wunder Territories

1. Download Files from MyMaps¶

Go to MyMaps, download the required layers, and rename them before placing them in mapgen/input.

• Parking Bays

  • Download as CSV
  • Rename to pb.csv

• NPA General

  • Download as CSV
  • Rename to npa.kml

• NPA Thames

  • Download as KML
  • Rename to npa_thames.kml

• The Forest

  • Download as KML
  • Rename to ba.kml

2. Run the Mapgen Tool¶

Once the input files are in mapgen/input, run:

uv run main.py

This will process the files and generate outputs in mapgen/output.

If Dom requires GeoJSON files, they can be found in:
📂 mapgen/output/geojson

3. Upload Changes to the Mapgen Repository¶

After generating the new files, commit and push them to the Mapgen repository.

Each new commit automatically triggers two GitHub Actions:

1. pages-build-deployment: Runs automatically and creates a page to preview the changes.

2. Update Territories Staging: Runs automatically and updates the new territories in Wunder’s staging environment.

3. Update Territories Production: Must be triggered manually to update the new territories in the production environment.

Following these steps ensures that the updated territories are available in Wunder and tools like ForestFleet and Forest App. 🚀