En esta página

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:

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.

Vista de satélite e interfaz de usuario de tabla

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.

Vista RSSI con barras de señal de satélite

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ónDescripción
En ejecuciónLa aplicación consulta continuamente al sistema para obtener actualizaciones de satélites y de posición. Cuando haya nuevos datos disponibles, se mostrarán.
DetenidaLa aplicación deja de actualizar la información sobre los satélites y la posición.
ÚnicaLa 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_resources

Archivos fuente

Proyecto de ejemplo en code.qt.io

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.