Files
PX4-Autopilot/docs/en/msg_docs/AuxGlobalPosition.md
PX4BuildBot be784e21f7 docs: auto-sync metadata [skip ci]
Co-Authored-By: PX4 BuildBot <bot@px4.io>
2026-05-27 02:57:43 +00:00

94 lines
5.5 KiB
Markdown

---
pageClass: is-wide-page
---
# AuxGlobalPosition (UORB message)
Auxiliary global position.
This message provides global position data from an external source such as
pseudolites, visual navigation, or other positioning system.
**TOPICS:** aux_global_position
## Fields
| Name | Type | Unit [Frame] | Range/Enum | Description |
| ----------------------------------------------------------- | --------- | ------------ | ----------------- | --------------------------------------------------------------------------- |
| <a id="fld_timestamp"></a>timestamp | `uint64` | us | | Time since system start |
| <a id="fld_timestamp_sample"></a>timestamp_sample | `uint64` | us | | Timestamp of the raw data |
| <a id="fld_id"></a>id | `uint8` | | | Unique identifier for the AGP source |
| <a id="fld_source"></a>source | `uint8` | | [SOURCE](#SOURCE) | Source type of the position data (based on mavlink::GLOBAL_POSITION_SRC) |
| <a id="fld_lat"></a>lat | `float64` | deg | | Latitude in WGS84 |
| <a id="fld_lon"></a>lon | `float64` | deg | | Longitude in WGS84 |
| <a id="fld_alt"></a>alt | `float32` | m | | Altitude above mean sea level (AMSL) (Invalid: NaN) |
| <a id="fld_eph"></a>eph | `float32` | m | | Std dev of horizontal position, lower bounded by NOISE param (Invalid: NaN) |
| <a id="fld_epv"></a>epv | `float32` | m | | Std dev of vertical position, lower bounded by NOISE param (Invalid: NaN) |
| <a id="fld_lat_lon_reset_counter"></a>lat_lon_reset_counter | `uint8` | | | Counter for reset events on horizontal position coordinates |
## Enums
### SOURCE {#SOURCE}
Used in field(s): [source](#fld_source)
| Name | Type | Value | Description |
| --------------------------------------------------- | ------- | ----- | ------------------------------------------- |
| <a id="#SOURCE_UNKNOWN"></a> SOURCE_UNKNOWN | `uint8` | 0 | Unknown source |
| <a id="#SOURCE_GNSS"></a> SOURCE_GNSS | `uint8` | 1 | GNSS |
| <a id="#SOURCE_VISION"></a> SOURCE_VISION | `uint8` | 2 | Vision |
| <a id="#SOURCE_PSEUDOLITES"></a> SOURCE_PSEUDOLITES | `uint8` | 3 | Pseudolites |
| <a id="#SOURCE_TERRAIN"></a> SOURCE_TERRAIN | `uint8` | 4 | Terrain |
| <a id="#SOURCE_MAGNETIC"></a> SOURCE_MAGNETIC | `uint8` | 5 | Magnetic |
| <a id="#SOURCE_ESTIMATOR"></a> SOURCE_ESTIMATOR | `uint8` | 6 | Estimator |
| <a id="#SOURCE_LEO"></a> SOURCE_LEO | `uint8` | 7 | Low Earth Orbit satellite-based positioning |
## Constants
| Name | Type | Value | Description |
| --------------------------------------------- | -------- | ----- | ----------- |
| <a id="#MESSAGE_VERSION"></a> MESSAGE_VERSION | `uint32` | 1 |
## Source Message
[Source file (GitHub)](https://github.com/PX4/PX4-Autopilot/blob/main/msg/versioned/AuxGlobalPosition.msg)
::: details Click here to see original file
```c
# Auxiliary global position
#
# This message provides global position data from an external source such as
# pseudolites, visual navigation, or other positioning system.
uint32 MESSAGE_VERSION = 1
uint64 timestamp # [us] Time since system start
uint64 timestamp_sample # [us] Timestamp of the raw data
uint8 id # [-] Unique identifier for the AGP source
uint8 source # [@enum SOURCE] Source type of the position data (based on mavlink::GLOBAL_POSITION_SRC)
uint8 SOURCE_UNKNOWN = 0 # Unknown source
uint8 SOURCE_GNSS = 1 # GNSS
uint8 SOURCE_VISION = 2 # Vision
uint8 SOURCE_PSEUDOLITES = 3 # Pseudolites
uint8 SOURCE_TERRAIN = 4 # Terrain
uint8 SOURCE_MAGNETIC = 5 # Magnetic
uint8 SOURCE_ESTIMATOR = 6 # Estimator
uint8 SOURCE_LEO = 7 # Low Earth Orbit satellite-based positioning
# lat, lon: required for horizontal position fusion, alt: required for vertical position fusion
float64 lat # [deg] Latitude in WGS84
float64 lon # [deg] Longitude in WGS84
float32 alt # [m] [@invalid NaN] Altitude above mean sea level (AMSL)
float32 eph # [m] [@invalid NaN] Std dev of horizontal position, lower bounded by NOISE param
float32 epv # [m] [@invalid NaN] Std dev of vertical position, lower bounded by NOISE param
uint8 lat_lon_reset_counter # [-] Counter for reset events on horizontal position coordinates
# TOPICS aux_global_position
```
:::