Skip to content

GNSS bundle - Elevations, transformations, providers#727

Open
alex-cit wants to merge 8 commits intomainfrom
iss_701-describing-providers
Open

GNSS bundle - Elevations, transformations, providers#727
alex-cit wants to merge 8 commits intomainfrom
iss_701-describing-providers

Conversation

@alex-cit
Copy link
Contributor

@alex-cit alex-cit commented Feb 19, 2026

#701

  • 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

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

## Using custom geoid

The geoid model can be specified in [<MainPlatformName /> Project Properties](../../manage/plugin/#mergin-maps-project-properties) in QGIS. The grid shift file then needs to be packages with the project.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The geoid model can be specified in [<MainPlatformName /> Project Properties](../../manage/plugin/#mergin-maps-project-properties) in QGIS. The grid shift file then needs to be packages with the project.
The geoid model can be specified in [<MainPlatformName /> Project Properties](../../manage/plugin/#mergin-maps-project-properties) in QGIS. The grid shift file then needs to be packaged with the project.

I believe we agreed during designing that QGIS plugin will package the grid file behind the scenes, users will just specify which CRS they want to use.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, I rephrased it a bit - and this section will be rewritten to include the setup in plugin so we will go through it again :)

- `@position_elevation_ellipsoid` - Ellipsoidal height
- `@position_geoid_separation` - Geoid or quasi-geoid height (undulation)
- `@position_longitude` - Longitude
- `@position_elevation` - Orthometric or normal height. *May not be available for some providers, see [Elevations](../../gis/elevations/) for more detail.*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@position_altitude is still supported with the same value as @position_elevation

- for internal GPS, returns "<NoSpellcheck id="devicegps" />"
- for external GPS, returns the MAC address
- for [external GPS](../../field/external_gps/), returns the MAC address
- for [external GPS](../../field/external_gps/) if mock location is detected, returns "External (Mock)"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this line should be under @position_provider_name

- for external GPS, returns the name of the external device
- for [external GPS](../../field/external_gps/), returns the name of the external device
- `@position_provider_address` - GPS device address.
- for internal GPS, returns "<NoSpellcheck id="devicegps" />"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can be also android_fused & android_gps

- for external GPS, returns "external"
- for [external GPS](../../field/external_gps/), returns "external"
- `@position_provider_name` - GPS device name.
- for internal GPS, returns "Internal"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can be also Internal (fused) & Internal (gps)

@alex-cit
Copy link
Contributor Author

alex-cit commented Mar 5, 2026

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!

Copy link

@Withalion Withalion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The variables description looks alright now!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants