Skip to content

Commit 6c8fdb1

Browse files
authored
large files work both on ios and android (#736)
* large files work both on ios and android * rephrase tip
1 parent ba98373 commit 6c8fdb1

5 files changed

Lines changed: 16 additions & 21 deletions

File tree

src/field/offline-use/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ In general, layers that do not work offline are:
3434
#### Offline background maps
3535
Online background maps have to be prepared for offline use by generating **vector or raster tiles**. Detailed steps on how to do it can be found in [Background Maps](../../gis/settingup_background_map/).
3636

37-
Vector and raster tiles can be packaged in the project. However, as these files can be rather large, it might be impractical to synchronise them trough <MainPlatformNameLink />. [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) will show you how to get them in your mobile device.
37+
Vector and raster tiles can be packaged in the project. However, as these files can be rather large, it might be impractical to synchronise them trough <MainPlatformNameLink />. [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files) will show you how to get them in your mobile device.
3838

3939
#### Offline PostGIS layers
4040
If you use online PostGIS layers in your <MainPlatformName /> project and need to do an offline survey in the field, we recommend using [DB Sync](../../dev/dbsync/). DB Sync helps synchronising your PostGIS database and GeoPackage layers that can be edited offline using <MobileAppName />.

src/gis/settingup_background_map/index.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Make sure that you:
6161
- zoomed to your area of interest
6262

6363
To generate an offline copy of the aerial imagery from your map view extent:
64-
1. In QGIS, select **Processing** > **Toolbox** from the main menu. The **Processing** panel will appear on the right side of QGIS window.
64+
1. In QGIS, select **Processing** > **Toolbox** from the main menu. The **Processing** panel will appear on the right side of the QGIS window.
6565
2. In the search section on the top of the **Processing** panel, type *xyz* to display relevant tools.
6666
3. In **Raster tools**, double-click on **Generate XYZ tiles (MBTiles)**
6767
![QGIS generate XYZ tiles MBTiles](./qgis_xyz_gen_mbtiles1.jpg "QGIS generate XYZ tiles MBTiles")
@@ -76,7 +76,7 @@ To generate an offline copy of the aerial imagery from your map view extent:
7676
![QGIS generate XYZ tiles MBTiles settings](./qgis_xyz_gen_mbtiles2.jpg "QGIS generate XYZ tiles MBTiles settings")
7777

7878
:::warning
79-
Depending on the size of your study area and the zoom level, the output file can be very large. See how to [work with large files](#how-to-work-with-very-large-files-android) in <MobileAppName />.
79+
Depending on the size of your study area and the zoom level, the output file can be very large. See how to [work with large files](#how-to-work-with-very-large-files) in <MobileAppName />.
8080
:::
8181

8282
## Vector tiles
@@ -152,7 +152,7 @@ Vector tiles for offline use can be downloaded easily using <QGISPluginName />.
152152

153153
![QGIS download vector tiles dialog](./qgis-vector-tiles-set-extent.jpg "QGIS download vector tiles dialog")
154154

155-
MBTiles can be stored in your [<MainPlatformName /> project folder](../../manage/project/#mergin-maps-project-folder) and synchronised to <MainPlatformNameLink /> along with your project. If you find it impractical to synchronise them or if you want to use the same file in multiple projects, follow the steps on [How to work with large files](#how-to-work-with-very-large-files-android) in <MobileAppName />.
155+
MBTiles can be stored in your [<MainPlatformName /> project folder](../../manage/project/#mergin-maps-project-folder) and synchronised to <MainPlatformNameLink /> along with your project. If you find it impractical to synchronise them or if you want to use the same file in multiple projects, follow the steps on [How to work with large files](#how-to-work-with-very-large-files) in <MobileAppName />.
156156

157157
4. Click **Run**. After the vector tiles are generated and downloaded successfully, the MBTiles file will be added to the **Layers** panel. You may close the algorithm dialog window.
158158

@@ -163,31 +163,26 @@ Before taking your offline tiles to the field, we recommend checking in <MobileA
163163
:::
164164

165165

166-
## How to work with very large files (Android)
167-
<Badge text="Android only" type="warning"/>
166+
## How to work with very large files
168167

169168
Raster and vector tiles generated for offline use can be relatively large files, especially when using high resolution data or a large area of interest. It may be impractical to synchronise these large files through <MainPlatformNameLink /> or to have duplicate copies if they are used in multiple projects.
170169

171-
:::tip
170+
:::tip
172171
If you do not need to use your background maps offline, consider creating a WMS or WMTS server for online use.
173172
:::
174173

175-
QGIS uses relative paths to load the data. If your <MainPlatformName /> project refers to files located in another folder, this project can be loaded just fine on another computer or in <MobileAppName /> - if the folder with the files can be found in its expected location.
174+
QGIS uses relative paths to load the data. If your <MainPlatformName /> project refers to files located in another folder, this project can be loaded just fine on another computer or in <MobileAppName /> - if the folder with the files can be found in its expected location. Note that multiple projects can refer to the same files.
176175

177176
1. On your computer, create a folder that will contain the large datasets (here: `_rasters`). It should be located in the same directory as your <MainPlatformName /> projects.
178177
![File folder storing large data](./bm-folder-large-files.jpg "File folder storing large data")
179178
2. Open your <MainPlatformName /> project in QGIS. Load the files from the `_rasters` folder to the project. Save and sync.
180179

181-
3. Connect your mobile device to the computer and copy the `_rasters` folder to the app's project folder `Internal storage/Android/data/uk.co.lutraconsulting/files/projects`.
182-
183-
See [Manual data transfer (Android)](../../manage/missing-data/#manual-data-transfer-android) for detailed steps.
180+
3. Connect your mobile device to the computer and copy the `_rasters` folder to the app's project folder
181+
- on Android, follow the steps described in [Manual data transfer (Android)](../../manage/missing-data/#manual-data-transfer-android)
182+
- on iOS, follow the steps described in [Manual data transfer (iOS)](../../manage/missing-data/#manual-data-transfer-ios)
184183

185-
4. Use the project in <MobileAppName /> as usual.
186-
187-
:::tip
188-
Files from the folder can be loaded into multiple <MainPlatformName /> projects.
189-
:::
184+
4. Use the project in the <MobileAppNameShort /> as usual.
190185

191-
:::warning
192-
Files located in the another folder are not synchronised. This saves your storage on <ServerCloudNameLink />. However, if you want to update or modify these files, you have to connect the mobile device to your computer and do it manually.
186+
:::warning These files are not synchronised
187+
Files that are not located directly in the <MainPlatformName /> project folder are not synchronised. This saves your storage on <ServerCloudNameLink />. However, if you want to update or modify these files, you have to connect the mobile device to your computer and do it manually.
193188
:::

src/manage/project/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,5 +91,5 @@ It is best to store all survey layers and relevant datasets in the project's fol
9191
:::tip
9292
It is possible to use files that are stored in other folders in <MobileAppName />. However, these folders have to be [manually transferred](../missing-data/#manual-data-transfer-android).
9393

94-
This can be useful when working with [very large datasets](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) such as large rasters or background maps.
94+
This can be useful when working with [very large datasets](../../gis/settingup_background_map/#how-to-work-with-very-large-files) such as large rasters or background maps.
9595
:::

src/manage/selective_sync/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Selective sync feature adds a possibility to not download specified files on oth
99
Selective sync is useful mainly when a project contains a lot of data (for example photos) and these data do not necessarily need to be stored on all devices. Another advantage is a significant reduction of synchronisation time.
1010

1111
:::tip
12-
If you want to use large files (e.g. background maps) in your <MainPlatformName /> project without synchronisation, see [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android).
12+
If you want to use large files (e.g. background maps) in your <MainPlatformName /> project without synchronisation, see [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files).
1313
:::
1414

1515
See the example in the picture below. Two surveyors Jim and Susan are capturing features in the field. When it comes to synchronisation, Jim hits the [arrow icon](../plugin/) to synchronise his changes. Features together with photos are now stored on the server. When Susan synchronises the project, synchronisation first downloads Jim's changes (including photos) and after that uploads Susan's changes to the server. However, selective sync can exclude photos from being downloaded.

src/migrate/qfield/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,7 @@ In our blog <MainDomainNameLink id="blog/qfield-vs-mergin-maps" desc="QField vs.
119119

120120
Here is a non-definitive list of other known differences:
121121

122-
* QField mobile app can work without QFieldCloud (server) via USB transfer of the projects. This is not available in <MainPlatformName />, but you can [manually download](../../manage/missing-data/) your data or [upload large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) to your mobile device if needed.
122+
* QField mobile app can work without QFieldCloud (server) via USB transfer of the projects. This is not available in <MainPlatformName />, but you can [manually download](../../manage/missing-data/) your data or [upload large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files) to your mobile device if needed.
123123
* *Organisation teams* in QFieldCloud do not have any equivalent concept in <MainPlatformName />. On <MainPlatformName /> can have different workspaces for different teams.
124124
* There is no concept of *secrets* in <MainPlatformName />. For `pg_service` configuration, you need to transfer it manually as described [here](../../gis/supported_formats/).
125125
* There is no concept of *managing ongoing jobs* or *triggers* in <MainPlatformName /> accessible for users. Users see the results when jobs are finished (e.g. map rendering).

0 commit comments

Comments
 (0)