QGeoSatelliteInfoSource Class

// Emit updates every 10 seconds if available
QGeoSatelliteInfoSource *source = QGeoSatelliteInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

Documentación de funciones miembro

[explicit] QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)

Crea una fuente satélite con la dirección parent especificada.

[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

Destruye la fuente del satélite.

[static] QStringList QGeoSatelliteInfoSource::availableSources()

Devuelve una lista de los plugins fuente disponibles, incluyendo el backend por defecto del sistema si hay alguno disponible.

[virtual, since 6.2] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

Devuelve el valor de la propiedad específica del backend llamada name, si está presente. En caso contrario, el valor devuelto no será válido.

Esta función se introdujo en Qt 6.2.

Véase también setBackendProperty.

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(QObject *parent)

Crea y devuelve una fuente con el parent especificado que lee de la fuente por defecto del sistema de información de actualización de satélites, o del plugin disponible de mayor prioridad.

Devuelve nullptr si el sistema no tiene una fuente de satélites por defecto, no se han podido encontrar plugins válidos o el usuario no tiene permiso para acceder a los datos de satélite.

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

Crea y devuelve una fuente de satélites con el parent dado que lee de las fuentes de datos de satélites por defecto del sistema, o del plugin con la mayor prioridad disponible.

Devuelve nullptr si el sistema no tiene una fuente de satélites por defecto, no se han podido encontrar plugins válidos o el usuario no tiene permiso para acceder a la información de satélites.

Este método pasa parameters a la fábrica para configurar la fuente.

Esta función se introdujo en Qt 5.14.

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, QObject *parent)

Crea y devuelve una fuente con el nombre parent, cargando el complemento sourceName.

Devuelve nullptr si el plugin no puede ser encontrado.

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

Crea y devuelve una fuente satélite con el nombre parent, cargando el plugin sourceName.

Devuelve nullptr si el plugin no puede ser encontrado.

Este método pasa parameters a la fábrica para configurar la fuente.

Esta función fue introducida en Qt 5.14.

[pure virtual] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const

Devuelve el último error ocurrido.

[signal] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)

Esta señal se emite tras producirse un error. El parámetro satelliteError describe el tipo de error que se ha producido.

[pure virtual slot] void QGeoSatelliteInfoSource::requestUpdate(int timeout = 0)

Intenta obtener la información actual del satélite y emite satellitesInViewUpdated() y satellitesInUseUpdated() con esta información. Si no se puede encontrar la información actual del satélite en el plazo dado timeout (en milisegundos) o si timeout es menor que el valor devuelto por minimumUpdateInterval(), se emite una señal errorOccurred() con UpdateTimeoutError.

Si el tiempo de espera es cero, el tiempo de espera se establece por defecto en un periodo de tiempo razonable apropiado para la fuente.

Esto no hace nada si hay otra solicitud de actualización en curso. Sin embargo, puede llamarse incluso si ya se ha llamado a startUpdates() y hay actualizaciones regulares en curso.

[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)

Si se llama a startUpdates() o requestUpdate(), esta señal se emite cuando hay una actualización disponible sobre el número de satélites que están actualmente en uso.

Estos son los satélites que se utilizan para obtener un "fix" - es decir, los que se utilizan para determinar la posición actual.

El parámetro satellites contiene los satélites actualmente en uso.

[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)

Si se llama a startUpdates() o requestUpdate(), esta señal se emite cuando hay una actualización disponible sobre los satélites que están actualmente a la vista.

El parámetro satellites contiene los satélites actualmente a la vista.

[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Establece la propiedad específica del backend name en value. Devuelve true en caso de éxito, false en caso contrario. Las propiedades específicas del backend pueden usarse para configurar el comportamiento del subsistema de información del satélite en tiempo de ejecución.

Esta función se introdujo en Qt 6.2.

Véase también backendProperty.

QString QGeoSatelliteInfoSource::sourceName() const

Devuelve el nombre único de la implementación de fuente de satélite en uso.

Este es el mismo nombre que se puede pasar a createSource() para crear una nueva instancia de una implementación de fuente de satélite concreta.

[pure virtual slot] void QGeoSatelliteInfoSource::startUpdates()

Empieza a emitir actualizaciones a intervalos regulares. Las actualizaciones se proporcionarán siempre que se disponga de nueva información de satélite.

Si la información de satélite no puede ser recuperada o se ha producido algún otro tipo de timeout las señales satellitesInViewUpdated() y satellitesInUseUpdated() pueden ser emitidas con listas de parámetros vacías.

Véase también satellitesInViewUpdated() y satellitesInUseUpdated().

[pure virtual slot] void QGeoSatelliteInfoSource::stopUpdates()

Deja de emitir actualizaciones a intervalos regulares.