Información sobre satélites
El ejemplo «Información sobre satélites» muestra los satélites disponibles mediante las vistas «Sky View», «Table View» o «RSSI View», así como la posición actual del usuario. Está implementado con Qt Positioning y Qt Quick.
Este ejemplo muestra el uso de Qt Positioning QML API:
El ejemplo también muestra cómo utilizar un modelo personalizado de C++ junto con un modelo proxy personalizado de QML.
Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo Welcome y selecciona el ejemplo de Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Recorrido por la interfaz de usuario
El ejemplo muestra información sobre satélites en tres pestañas diferentes. Los datos proceden de las propiedades SatelliteSource::satellitesInView y SatelliteSource::satellitesInUse.

La pestaña «Sky View» muestra las posiciones relativas de los satélites utilizando las propiedades « Azimuth » y « Elevation » attributes. Al hacer clic en un objeto de satélite concreto, se abre una ventana emergente con la « satellite identifier », su acimut y su elevación.
La pestaña «Table View» muestra la lista de todos los satélites detectados y permite aplicar operaciones de ordenación y filtrado a la lista.

La pestaña «Vista RSSI» muestra la intensidad de la señal de los satélites visibles mediante la propiedad signalStrength. Los números que aparecen debajo de las barras representan el satellite identifiers de cada uno.
Las pestañas «Vista del cielo » y «Vista RSSI» también muestran la latitud y la longitud actuales. Utilizan la propiedad ` PositionSource::position ` para extraer esta información.
El bloque «Status», situado en la parte superior de las pestañas, muestra el modo actual o el último error.
El menú «Configuración» permite cambiar el modo de color de la aplicación y mostrar la información de ayuda.
La aplicación funciona en tres modos diferentes:
| Modo de aplicación | Descripción |
|---|---|
| En ejecución | La aplicación consulta continuamente al sistema para obtener actualizaciones de satélites y de posición. Cuando haya nuevos datos disponibles, se mostrarán. |
| Detenida | La aplicación deja de actualizar la información sobre los satélites y la posición. |
| Única | La aplicación realiza una única solicitud de actualización de datos de satélite y posición. |
La aplicación pasa automáticamente a un modo de simulación si la plataforma no proporciona información sobre satélites o posición. El modo de simulación utiliza un complemento NMEA con datos NMEA pregrabados.
Nota: Apple no proporciona ninguna API para recuperar información de satélites, por lo que en macOS y iOS la información de satélites siempre se obtendrá a partir de datos pregrabados. Estas limitaciones de la API no afectan a la información de posicionamiento, por lo que la posición actual se puede mostrar correctamente.
Obtención de la posición actual
La posición actual se obtiene del objeto QML PositionSource. El controlador onPositionChanged se utiliza para recibir actualizaciones de posición. Las representaciones en forma de cadena de la latitud y la longitud se extraen de la propiedad coordinate.
PositionSource {
id: positionSource
name: root.simulation ? "nmea" : ""
onPositionChanged: {
let posData = position.coordinate.toString().split(", ")
positionBox.latitudeString = posData[0]
positionBox.longitudeString = posData[1]
}
}Obtención de la información del satélite
Al igual que con la posición, la información actual sobre los satélites se obtiene del objeto QML ` SatelliteSource `. Los controladores ` onSatellitesInViewChanged ` y ` onSatellitesInUseChanged ` se utilizan para obtener, respectivamente, los satélites actualizados que están a la vista y los que están en uso. En este ejemplo, los datos se reenvían a continuación al modelo ` C++ `, que posteriormente se utiliza en todas las vistas.
SatelliteSource {
id: satelliteSource
name: root.simulation ? "nmea" : ""
onSatellitesInViewChanged: root.satellitesModel.updateSatellitesInView(satellitesInView)
onSatellitesInUseChanged: root.satellitesModel.updateSatellitesInUse(satellitesInUse)
}Nota: El ejemplo muestra tanto la API de posicionamiento de QML como la integración del modelo C++ en QML. Esa es la razón por la que la información de los satélites se recupera primero en QML, luego se reenvía a C++ y, a continuación, vuelve a QML para ser utilizada en el modelo. En la práctica, si se prevé que la aplicación utilice modelos C++ complejos, se recomienda utilizar directamente la clase QGeoSatelliteInfoSource de C++.
Uso de modelos personalizados en C++
El ejemplo utiliza dos modelos personalizados: SatelliteModel y SortFilterModel.
Modelo «Satellite»
La clase SatelliteModel deriva de QAbstractListModel y reimplementa los métodos rowCount(), data() y roleNames() para representar la información del satélite. El uso de QAbstractListModel como clase base permite utilizar fácilmente el modelo con los tipos QML, ListView y Repeater. Se utiliza una propiedad personalizada size únicamente en la pestaña «RSSI View» para calcular dinámicamente el ancho de las barras de la pestaña.
class SatelliteModel : public QAbstractListModel
{
Q_OBJECT
Q_PROPERTY(int size READ rowCount NOTIFY sizeChanged)
QML_ELEMENT
public:
explicit SatelliteModel(QObject *parent = nullptr);
int rowCount(const QModelIndex &parent = QModelIndex()) const override;
QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
QHash<int, QByteArray> roleNames() const override;
public slots:
void updateSatellitesInView(const QList<QGeoSatelliteInfo> &inView);
void updateSatellitesInUse(const QList<QGeoSatelliteInfo> &inUse);
signals:
void sizeChanged();
};El método roleNames() se utiliza para asignar los roles del modelo a los nombres de las propiedades que pueden utilizarse para acceder a los datos del modelo desde QML. Por ejemplo, el nombre id se utiliza para extraer el identificador del satélite, y el nombre rssi se utiliza para obtener la intensidad de la señal.
QHash<int, QByteArray> SatelliteModel::roleNames() const
{
return {
{Roles::IdRole, "id"},
{Roles::RssiRole, "rssi"},
{Roles::AzimuthRole, "azimuth"},
{Roles::ElevationRole, "elevation"},
{Roles::SystemRole, "system"},
{Roles::SystemIdRole, "systemId"},
{Roles::InUseRole, "inUse"},
{Roles::VisibleNameRole, "name"}
};
}En el lado de QML, podemos utilizar estos nombres para obtener los valores reales. Por ejemplo, la implementación de RSSI View utiliza los nombres de rol rssi, inUse y id para dibujar las barras que representan a cada satélite:
Repeater {
id: repeater
model: root.satellitesModel
delegate: Rectangle {
required property var modelData
height: rect.height
width: view.singleWidth
color: "transparent"
SemiRoundedRectangle {
anchors.bottom: satId.top
width: parent.width
height: (parent.height - satId.height)
* Math.min(parent.modelData.rssi, rect.maxVisibleLevel)
/ rect.maxVisibleLevel
color: parent.modelData.inUse ? root.inUseColor : root.inViewColor
}
Text {
id: satId
anchors.horizontalCenter: parent.horizontalCenter
anchors.bottom: parent.bottom
text: parent.modelData.id
color: Theme.textSecondaryColor
font.pixelSize: Theme.smallFontSize
font.weight: Theme.fontLightWeight
}
}
}Modelo proxy
La clase « SortFilterModel » se utiliza para proporcionar una clasificación y un filtrado personalizados de los objetos de satélite que se muestran en la pestaña «Table View ».
El modelo deriva de ` QSortFilterProxyModel ` y reimplementa los métodos ` filterAcceptsRow()` y ` lessThan()` para proporcionar filtrado y ordenación. El modelo también expone varios ` slots ` para ajustar el comportamiento del filtrado y la ordenación.
class SortFilterModel : public QSortFilterProxyModel
{
Q_OBJECT
QML_ELEMENT
public:
explicit SortFilterModel(QObject *parent = nullptr);
public slots:
void updateFilterString(const QString &str);
void updateShowInView(bool show);
void updateShowInUse(bool show);
void updateSelectedSystems(int id, bool show);
void updateSortRoles(int role, bool use);
protected:
bool filterAcceptsRow(int row, const QModelIndex &parent) const override;
bool lessThan(const QModelIndex &left, const QModelIndex &right) const override;
};Estas ranuras pueden invocarse tanto desde C++ como desde QML. Por ejemplo, el delegado «Satellite Identifier» utiliza la ranura updateSelectedSystems() para mostrar u ocultar la información sobre los satélites que pertenecen a determinados sistemas de satélites. Del mismo modo, los delegados «Satellite Status» utilizan las ranuras updateShowInView() y updateShowInUse() para filtrar los satélites con un estado específico.
Repeater {
model: root.satelliteSystemModel
delegate: CheckElement {
required property var modelData
text: modelData.name
Layout.alignment: Qt.AlignRight
onCheckedChanged: {
root.sortFilterModel.updateSelectedSystems(modelData.id, checked)
}
}
}
...
CheckElement {
text: qsTr("In View")
Layout.alignment: Qt.AlignRight
onCheckedChanged: root.sortFilterModel.updateShowInView(checked)
}
CheckElement {
text: qsTr("In Use")
Layout.alignment: Qt.AlignRight
onCheckedChanged: root.sortFilterModel.updateShowInUse(checked)
}Registro de módulos QML
Compilación con CMake
Para una compilación basada en CMake, debemos añadir lo siguiente al archivo « CMakeLists.txt »:
qt_add_qml_module(satelliteinfo
URI SatelliteInformation
VERSION 1.0
SOURCES
roles.h
satellitemodel.cpp satellitemodel.h
sortfiltermodel.cpp sortfiltermodel.h
QML_FILES
ApplicationScreen.qml
Button.qml
Header.qml
HelpPopup.qml
LegendBox.qml
Main.qml
RssiView.qml
PageButton.qml
PermissionsScreen.qml
PositionBox.qml
SatelliteView.qml
SettingsView.qml
SkyView.qml
Theme.qml
ViewSwitch.qml
RESOURCES
icons/checkbox.svg
icons/checkbox_blank.svg
icons/darkmode.svg
icons/filter.svg
icons/help.svg
icons/lightmode.svg
icons/place.svg
icons/qtlogo_green.png
icons/qtlogo_white.png
icons/rssiview.svg
icons/satellite_small.png
icons/satellite1.png
icons/satellite2.png
icons/search.svg
icons/settings.svg
icons/skyview.svg
icons/sort.svg
icons/tableview.svg
)Compilación con qmake
Para una compilación con qmake, debemos modificar el archivo satelliteinfo.pro de la siguiente manera:
CONFIG += qmltypes
QML_IMPORT_NAME = SatelliteInformation
QML_IMPORT_MAJOR_VERSION = 1
qml_resources.files = \
qmldir \
ApplicationScreen.qml \
Button.qml \
Header.qml \
HelpPopup.qml \
LegendBox.qml \
Main.qml \
RssiView.qml \
PageButton.qml \
PermissionsScreen.qml \
PositionBox.qml \
SatelliteView.qml \
SettingsView.qml \
SkyView.qml \
Theme.qml \
ViewSwitch.qml
qml_resources.prefix = /qt/qml/SatelliteInformation
RESOURCES += qml_resources
icon_resources.files = \
icons/checkbox.svg \
icons/checkbox_blank.svg \
icons/darkmode.svg \
icons/filter.svg \
icons/help.svg \
icons/lightmode.svg \
icons/place.svg \
icons/qtlogo_green.png \
icons/qtlogo_white.png \
icons/rssiview.svg \
icons/satellite_small.png \
icons/satellite1.png \
icons/satellite2.png \
icons/search.svg \
icons/settings.svg \
icons/skyview.svg \
icons/sort.svg \
icons/tableview.svg
icon_resources.prefix = /qt/qml/SatelliteInformation
RESOURCES += icon_resourcesArchivos fuente
Véase también Todos los ejemplos de Qt XML, Ejemplos deQt Positioning y Ejemplos y tutoriales deQt Quick .
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.