Skip to content

Commit db8d2e0

Browse files
authored
How to add custom basemap (#790)
* Rework how to add custom basemap * Fix spellcheck
1 parent f43659f commit db8d2e0

5 files changed

Lines changed: 19 additions & 6 deletions

File tree

scripts/wordlist.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -327,3 +327,6 @@ DOM
327327
CDN
328328
submodules
329329
JavaScript
330+
EOS
331+
Skadi
332+
TCP
45.6 KB
Loading
148 KB
Loading
40.8 KB
Loading

src/manage/dashboard-maps/index.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Webmaps are **not** available for <CommunityPlatformNameLink /> at this point.
1818
## Project layers
1919
On the webmaps, you will see your survey layers or raster layers that are [packaged](../project/#packaging-qgis-project) with the project. The default extent of maps is defined by the [extent set in the QGIS project](../../gis/features/#project-extent).
2020

21-
All maps on the <DashboardShortLink /> by default use [<MainPlatformName /> vector tile service](../../gis/settingup_background_map/#online-services-1) as a background map.
21+
All maps on the <DashboardShortLink /> by default offer [<MainPlatformName /> vector tile service](../../gis/settingup_background_map/#online-services-1) as a background map, with three styles: default, light and dark.
2222

2323
The webmap is refreshed automatically, you will see the latest version of your project all the time, even without refreshing the web page.
2424

@@ -34,22 +34,32 @@ Click on a feature on the map to display its attributes.
3434
![Mergin Maps dashboard maps](./dashboard-map-properties.webp "Mergin Maps dashboard maps")
3535

3636
## Available layers
37-
Webmaps by default show layers that are packaged with the project. These are layers that are loaded from project files. These are usually GeoPackage layers, shapefile layers and background maps that are made available for offline use (e.g. mbtiles, GeoTIFF, ...).
37+
Webmaps by default show layers that are packaged with the project (loaded from project files). These are usually GeoPackage layers, shapefile layers and background maps that are made available for offline use (e.g. mbtiles, GeoTIFF, ...).
3838

3939
Layers requiring network connection (e.g. PostgreSQL layers or online background maps) are by default not included on the webmap due to potential performance and connectivity problems. However, certain network layers (such as satellite background map) can be added manually, read more in the [following section](#add-custom-background-maps).
4040

4141
### Add custom background maps
42-
If you prefer a different background map than the official one provided by default, there are currently two ways to add a custom background map:
42+
If you prefer a different background map than the official ones provided by default, you can add a custom one in the basemap selection.
4343

44-
1. **Map-script** - Map-script allows you to programmatically update and customise the webmap to your specific needs. Read more about `map-script` [here](../webmaps-applications/).
45-
2. **Package your background map** - Make your background map available offline in QGIS. This step packages the layer into a file and it will be visible on the webmap afterwards
44+
1. In the layers section, click on the top-left basemap selection item
45+
46+
![Mergin Maps webmaps background map selection](./basemap-selection.webp "Mergin Maps webmaps background map selection")
47+
48+
2. Click the `+ Add new` button
49+
50+
![Mergin Maps webmaps adding background map](./basemap-addition.webp "Mergin Maps webmaps adding background map")
51+
52+
3. Fill in the connection details of your background map. Please note that `vector tiles` and `raster tiles` are supported
53+
4. Hit `Add basemap` and your background map, if available, will be enabled automatically
54+
55+
![Mergin Maps webmaps satellite background map](./basemap-satellite.webp "Mergin Maps webmaps satellite background map")
4656

4757
:::warning Background maps licensing
4858
Keep in mind that background maps services and data sources come with their own terms of use, especially if they are to be publicly shared. You should comply with any terms and conditions of the services of your choice.
4959
:::
5060

5161
## Custom webmap applications <Badge text="Experimental 🧪" />
52-
As described in the previous section, webmaps can be further programmatically customised via `map-script` to build a custom webmap application. Read more about it [here](../webmaps-applications/).
62+
Webmaps can be further programmatically customised via `map-script` to build a custom webmap application. This feature can be used to add layers, alter visual and functional elements, and more. Read more [here](../webmaps-applications/).
5363

5464
## Extent
5565

0 commit comments

Comments
 (0)