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 adicionais

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 punto coa coordenada en WGS84. Lon, Lat, Altitude segundo se envían polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - x(@position_coordinate) - IE
  • @position_horizontal_accuracy - A precisión horizontal da coordenada (en metros) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_timestamp - A data e hora da posición en UTC segundo informa o sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_direction - A dirección do movemento en grados dende o norte verdadeiro segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_ground_speed - Velocidade no terreo (en m/s) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_magnetic_variation - O ángulo entre a compoñente horizontal do campo magnético e o norte verdadeiro, en graos segundo o informado polo sensor. Tamén coñecido como declinación magnética. Un valor positivo indica unha dirección no sentido horario dende o norte verdadeiro e un valor negativo indica dirección antihoraria. Só está dispoñible cando o punto de mira se axusta ó sensor - IE
  • @position_vertical_accuracy - A precisión vertical da coordenada (en metros) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_3d_accuracy - A precisión tridimensional da coordenada (en metros), 3D-RMS segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_vertical_speed - A velocidade vertical (en m/s) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - IE
  • @position_pdop - Dilución da posición da precisión segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E
  • @position_hdop - Dilución horizontal da precisión segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E
  • @position_vdop - Dilución vertical da precisión segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E
  • @position_number_of_used_satellites - Número de satélites segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E
  • @position_used_satellites - Unha lista de satélites en uso (pri) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - array_count(@position_used_satellites) - E
  • @position_fix_status_description - O estado «SenDatos», «SenFixar», «Fixado2D» ou «Fixado3D» de fixación do GPS segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E
  • @position_fix_mode - Modo de fixación (onde “M” = Manual, forzado a operar en 2D ou 3D ou “A” = Automático, 3D/2D) segundo o informado polo sensor. Só está dispoñible cando o punto de mira se axusta ó sensor. - E

Todas as variables @position_* teñen unha variable @gnss_* correspondente. As variables gnss sempre informan dos valores do sensor gnss, mesmo cando o punto de mira non está axustado.

Exemplos:
  • cando o punto de mira está axustado ó sensor - @gnss_horizontal_accuracy –> A precisión horizontal da coordenada (en metros) segundo o informado polo sensor. - @position_horizontal_accuracy –> A precisión horizontal da coordenada (en metros) segundo o informado polo sensor. - @position_source_name –> nome do sensor.
  • cando o punto de mira se move manualmente - @gnss_horizontal_accuracy –> A precisión horizontal da coordenada (en metros) segundo o informado polo sensor. - @position_horizontal_accuracy –> O valor é NULO. - @position_source_name –> O valor é manual.

I: Fonte de posición interna E: Fonte de posición externa (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.

set up attributes with variables

Then the user assigns the role «digitizing logger» on a point layer.

Go to QFieldSync –> project Properties

set up vertex log

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

Compensación da altura da antena

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.