|
| 1 | +# Creating a New 'Street' Tutorial |
| 2 | +### Useful Links |
| 3 | +- MapSwipe Development Server: [https://dev-managers.mapswipe.org] |
| 4 | +- MapSwipe Development App Installation Guide: [https://github.com/mapswipe/mapswipe/wiki/How-to-test-the-development-version-of-MapSwipe](https://github.com/mapswipe/mapswipe/wiki/How-to-test-the-development-version-of-MapSwipe) |
| 5 | + |
| 6 | +## Select appropriate Mapillary imagery for the tutorial (with JOSM and Mapillary plug-in) |
| 7 | + |
| 8 | +1. Open JOSM. Make sure the [JOSM Mapillary plug-in](https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Mapillary) is installed |
| 9 | +2. **File > Download data**. Select an area in which you expect appropriate example imagery available on Mapillary and **Download** |
| 10 | +3. **Imagery > Mapillary** to download sequences and images for the current area |
| 11 | +4. If helpful, use the Mapillary filter dialog to filter images (for start and end date, user and/or organization) |
| 12 | +5. Click **Mapillary** in Layers controls to select the Mapillary layer |
| 13 | +6. Zoom in until you can see images location markers (green dots) |
| 14 | +7. Click on the dots to view the images |
| 15 | +8. Once you have found an image that you would like to use in your tutorial, **File > Export Mapillary images** and select **Export selected images** |
| 16 | +9. Click **Explore** |
| 17 | +10. Choose a parent folder for all images in this tutorial |
| 18 | +11. **OK** |
| 19 | +12. Repeat until you have exported all the images that you would like to use in the tutorial. Use the same parent folder for all images. |
| 20 | + |
| 21 | +## Add exported Mapillary images as geotagged images in QGIS |
| 22 | + |
| 23 | +1. Open QGIS |
| 24 | +2. **Processing Toolbox > Vector creation > Import geotagged photos** |
| 25 | +3. Select the folder containing all exported Mapillary images and check **Scan recursively** |
| 26 | +4. **Run** |
| 27 | +5. **Properties > Display** and add `<img src="file:///[% photo %]" width="350" height="250">` to HTML Map Tip to show images on a pop up |
| 28 | +6. **View > Show Map Tips** |
| 29 | +7. If you keep the mouse tip on the image markers, a pop up with the image will appear |
| 30 | + |
| 31 | +## Edit geotagged images in QGIS |
| 32 | + |
| 33 | +1. Right click on layer. |
| 34 | +2. **Properties > Field** |
| 35 | +3. **Toggle editing mode** |
| 36 | +4. Change the name of the `filename` column to `id` |
| 37 | +5. Add `Integer (32 bit)` columns titled `screen` and `reference`. |
| 38 | +6. Populate the `reference` and `screen` fields. |
| 39 | + * `reference` is the value of the correct answer option for the image. |
| 40 | + * `screen` determines the order of the images in the tutorial and should start with `1`. |
| 41 | +7. Delete any rows representing images that you do not want to use |
| 42 | + |
| 43 | +## Export as GeoJSON |
| 44 | + |
| 45 | +1. **Toggle editing mode** |
| 46 | +2. **Save** |
| 47 | +3. Right click, **Export > Save Features As...** |
| 48 | +4. Choose Format GeoJSON, CRS EPSG:4326 - WGS 84 |
| 49 | +5. Select only `id`, `reference` and `screen` as fields to export. Deselect all other fields. |
| 50 | +6. Choose a file name and location and click OK to save |
| 51 | + |
| 52 | +## Create tutorial |
| 53 | + |
| 54 | +1. Go to https://dev-managers.mapswipe.org/ |
| 55 | +2. Select **Projects** and then **Add New Tutorial**. |
| 56 | +3. Check that **Project Type** is set to **Street**. |
| 57 | +4. Fill in all the fields, following the instructions. Upload your `GeoJSON` you just created with the scenarios where it says **Scenario Pages**. |
| 58 | +5. Submit |
0 commit comments