QGeoSatelliteInfoSource Class
La clase `QGeoSatelliteInfoSource` es una clase base abstracta destinada a la distribución de actualizaciones de información satelital. Más información...
| Encabezado: | #include <QGeoSatelliteInfoSource> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Heredado de: | QObject |
| Heredado por: |
Tipos públicos
| enum | Error { AccessError, ClosedError, NoError, UnknownSourceError, UpdateTimeoutError } |
Propiedades
- minimumUpdateInterval : int
- updateInterval : int
Funciones públicas
| QGeoSatelliteInfoSource(QObject *parent) | |
| virtual | ~QGeoSatelliteInfoSource() |
(since 6.2) virtual QVariant | backendProperty(const QString &name) const |
| QBindable<int> | bindableUpdateInterval() |
| virtual QGeoSatelliteInfoSource::Error | error() const = 0 |
| virtual int | minimumUpdateInterval() const = 0 |
(since 6.2) virtual bool | setBackendProperty(const QString &name, const QVariant &value) |
| virtual void | setUpdateInterval(int msec) |
| QString | sourceName() const |
| int | updateInterval() const |
Ranuras públicas
| virtual void | requestUpdate(int timeout = 0) = 0 |
| virtual void | startUpdates() = 0 |
| virtual void | stopUpdates() = 0 |
Señales
| void | errorOccurred(QGeoSatelliteInfoSource::Error satelliteError) |
| void | satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites) |
| void | satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites) |
Miembros públicos estáticos
| QStringList | availableSources() |
| QGeoSatelliteInfoSource * | createDefaultSource(QObject *parent) |
(since Qt 5.14) QGeoSatelliteInfoSource * | createDefaultSource(const QVariantMap ¶meters, QObject *parent) |
| QGeoSatelliteInfoSource * | createSource(const QString &sourceName, QObject *parent) |
(since Qt 5.14) QGeoSatelliteInfoSource * | createSource(const QString &sourceName, const QVariantMap ¶meters, QObject *parent) |
Descripción detallada
La función estática ` QGeoSatelliteInfoSource::createDefaultSource()` crea una fuente de datos de satélite predeterminada adecuada para la plataforma, si hay alguna disponible. De lo contrario, se comprobarán los complementos disponibles de ` QGeoPositionInfoSourceFactory ` para encontrar uno que cuente con una fuente de datos de satélite disponible.
Llama a ` startUpdates()` y a ` stopUpdates()` para iniciar y detener las actualizaciones periódicas, o a ` requestUpdate()` para solicitar una única actualización. Cuando haya una actualización disponible, se emitirán ` satellitesInViewUpdated()` y/o ` satellitesInUseUpdated()`.
Si se requieren actualizaciones periódicas por satélite, se puede utilizar ` setUpdateInterval()` para especificar la frecuencia con la que deben emitirse estas actualizaciones. Si no se especifica ningún intervalo, las actualizaciones se proporcionan simplemente siempre que estén disponibles. Por ejemplo:
// Emit updates every 10 seconds if available
QGeoSatelliteInfoSource *source = QGeoSatelliteInfoSource::createDefaultSource(0);
if (source)
source->setUpdateInterval(10000);Para eliminar un intervalo de actualización establecido previamente, llama a setUpdateInterval() con un valor de 0.
Nota: Es posible quela fuente satélite tenga un requisito de valor mínimo para los intervalos de actualización, tal y como devuelve minimumUpdateInterval().
Nota: Para utilizar esta clase desde un servicio de Android, consulta Qt Positioning en Android.
Documentación sobre los tipos de miembros
enum QGeoSatelliteInfoSource::Error
La enumeración «Error» representa los errores que pueden producirse.
| Constante | Valor | Descripción |
|---|---|---|
QGeoSatelliteInfoSource::AccessError | 0 | El establecimiento de la conexión con el backend del satélite ha fallado porque la aplicación carecía de los privilegios necesarios. |
QGeoSatelliteInfoSource::ClosedError | 1 | El backend satélite ha cerrado la conexión, lo que ocurre, por ejemplo, cuando el usuario desactiva los servicios de localización. Este objeto deja de ser válido y debe eliminarse. Posteriormente, se puede crear una nueva fuente satélite llamando a createDefaultSource(). |
QGeoSatelliteInfoSource::NoError | 2 | No se ha producido ningún error. |
QGeoSatelliteInfoSource::UnknownSourceError | -1 | Se ha producido un error no identificado. |
QGeoSatelliteInfoSource::UpdateTimeoutError | 3 | No se ha podido recuperar la información actual del satélite dentro del tiempo de espera especificado. |
Documentación de propiedades
[read-only] minimumUpdateInterval : int
Esta propiedad indica el tiempo mínimo (en milisegundos) necesario para recuperar una actualización del satélite.
Este es el valor mínimo aceptado por las funciones setUpdateInterval() y requestUpdate().
Funciones de acceso:
| virtual int | minimumUpdateInterval() const = 0 |
[bindable] updateInterval : int
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el intervalo solicitado, en milisegundos, entre cada actualización.
Si no se establece el intervalo de actualización (o se establece en 0), la fuente proporcionará actualizaciones con la frecuencia que sea necesaria.
Si se establece el intervalo de actualización, la fuente proporcionará actualizaciones a un intervalo lo más cercano posible al solicitado. Si el intervalo solicitado es inferior a minimumUpdateInterval(), se utilizará en su lugar el intervalo mínimo.
Los cambios en el intervalo de actualización se producirán tan pronto como sea posible; sin embargo, el tiempo que tarda el cambio puede variar según la implementación. El hecho de que el tiempo transcurrido desde el intervalo anterior se cuente o no como parte del nuevo intervalo también depende de la implementación.
El valor por defecto de esta propiedad es 0.
Nota: Las implementacionesde subclases deben llamar a la implementación base de `setUpdateInterval()` para que `updateInterval()` devuelva el valor correcto.
Funciones de acceso:
| int | updateInterval() const |
| virtual void | setUpdateInterval(int msec) |
Documentación de funciones miembro
[explicit] QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)
Crea una fuente de satélite con el « parent » especificado.
[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()
Destruye la fuente del satélite.
[static] QStringList QGeoSatelliteInfoSource::availableSources()
Devuelve una lista de los complementos de origen disponibles, incluido el backend predeterminado 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 denominada « name », si existe. De lo 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 desde la fuente predeterminada del sistema de información de actualizaciones de satélites o desde el complemento disponible con mayor prioridad.
Devuelve « nullptr » si el sistema no tiene ninguna fuente de satélite predeterminada, no se han encontrado complementos 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 ¶meters, QObject *parent)
Crea y devuelve una fuente de satélite con el « parent » especificado, que lee de las fuentes predeterminadas de datos de satélite del sistema o del complemento con la prioridad más alta disponible.
Devuelve ` nullptr ` si el sistema no tiene ninguna fuente de datos satelitales predeterminada, no se han encontrado complementos válidos o el usuario no tiene permiso para acceder a la información satelital.
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 parent especificado, cargando el complemento denominado sourceName.
Devuelve ` nullptr ` si no se encuentra el complemento.
[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap ¶meters, QObject *parent)
Crea y devuelve una fuente de satélite con el parent indicado, cargando el complemento denominado sourceName.
Devuelve ` nullptr ` si no se encuentra el complemento.
Este método pasa parameters a la fábrica para configurar la fuente.
Esta función se introdujo en Qt 5.14.
[pure virtual] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const
Devuelve el último error que se ha producido.
Nota: A partir de Qt6, el último error siempre se restablece al llamar a ` startUpdates()` o ` requestUpdate()`.
[signal] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)
Esta señal se emite cuando se produce 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 las señales « satellitesInViewUpdated()» y « satellitesInUseUpdated()» con dicha información. Si no se encuentra la información actual del satélite en el tiempo especificado « 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, se establece por defecto un tiempo de espera razonable adecuado para la fuente.
Esto no tiene ningún efecto si hay otra solicitud de actualización en curso. Sin embargo, se puede invocar incluso si ya se ha llamado a startUpdates() y hay actualizaciones regulares en curso.
Nota: A partir de Qt6, este método siempre restablece el último error a « NoError » antes de solicitar la información del satélite.
Nota: Para comprender cómo utilizar este método desde un servicio de Android, consulta «Qt Positioning » en Android.
[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)
Si se llama a startUpdates() o a requestUpdate(), esta señal se emite cuando hay una actualización disponible sobre el número de satélites que se están utilizando en ese momento.
Estos son los satélites que se utilizan para obtener una «posición», es decir, aquellos que sirven para determinar la posición actual.
El parámetro satellites contiene los satélites que se están utilizando en ese momento.
[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)
Si se invoca startUpdates() o requestUpdate(), esta señal se emite cuando hay una actualización disponible sobre los satélites que se encuentran actualmente a la vista.
El parámetro ` satellites ` contiene los satélites que se ven actualmente.
[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)
Establece la propiedad específica del backend denominada « name » en « value ». Devuelve « true » si se realiza correctamente y « false » en caso contrario. Las propiedades específicas del backend pueden utilizarse para configurar el comportamiento del subsistema de información sobre satélites 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 la fuente de satélite que se está utilizando.
Se trata del mismo nombre que se puede pasar a ` createSource()` para crear una nueva instancia de una implementación concreta de fuente satélite.
[pure virtual slot] void QGeoSatelliteInfoSource::startUpdates()
Comienza a enviar actualizaciones a intervalos regulares. Las actualizaciones se proporcionarán cada vez que haya nueva información satelital disponible.
Si no se puede recuperar la información del satélite o se ha producido algún otro tipo de tiempo de espera, pueden emitirse las señales satellitesInViewUpdated() y satellitesInUseUpdated() con listas de parámetros vacías.
Nota: A partir de Qt6, este método siempre restablece el último error a NoError antes de iniciar las actualizaciones.
Nota: Para saber cómo utilizar este método desde un servicio de Android, consulta «Qt Positioning » en Android.
Véanse también « satellitesInViewUpdated()» y « satellitesInUseUpdated()».
[pure virtual slot] void QGeoSatelliteInfoSource::stopUpdates()
Deja de enviar actualizaciones a intervalos regulares.
© 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.