Outdated documentation
The latest documentation was moved to docs.qfield.org
GNSS and precision measurement
QField can make use of the internal GNSS (Global Navigation Satellite System, like GPS, GLONASS, Galileo or Beidou).
QField can also connect to external antennas through bluetooth and directly integrate their NMEA stream.
Quality indication
Variables supplémentaires
You can get access to positioning information through additional expression variables.
These will only be available when positioning is enabled.
These variables are commonly used as default values for fields to keep track of the quality of
individual measured points.
- @position_source_name
- The name of the device that gave location information as reported by the sensor. To differenciate between internal and external sensor. If the position is manually set, and the position is not snapped to the cursor, the source name is « manual ». In case the cursor is not snapped to the position, all other variables will be null, if you need this, use the ``gnss_`` variables instead.
- @position_quality_description
- A human readable and translated string for the quality as reported by the sensor. E.g. « Fixed RTK ». It is only available when the crosshair is snapped to the sensor.
- E
- IE
- @position_coordinate - Un point avec la coordonnée en WGS84. Lon, Lat, Altitude tels que fournis par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - x(@position_coordinate) - IE
- @position_horizontal_accuracy - La précision horizontale de la coordonnée (en mètres) telle que rapportée par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_timestamp - Horodatage de la position en UTC tel que rapporté par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_direction - Direction du mouvement en degrés par rapport au nord géographique comme indiqué par le capteur. Elle n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_ground_speed - Vitesse au sol (en m / s) telle que rapportée par le capteur. Elle n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_magnetic_variation - L’angle entre la composante horizontale du champ magnétique et le nord géographique, en degrés tel que rapporté par le capteur. Aussi connu sous le nom de déclinaison magnétique. Une valeur positive indique une direction horaire à partir du nord géographique et une valeur négative indique une direction anti-horaire. Il n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_vertical_accuracy - La précision verticale de la coordonnée (en mètres) telle que rapportée par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_3d_accuracy - La précision tridimensionnelle de la coordonnée (en mètres), 3D-RMS telle que rapportée par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_vertical_speed - La vitesse verticale (en m / s) indiquée par le capteur. Elle n’est disponible que lorsque la croix est accrochée au capteur. - IE
- @position_pdop - Position de dilution de précision comme indiqué par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - E
- @position_hdop - Dilution horizontale de la précision rapportée par le capteur. Elle n’est disponible que lorsque la croix est accrochée au capteur. - E
- @position_vdop - Dilution verticale de la précision rapportée par le capteur. Elle n’est disponible que lorsque la croix est accrochée au capteur. - E
- @position_number_of_used_satellites - Nombre de satellites rapporté par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - E
- @position_used_satellites - Liste des satellites utilisés (pri) tels que rapportés par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - array_count(@position_used_satellites) - E
- @position_fix_status_description - Le statut de la correction GPS « NoData », « NoFix », « Fix2D » ou « Fix3D » tel que rapporté par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - E
- @position_fix_mode - Mode fixe (où “M” = Manuel, forcé de fonctionner en 2D ou 3D ou “A” = Automatique, 3D / 2D) tel que rapporté par le capteur. Il n’est disponible que lorsque la croix est accrochée au capteur. - E
Toutes les variables de @position_* ont une variable @gnss_* correspondante. Les variables gnss signalent toujours les valeurs du capteur gnss, même lorsque la croix n’est pas accrochée.
- Exemples:
- Lorsque le réticule est accroché au capteur - @gnss_horizontal_accuracy -> précision horizontale de la coordonnée (en mètres) telle que rapportée par le capteur. - @position_horizontal_accuracy -> précision horizontale de la coordonnée (en mètres) telle que rapportée par le capteur. - @position_source_name -> nom du capteur.
- Lorsque la croix est déplacée manuellement - @gnss_horizontal_accuracy -> précision horizontale de la coordonnée (en mètres) telle que rapportée par le capteur. - @position_horizontal_accuracy -> La valeur est NULL. - @position_source_name -> La valeur est manual.
I: Source de position interne E: Source de position externe (NMEA)
Vertex log
It is possible to setup a log layer of the collected vertices.
This allows to keep track of meta data for each vertex like GNSS quality attributes and more.
To set this up, a point layer can be added to the project and attributes configured to store this information.
Then the user assigns the role « digitizing logger » on a point layer.
Go to QFieldSync –> project Properties
The layer fields must have default value with GNSS variables.
Accuracy requirement
A minimum desired accuracy for measurements can be defined.
The quality will be reported in three classes, bad (red), ok (yellow) and excellent (green).
These colors will show up as a dot on top of the GNSS button.
The thresholds can be defined in the positioning settings.
If the Enable accuracy requirement setting is activated, a user will not be able to collect
new measurements with the cursor snapped to the position with an accuracy value which is bad (red).
Altitude
Antenna height compensation
The height of the antenna pole in use can be defined in the settings.
Any measured altitude will be corrected by this value.
Altitude correction / vertical grid shift
Altitude values can be corrected with vertical grid shift files to calculate orthometric height
Vertical grid shift files have to be made available to QField by putting them into the QField base folder (<external storage>/QField/proj).
Once the grid shift file is placed there it is available in QField in the Positioning settings under Vertical grid shift in use.
If you are using altitude correction and an external bluetooth connected antenna consider turning Use orthometric altitude from device off.