Merge pull request #629 from MerginMaps/iss_628-map-annotations

Map sketching

Author: alex-cit

src/.vitepress/sidebar/en.js

@@ -91,6 +91,7 @@ export default {
         { text: 'Synchronisation in Mergin Maps Mobile App', link: '/field/autosync/' },
         { text: 'Measurement Tools', link: '/field/measure/' },
         { text: 'Layers in Mergin Maps Mobile App', link: '/field/layers/' },
+        { text: 'Map Sketching', link: '/field/map-sketching/' },
         { text: 'How to Add, Edit, Delete Features', link: '/field/mobile-features/' },
         { text: 'How to Reuse Last Entered Values', link: '/field/reuse-last-values/' },
         { text: 'How to Stake Out Points', link: '/field/stake-out/' },

src/field/map-sketching/index.md

@@ -0,0 +1,50 @@
+# Map Sketching
+<!-- this link is used in the plugin -->
+
+[[toc]]
+
+Map sketches can be used to draw something on the map, in addition to the regular field collection of [features](../mobile-features/).
+
+## Enable map sketching
+
+Map sketching needs to be enabled in QGIS when [preparing your <MainPlatformName /> project](../../gis/features/#map-sketching).
+
+1. Open your <MainPlatformName /> project in QGIS
+2. Navigate to **Project** > **Properties** 
+   ![QGIS Project Properties](../../gis/qgis-project-properties.jpg "QGIS Project Properties")
+
+3. In the <MainPlatformName /> tab, check the **Enable map sketching** option.
+   ![Enable map sketching in QGIS Mergin Maps project](../../gis/features/project-map-sketching.jpg "Enable map sketching in QGIS Mergin Maps project")
+
+   You can also change the colour set to define the colours that will be available in the <MobileAppNameShort />.
+
+4. Save the changes. 
+
+   A new layer named **Map sketches** (`map_sketches.gpkg`) will be added to the project. This layer is used to store the map sketches.
+
+5. Save and synchronise your project!
+
+::: tip 
+If you do not see this option in the **Project properties**, check for [plugin upgrades](../../setup/install-mergin-maps-plugin-for-qgis/#plugin-upgrade).
+:::
+
+## Map sketching in the mobile app
+To use map sketches in the <MobileAppNameShort />, make sure they are [enabled in the project](#enable-map-sketching).
+
+1. Tap the **Map sketching** button
+   ![Map sketching button in Mergin Maps mobile app](./mobile-map-sketching-button.jpg "Map sketching button in Mergin Maps mobile app")
+
+2. The **Sketch** bar appears.
+   - Draw your sketches on the map by freehand or using a stylus. You choose from 7 annotation colours. The colour set can be changed in the [project properties](#enable-map-sketching) in QGIS.
+   ![Map sketches in Mergin Maps mobile app](./mobile-map-sketching.jpg "Map sketches in Mergin Maps mobile app")
+
+   - Made a mistake? Use the **Eraser** button to remove your sketches.
+   ![Erase map sketches in Mergin Maps mobile app](./mobile-map-sketching-eraser.jpg "Erase map sketches button in Mergin Maps mobile app")
+   
+   - Use the **Undo** button to revert the last changes.
+
+4. Sync your changes to <MainPlatformNameLink />.
+   
+   In QGIS, the map sketches will be displayed in the **Map sketches** layer.
+   ![Map sketches in Mergin Maps project in QGIS](./qgis-map-sketching.jpg "Map sketches in Mergin Maps project in QGIS")
+