Skip to content

Commit 92f0ae9

Browse files
committed
feat(street-tutorials): add street tutorial sample scenario and instructions README
1 parent 3826747 commit 92f0ae9

File tree

2 files changed

+75
-0
lines changed

2 files changed

+75
-0
lines changed
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
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
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"type": "FeatureCollection",
3+
"name": "cobblestone-scenario",
4+
"crs": { "type": "name", "properties": { "name": "urn:ogc:def:crs:OGC:1.3:CRS84" } },
5+
"features": [
6+
{
7+
"type": "Feature",
8+
"properties": { "id": "378811598610667", "reference": 0, "screen": 2 },
9+
"geometry": { "type": "Point", "coordinates": [ 13.45285, 52.508467, 0.0 ] }
10+
},
11+
{
12+
"type": "Feature",
13+
"properties": { "id": "1171343450849316", "reference": 1, "screen": 1 },
14+
"geometry": { "type": "Point", "coordinates": [ 13.4514123, 52.5103378, 0.0 ] }
15+
}
16+
]
17+
}

0 commit comments

Comments
 (0)