You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/gis/features/index.md
+65-48Lines changed: 65 additions & 48 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,13 @@
1
+
---
2
+
outline: [2, 3]
3
+
---
4
+
1
5
# QGIS Project Preparation
2
6
[[toc]]
3
7
4
8
Project preparation is done in QGIS. For more information about loading layers, styling the data and creating map themes, visit <QGISHelpver="3.22"link="user_manual/index.html"text="QGIS documentation page" />.
5
9
6
-
In addition, <MobileAppName /> uses some of the features within the project to help visualise, capture and browse the data. Here is an overview of the project preparations steps.
10
+
In addition, <MobileAppName /> uses some of the features within the project to help visualise, capture and browse the data. Here is an overview of the project preparations steps.
7
11
8
12
:::tip
9
13
Our tutorials can guide you through QGIS project preparation step by step.
@@ -13,6 +17,66 @@ In [Creating a Project in QGIS](../../tutorials/creating-a-project-in-qgis/) you
13
17
[Further Project Customisation](../../tutorials/further-project-customisation/) will show you how to style layers, add labels, customise the preview panel, define map themes and set up the project extent.
14
18
:::
15
19
20
+
## Survey layers
21
+
Vector layers can be used as survey layers in the <MobileAppNameShort />. You can apply styles and set up the forms to make your field survey easier.
22
+
23
+
Making changes in the data schema of layers can lead to issues in the synchronisation process. Be careful to [**deploy the revised project properly**](../../manage/deploy-new-project/). Design the data schema carefully when creating a layer to avoid the need to change it later.
24
+
25
+
Here are some practical tips for creating and maintaining layers in your project:
26
+
-**Always use GeoPackage for survey layers**. If you use other formats, such as ESRI shapefile, it is not possible to detect changes from other users and they may be overwritten. Overwritten files are stored in a conflict file.
27
+
-**Add some extra back-up field attributes** when creating a survey layer with different types (e.g. a couple of texts, int, real, date/time) and hide them in the form design. These can serve as a backup: if you need extra fields later in the survey, just alias these extra fields and add them to form.
28
+
- If you do not need a field, **remove it from the form**. You don't need to delete it from the table.
29
+
-**Instead of renaming a field, change its alias**.
30
+
-**Add new layers to your project as separate GeoPackages**. Do not add a new table to your existing GeoPackage that contains a survey layer. Just to be safe, it is better to have one GeoPackage for each of your survey layers.
31
+
- use **GeoTIFF** format for your raster files or store them in a separate GeoPackage database
32
+
33
+
### Layer symbology
34
+
The same symbology as defined in the QGIS project will be used in <MobileAppName />. However, <MobileAppName /> does not include all the SVG markers that are available within QGIS. Therefore, if you are using SVG markers for your layer styling, ensure those are copied to the project folder.
35
+
36
+
### Forms
37
+
During the field survey, it is often necessary to fill out some attributes in the form to record the properties of surveyed features. Forms can make the survey easier, consistent and more effective.
38
+
39
+
Detailed description of form widgets and form configuration can be found in the [Configure Form](../../layer/overview/) section.
40
+
41
+
### Settings for Mergin Maps mobile app preview panel
42
+
What appears in the <MobileAppName /> preview panel can be defined in the **Display** tab in **Layer Properties**:
43
+
-**Display Name**: a field name or an expression.
44
+
-**HTML Map Tip**: the content of the preview panel. While QGIS always interprets the content of map tip as being HTML, <MobileAppName /> extends the syntax to allow two more modes: field values and images. If the map tip is not specified, <MobileAppName /> will try to use the first three fields and show their attribute values.
Sample map tip content that will show render as HTML page:
50
+
51
+
```
52
+
<p><strong>Notes:</strong>[% "notes" %]</p>
53
+
```
54
+
55
+
If the map tip does not contain any special marker, it is assumed that the map tip is HTML content. Only a limited subset of HTML is supported - see [Qt documentation](https://doc.qt.io/qt-5/richtext-html-subset.html)
56
+
57
+
#### Field values
58
+
Sample map tip content that will show "description" and "time" field values:
59
+
60
+
```
61
+
# fields
62
+
description
63
+
time
64
+
```
65
+
66
+
If the map tip content has `# fields` marker on the first line, the following lines will be understood as field names that should be listed in the preview. At most three fields will be shown. Expressions are not allowed.
67
+
68
+
#### Image
69
+
Sample map tip content that will cause an image to be show specified by file path in field "image_1" (containing path relative to the project folder):
70
+
71
+
```
72
+
# image
73
+
file:///[%@project_folder%]/[% "image_1" %]
74
+
```
75
+
76
+
If the map tip has `# image` marker on the first line, the following line is understood as the URL for the image. It can be a regular file on the file system, but it could be even a remote image from the network. Expressions embedded in the image URL will be evaluated (enclosed in `[% 1+1 %]`).
77
+
78
+
![Preview panel in the mobile app based on Display settings in QGIS](./mobile-app-preview-panel.jpg"Preview panel in the mobile app based on Display settings in QGIS")
79
+
16
80
## Background layers
17
81
Various online and offline maps can be used as background layers for navigation during the field survey. You can find more information in [Background Maps](../settingup_background_map/).
18
82
@@ -98,51 +162,4 @@ You can read more about this functionality in [How to Use Tracking in Mergin Map
98
162
### Map themes
99
163
[Map Themes](../setup_themes/) make possible to switch between different background maps in <MobileAppName /> (e.g. cartography maps and aerial imagery)
100
164
101
-
## Survey layers
102
-
Vector layers can be used as survey layers in <MobileAppName />. You can apply styles and set up the forms to make your field survey easier.
103
-
104
-
### Layer symbology
105
-
The same symbology as defined in the QGIS project will be used in <MobileAppName />. However, <MobileAppName /> does not include all the SVG markers that are available within QGIS. Therefore, if you are using SVG markers for your layer styling, ensure those are copied to the project folder.
106
-
107
-
### Forms
108
-
During the field survey, it is often necessary to fill out some attributes in the form to record the properties of surveyed features. Forms can make the survey easier, consistent and more effective. Detailed description of form widgets and form configuration can be found in [Setting Up Form Widgets](../../layer/form-widgets/) and [Advanced Form Configuration](../../layer/form-configuration/).
109
-
110
-
### Settings for Mergin Maps mobile app preview panel
111
-
What appears in the <MobileAppName /> preview panel can be defined in the **Display** tab in **Layer Properties**:
112
-
-**Display Name**: a field name or an expression.
113
-
-**HTML Map Tip**: the content of the preview panel. While QGIS always interprets the content of map tip as being HTML, <MobileAppName /> extends the syntax to allow two more modes: field values and images. If the map tip is not specified, <MobileAppName /> will try to use the first three fields and show their attribute values.
Sample map tip content that will show render as HTML page:
119
-
120
-
```
121
-
<p><strong>Notes:</strong>[% "notes" %]</p>
122
-
```
123
-
124
-
If the map tip does not contain any special marker, it is assumed that the map tip is HTML content. Only a limited subset of HTML is supported - see [Qt documentation](https://doc.qt.io/qt-5/richtext-html-subset.html)
125
-
126
-
#### Field values
127
-
Sample map tip content that will show "description" and "time" field values:
128
-
129
-
```
130
-
# fields
131
-
description
132
-
time
133
-
```
134
-
135
-
If the map tip content has `# fields` marker on the first line, the following lines will be understood as field names that should be listed in the preview. At most three fields will be shown. Expressions are not allowed.
136
-
137
-
#### Image
138
-
Sample map tip content that will cause an image to be show specified by file path in field "image_1" (containing path relative to the project folder):
139
-
140
-
```
141
-
# image
142
-
file:///[%@project_folder%]/[% "image_1" %]
143
-
```
144
-
145
-
If the map tip has `# image` marker on the first line, the following line is understood as the URL for the image. It can be a regular file on the file system, but it could be even a remote image from the network. Expressions embedded in the image URL will be evaluated (enclosed in `[% 1+1 %]`).
146
-
147
-
![Preview panel in the mobile app based on Display settings in QGIS](./mobile-app-preview-panel.jpg"Preview panel in the mobile app based on Display settings in QGIS")
0 commit comments