GNSS bundle - Elevations, transformations, providers by alex-cit · Pull Request #727 · MerginMaps/docs

alex-cit · 2026-02-19T19:36:42Z

new page for elevations describing the providers and options
added note to height variables that they may not be available for all providers
List of known supported GPS devices updated: all "yes" for iOS devices set to "yes (mock)", fixed references in the table
plugin - option to define custom geoid / vertical crs

alex-cit · 2026-03-05T17:03:41Z

Thanks @Withalion for the review! I tried to fix most of them. Could you please go over the variables descriptions if it's correct now? Thank you!

Withalion

The variables description looks alright now!

alex-cit · 2026-06-10T10:34:52Z

rebased and:

added info about EPSG:4979
"custom geoid" renamed to "custom vertical reference system" as I think this is more consistent with the plugin (the setup in plugin is named "Vertical CRS"
we will need to update the screenshot used in https://merginmaps.com/docs/manage/plugin/#mergin-maps-project-properties , so that it includes both filtering and vertical CRS setup (for now I left the current screenshots with filtering that do not contain vertical CRS)

Withalion · 2026-06-15T10:59:53Z

+## Internal provider (no external device)
+
+### Android
+On Android, the [internal (fused)](../../field/mobile-app-ui/#gps-settings) GPS provider is used by default. It reports ellipsoidal heights that <MainPlatformName /> transforms to **orthometric heights using the EGM96 geoid model** by default and displays them in the [GPS info panel](../../field/mobile-app-ui/#current-position-and-gps-info).


While technical correct wouldn't the wording here be better to switch it up?
It reports ellipsoidal heights that transforms to orthometric heights using the EGM96 geoid model by default and displays them in the GPS info panel.
"It reports orthometric heights transformed from ellipsoid heights..."

Withalion · 2026-06-15T11:08:08Z

+
+![Mergin Maps QGIS plugin datum transformation warning](./plugin-transformation-warning.webp "Mergin Maps QGIS plugin datum transformation warning")
+
+To make sure that <MainPlatformName /> uses the correct operation, make sure that the datum transformation you want to used is defined in the **Transformations** tab in **Project Properties**.


make sure that the datum transformation you want to used is defined in the
missing word?

Withalion · 2026-06-15T11:12:22Z

- - for internal GPS, returns "internal"
- - for external GPS, returns "external"
+ - for internal GPS, returns `internal`
+ - for [external GPS](../../field/external_gps/), returns `external`


If this doc is also including the changes from network provider feature, then this either returns external_ip or external_bt.

Withalion · 2026-06-15T11:13:44Z

- - for internal GPS, returns "<NoSpellcheck id="devicegps" />"
- - for external GPS, returns the MAC address
+ - for internal GPS, returns `devicegps`, `android_fused` or `android_gps`
+ - for [external GPS](../../field/external_gps/), returns the MAC address


continuing from the comment above. This should return MAC address for Bluetooth devices and IP address with port for network devices

tomasMizera · 2026-08-12T14:07:41Z

 | Emlid | Reach RX models<sup><a href="#link-2">2</a></sup> | yes | yes (mock location) |
 | Emlid | Reach RS models<sup><a href="#link-3">3</a></sup> | yes | yes |
-| EOS | Skadi models<sup><a href="#link-11">11</a></sup> | yes | yes |
+| EOS | <NoSpellcheck id="Skadi" /> models<sup><a href="#link-11">11</a></sup> | yes | yes |


Why not adding this to the wordlist instead? I think it is already there (on main branch)

tomasMizera · 2026-08-12T14:13:54Z

+
+There are some differences in the functionality and available details depending on the GPS provider, the OS of the mobile device and the connection setup, namely the type of elevation provided, available [position variables](../../layer/variables/#position-variables) and whether it is possible to use [custom vertical reference system](#custom-vertical-reference-system).
+
+## Internal provider (no external device)


Are we using the "provider" term anywhere else in the docs? I am thinking "source" or "receiver" is more clear

alex-cit force-pushed the iss_701-describing-providers branch from e69ff61 to 562d0aaCompare February 26, 2026 13:31

alex-cit requested review from Withalion February 26, 2026 19:39

Withalion reviewed Mar 3, 2026
View reviewed changes

Withalion approved these changes Mar 5, 2026
View reviewed changes

alex-cit requested a review from tomasMizera March 31, 2026 09:23

tomasMizera mentioned this pull request Apr 27, 2026
add data types to extra variables #751
Closed

Withalion reviewed May 26, 2026
View reviewed changes

Comment threadsrc/gis/elevations/index.md

alex-cit added 11 commits June 10, 2026 11:41

elevations page
71ed331

spellcheck
0d21f6a

variables, supported gps
b3e73e3

elevations
68c1769

fix
627b96e

review
bdc6b8d

review
b1063f7

review
f0d6555

add ios mock location variables
58da15e

rebase + add info about CRS EPSG:4979
fac3c92

remove unused file
4a4e739

alex-cit force-pushed the iss_701-describing-providers branch from b63c5c4 to 4a4e739Compare June 10, 2026 10:28

fix broken link
261cf6c

tomasMizera requested a review from Withalion June 10, 2026 14:39

Withalion reviewed Jun 15, 2026
View reviewed changes

alex-cit added 2 commits June 15, 2026 16:26

review
650d794

added data types to variables
d09947f

alex-cit mentioned this pull request Jun 22, 2026
Iss 748 gps network provider #771
Merged

alex-citand others added 2 commits July 21, 2026 13:30

Merge branch 'main' into iss_701-describing-providers
a6c8403

spellcheck
e74c17f

fix broken link
b54b0d9

tomasMizera reviewed Aug 12, 2026
View reviewed changes

TM comments
81f3e22


		![Mergin Maps QGIS plugin datum transformation warning](./plugin-transformation-warning.webp "Mergin Maps QGIS plugin datum transformation warning")

		To make sure that <MainPlatformName /> uses the correct operation, make sure that the datum transformation you want to used is defined in the Transformations tab in Project Properties.


		There are some differences in the functionality and available details depending on the GPS provider, the OS of the mobile device and the connection setup, namely the type of elevation provided, available [position variables](../../layer/variables/#position-variables) and whether it is possible to use [custom vertical reference system](#custom-vertical-reference-system).

		## Internal provider (no external device)

Uh oh!

Conversation

alex-cit commented Feb 19, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

alex-cit commented Mar 5, 2026

Uh oh!

Withalion left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

alex-cit commented Jun 10, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

WithalionJun 15, 2026

Choose a reason for hiding this comment

Uh oh!

WithalionJun 15, 2026

Choose a reason for hiding this comment

Uh oh!

WithalionJun 15, 2026

Choose a reason for hiding this comment

Uh oh!

WithalionJun 15, 2026

Choose a reason for hiding this comment

Uh oh!

tomasMizeraAug 12, 2026

Choose a reason for hiding this comment

Uh oh!

tomasMizeraAug 12, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

alex-cit commented Feb 19, 2026•
edited
Loading

alex-cit commented Jun 10, 2026•
edited
Loading