ResqGuessr

Local Knowledge Training Tool for Rescue Workers, inspired by GeoGuessr

This tool is designed to help rescue workers, such as ambulance drivers, improve their knowledge of streets and important points of interest (POIs) in their area. Users are given the name of a POI, such as hospitals, nursing homes, or fire stations, or a street name, and must select the correct location on the map. This helps responders navigate more efficiently to critical destinations, making it ideal for training and improving response times.

There is a hosted test Version with Data of the German city Wilhelmshaven: pq5.de/ResqGuessr

Features

• Utilizes Leaflet and OpenStreetMap for map visualization and interaction.
• Customizable POI and street data.
• Responsive design for web-based training.

Installation

1. Clone the repository:

   git clone https://github.com/goerdy/ResqGuessr.git

2. Copy to your web server or start a local web server with:

   python -m http.server 8000  

Configure

Folder Structure

ResQGuessr
|- assets
   |- Icons
|- streets
   |- streets.json
   |- YourCity_streets
     |- street1.geojson
     |- ...
|- tools
   |- LocationDownloader.py
   |- StreetDownloader.py
|- app.js
|- index.html
|- LICENSE
|- locations.json
|- README.md
|- settings.json
|- styles.css

• settings.json (basic information, center of the map, and default zoom level):

{
    "title": "Title of your Instance, maybe your Cityname",
    "description": "A short description about the purpose and the target group, this is shown in the help dialog",
    "timeLimit": 30, // seconds to click, reduce to increase the difficulty
    "maxDistance": 500, // allowed distance between users click and the POIs possition in meters, reduce to increse difficulty
    "map": {
        "center": {
            "latitude": 53.549487, // center of the Map
            "longitude": 8.100014 // could be your citycenter
        },
        "zoom": 12 //zoomlevel, adjust to fit your are in one Map window
    },
    "maintainer": {
        "name": "Your Name",
        "organization": "Yor Organisations name",
        "email": "yourName@YourOrganisation.xyz"
    },
    "version": "0.0.2",
    "license": "MIT License",
    "github": "https://github.com/goerdy/ResqGuessr"
}

• locations.json (enter your POIs with name, longitude, and latitude).

Json file with all your Locations. available groups are: "Hospitals", "Nursing", "Rescue", "Special", "Misc"

[
 {
     "name": "Your POI 1",
     "latitude": 53.545714,
     "longitude": 8.082805,
     "group": "Hospitals"
 },
 {
     "name": "Your POI 2",
     "latitude": 53.516567,
     "longitude": 8.120608,
     "group": "Nursing"
 },
]

• streets.json (contains a List of all dedicated street files).

The Streetfiles can be made manually, but its highly recommend to use the tool/StreetDownloader.py

   [
   "yourcity_streets/mainstreet.geojson",
   "yourcity_streets/upperstreet.geojson",
   "yourcity_streets/parkway.geojson"
   ]

Tools

StreetDownloader

Downloads all Streets of a given City or Area to separate geojson files and creates a street.json file as lookup.

Start with

python StreetDownloader.py

You will be asked after the City Name and then it might take some time depending on the number of streets and OVERPASS-API restrictions.

LocationDownloader

Downloads a set of locations (Hospitals, Fire Strations, Nursing Homes) of a given City or Area to locations.json file.

Start with

python locationDownloader.py

You will be asked after the City Name and then it might take some time depending on the Citys size and OVERPASS-API restrictions. ATTENTION: The results are quite depending on the OpenStrettMap Data quality in that area. You will need to check that Data carefully.

To-Do / known issues

• localisation with external locales file for multilanguage support
• Improve of distance calculation between UserPoint and Streets
• Handling of non latin Streetnames (Filenames)

Please report Bugs!