Skip to content

Commit

Permalink
edit features redesign
Browse files Browse the repository at this point in the history
  • Loading branch information
alex-cit committed Oct 27, 2024
1 parent 3d9d996 commit 9216c55
Show file tree
Hide file tree
Showing 28 changed files with 55 additions and 42 deletions.
97 changes: 55 additions & 42 deletions src/field/mobile-features/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@

[[toc]]

The <MobileAppNameShort /> can be used to add, edit and delete features in the field by users with [writer or editor permission](../../manage/permissions/) to the <MainPlatformName /> project. Changes can be [synchronised](../autosync/) manually or automatically.
The <MobileAppNameShort /> can be used to add, edit and delete features in the field by users with [writer or editor permission](../../manage/permissions/) to the <MainPlatformName /> project.

Until the project is synchronised to <MainPlatformNameLink />, all changes are local (stored only on your mobile device). Changes can be [synchronised](../autosync/) manually or automatically.

::: tip New to <MainPlatformName />?
If you are new to the <MobileAppNameShort />, it might be useful to get familiar with the [<MobileAppNameShort /> interface](../mobile-app-ui/) or to explore our [tutorials](../../tutorials/capturing-first-data/) that provide step-by-step instructions for common use cases.
Expand Down Expand Up @@ -39,77 +40,75 @@ There are two methods of capturing lines and areas: adding vertices one by one o
#### Adding points to survey vertices of lines or areas
Lines and areas can be captured by adding vertices one by one. When you are in the [**recording**](#adding-features) mode and your active layer is a line or polygon, you will see line and areas editing tools in the bottom panel.

Tap **Add** to capture vertices of your line or area. If you want to change the position of the last vertex, tap **Remove**, move the vertex to the correct place and **Release** it. **Undo** can be used to revert last changes.
Tap **Add** to capture vertices of your line or area. If you want to change the position of the last vertex, tap **Remove** and move the vertex to the correct place. **Undo** can be used to revert last changes.

Once the survey of the feature is completed, tap **Done** and fill in the form.
![Surveying lines in Mergin Maps mobile app](./input-capture-line.jpg "Surveying lines in Mergin Maps mobile app")
Once the survey of the feature is completed, tap **Record** and fill in the form.
![Surveying lines in Mergin Maps mobile app](./mobile-capture-line.jpg "Surveying lines in Mergin Maps mobile app")

#### Streaming mode to survey lines or areas
Lines and areas can be also captured automatically based on your position. Make sure you are in the [**recording**](#adding-features) mode and that your active layer is a line or polygon.

To turn on the streaming mode, long press the **GPS** button. To turn it off, long press the **GPS** button again.
Tap the **streaming** button and then **Start streaming mode**.

![GPS streaming mode to survey lines](./input-streaming-line.jpg "GPS streaming mode to survey lines")
![Mergin Maps mobile app start streaming mode](./mobile-streaming-mode-start.jpg "Mergin Maps mobile app start streaming mode")

Once you are finished, tap **Done**. If you are capturing an area, the shape will be automatically closed by connecting the last and the first vertex.
The vertices will be added automatically as you walk along the feature. To stop the streaming mode, tap the **streaming** button and then **Stop streaming mode**. You can combine streaming and adding vertices manually as needed.

You can change how often you want to capture a vertex in **Line rec. interval** in [**Settings**](../mobile-app-ui/#streaming-mode-and-recording-settings). The interval can be defined as time elapsed in seconds or as distance travelled in metres.
![Mergin Maps mobile app stop streaming mode](./mobile-streaming-mode-stop.jpg "Mergin Maps mobile app stop streaming mode")

:::tip
The recording interval can be defined also in metres as distance travelled.
Once you finished surveying the feature, tap the **Record** button. If you are capturing an area, the shape will be automatically closed by connecting the last and the first vertex.

:::tip Threshold intervals for streaming mode
It is possible to set the **Threshold interval**, i.e. how often you want to capture a vertex when streaming, in [**Settings**](../mobile-app-ui/#streaming-mode-and-recording-settings) of the <MobileAppNameShort />. The interval can be defined as *time elapsed* in seconds or as *distance travelled* in metres.
:::

### Add non-spatial features
[Non-spatial features](../../layer/non-spatial-data/) can also be added using <MobileAppName />. If you are using a non-spatial table for [value relations](../../layer/form-widgets/#value-relation) you can add and edit values in the app.
## Editing features
Features can be browsed, edited and deleted through the [Layers](../layers/) panel in <MobileAppName />.

1. Tap the **More** button and navigate to **Layers**
![Mergin Maps mobile app Layers panel](./input-layers.jpg "Mergin Maps mobile app Layers panel")
Tap the **Layers** button in the bottom navigation panel and select a layer to see the list of features it contains.

2. Choose the non-spatial layer and tap **Add feature**
![](./input-add-non-spatial-feature.jpg)

3. Fill in the attributes.
![Layers in Mergin Maps mobile app](./mobile-layers-browse-features.jpg "Layers in Mergin Maps mobile app")

## Editing features
Spatial and non-spatial features can be browsed, edited and deleted in the [Layers](../layers/) panel in <MobileAppName />. Tap on the **Layers** in the **More** tab and select a layer to see the features it contains.
![Mergin Maps mobile app Layers panel](./input-layers.jpg "Mergin Maps mobile app Layers panel")
To edit the attributes or geometry of a feature, select it from the list in the **Layers** panel or select the feature on the map.

Spatial features can be selected also on the map. Tap on a feature and press the edit button. Now you can change the attributes in the form. To edit the geometry of a feature, tap **Edit geometry** in the bottom panel.
Use the **Edit** button to open the attributes form. Here you can change the values of attributes as needed. To edit the geometry of a feature, tap the **Edit geometry** button.

![Edit attributes and geometry in Mergin Maps mobile app](./input-edit.jpg "Edit attributes and geometry")
![Edit attributes and geometry in Mergin Maps mobile app](./mobile-edit-features.jpg "Edit attributes and geometry")

To edit geometry of a point feature simply adjust the location by panning the map or use **GPS** in the same manner as when adding new features. Once you are happy with your changes, press **Done**.
To edit geometry of a point feature simply adjust the location in the same manner as when [adding new features](#capture-points).

Once you are finished with your changes, **Save** :heavy_check_mark: them.

### Edit geometry of lines or areas
Tap a line or polygon feature, press the **Edit** button and then use **Edit geometry**.

The vertices of the feature will be highlighted. You can move, release or remove them as needed. Tap the **Record** button to save the modified geometry.

It is also possible to edit the geometry of lines and areas. Tap on a line or polygon feature and press the **Edit** button. Then select **Edit geometry**.
![Editing line geometry in Mergin Maps mobile app](./mobile-edit-lines.jpg "Editing line geometry in Mergin Maps mobile app")

The vertices of the feature will be highlighted and you can move or remove them as needed. Press **Done** to confirm your changes.
The [streaming mode](#streaming-mode-to-survey-lines-or-areas) can be also used to edit the lines or areas. Tap the **More option** button and use the **Streaming mode**.

![Editing polygon geometry](./input-edit-polygon.jpg "Editing polygon geometry")
![Editing line geometry streaming](./mobile-edit-streaming.jpg "Editing line geometry streaming")

### Redraw geometry of lines or areas
The existing geometry of lines and areas can also be redrawn.
The existing geometry of lines and areas can also be redrawn completely.

Tap the **More option** button and select the **Redraw geometry** option.

In the feature's form, tap the **Advanced** button and select the **Redraw geometry** option. Now you can record the new geometry using the tools in the bottom panel.
Capture the new geometry of the feature using the editing tools and use the **Record** button to save your changes.

![Advanced editing redrawing geometry of polygons](./input-redraw-geometry.jpg "Advanced editing redrawing geometry of polygons")
![Redrawing geometry of a line feature](./mobile-redraw-features.jpg "Redrawing geometry of a line feature")

### Split geometry of lines or areas
Lines and areas can be split into two or more new features that will keep the same attributes as the original feature.

To split geometry of a feature:
1. Tap on a feature and press the edit button.
![Edit button in Mergin Maps mobile app](./input-edit-feature.jpg "Edit button in Mergin Maps mobile app")
Tap the **More option** button and select the **Split geometry** option. Create the splitting line by adding points.

2. Tap **Advanced** and select **Split geometry**
![Advanced editing split geometry](./input-split-geometry.jpg "Advanced editing split geometry")
When finished, tap **Done**.
![Edit button in Mergin Maps mobile app](./mobile-split-features.jpg "Edit button in Mergin Maps mobile app")

3. Create the splitting line by adding points. When finished, tap **Done**
![Drawing splitting line to split geometry](./input-split-geom-point.jpg "Drawing splitting line to split geometry")

4. In this case, two individual features are created. Both have the same attributes, except for `Feature ID` (one feature keeps the original id, the other gets a new one).
![Geometry split successfully into two features](./input-split-geom-done.jpg "Geometry split successfully into two features")
In this case, two individual features are created. Both have the same attributes, except for `Feature ID` (one feature keeps the original id, the other gets a new one).
![Geometry split successfully into two features](./mobile-split-features-complete.jpg "Geometry split successfully into two features")

## Snapping features

Expand All @@ -118,10 +117,24 @@ Snapping can be enabled in your <MainPlatformName /> project in QGIS to make the
If snapping is enabled, the crosshairs will turn purple and snap to vertices (left) or segments (right) of existing features when capturing new features or editing existing features.
![Snapping Vertices and Segments in Mergin Maps mobile app](../../gis/snapping/mobile-app-basic-snapping.jpg "Snapping Vertices and Segments in Mergin Maps mobile app")

## Add or edit non-spatial features
[Non-spatial features](../../layer/non-spatial-data/), such as tables for [value relations](../../layer/form-widgets/#value-relation), can also be added or edited in the <MobileAppNameShort />.

1. Tap the **Layers** button and select the layer you want to edit
![Mergin Maps mobile app Layers panel](./mobile-non-spatial-layers.jpg "Mergin Maps mobile app Layers panel")

2. Tap an existing feature to change it or tap the **Add feature** button to create a new feature
![Editing non-spatial features in Mergin Maps mobile app](./mobile-edit-non-spatial-layers.jpg "Editing non-spatial features in Mergin Maps mobile app")

3. Fill in the attributes and **Save** :heavy_check_mark: the changes

## Deleting features
To delete a feature, tap on it on the map and use the **Edit** button. Now you can delete the feature by tapping the **Delete** button. After confirming the deletion, the feature will be removed from the layer.

Until the project is synchronised to <MainPlatformNameLink />, these changes are only local. After synchronisation, they will be transferred to the cloud and can be shared with your collaborators.
1. Tap on a feature on the map or find it through [**Layers**](../../layers/)
2. Use the **Edit** button to open the attributes form
3. Tap the **Delete** button and confirm the deletion

After confirming that you want to delete the feature, it will be removed from the layer.

![Delete feature in Mergin Maps mobile app](./mobile-delete-feature.jpg "Delete feature in Mergin Maps mobile app")

Binary file modified src/field/mobile-features/mobile-active-layer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified src/field/mobile-features/mobile-active-layer.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file added src/field/mobile-features/mobile-edit-lines.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/mobile-features/mobile-edit-lines.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.

0 comments on commit 9216c55

Please sign in to comment.