QGeoPositionInfoSource Class

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

Documentación de funciones miembro

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

Crea una fuente de posición con la dirección parent especificada.

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Destruye la fuente de posición.

[static] QStringList QGeoPositionInfoSource::availableSources()

Devuelve una lista de los plugins de origen disponibles. Esto incluye cualquier plugin backend por defecto para la plataforma actual.

[virtual, since Qt 5.14] QVariant QGeoPositionInfoSource::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. Las propiedades específicas de backend soportadas se listan y describen en Qt Positioning plugins#Default plugins.

Esta función se introdujo en Qt 5.14.

Véase también setBackendProperty.

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

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

Devuelve nullptr si el sistema no tiene ninguna fuente de posición por defecto, no se han podido encontrar plugins válidos o el usuario no tiene permiso para acceder a la posición actual.

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

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

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

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

Esta función se introdujo en Qt 5.14.

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

Crea y devuelve una fuente de posición con el nombre parent, cargando el plugin sourceName.

Devuelve nullptr si el plugin no puede ser encontrado.

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

Crea y devuelve una fuente de posición 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 se introdujo en Qt 5.14.

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

Devuelve el tipo de error que se produjo por última vez.

[signal] void QGeoPositionInfoSource::errorOccurred(QGeoPositionInfoSource::Error positioningError)

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

[pure virtual] QGeoPositionInfo QGeoPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const

Devuelve una actualización que contiene la última posición conocida, o una actualización nula si no hay ninguna disponible.

Si fromSatellitePositioningMethodsOnly es verdadero, devuelve la última posición conocida recibida de un método de posicionamiento por satélite; si no hay ninguno disponible, se devuelve una actualización nula.

[signal] void QGeoPositionInfoSource::positionUpdated(const QGeoPositionInfo &update)

Si se llama a startUpdates() o requestUpdate(), esta señal se emite cuando hay una actualización disponible.

El valor update contiene el valor de la nueva actualización.

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

Intenta obtener la posición actual y emite positionUpdated() con esta información. Si no se puede encontrar la posición actual dentro del tiempo dado timeout (en milisegundos) o si timeout es menor que el valor devuelto por minimumUpdateInterval(), se emite una señal errorOccurred() con el 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.

Si la fuente utiliza múltiples métodos de posicionamiento, intenta obtener la posición actual del método de posicionamiento más preciso dentro del tiempo de espera dado.

[virtual, since Qt 5.14] bool QGeoPositionInfoSource::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 de backend se pueden utilizar para configurar el comportamiento del subsistema de posicionamiento en tiempo de ejecución. Las propiedades específicas de backend soportadas se listan y describen en Qt Positioning plugins#Default plugins.

Esta función se introdujo en Qt 5.14.

Véase también backendProperty.

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

Comienza a emitir actualizaciones a intervalos regulares especificados por setUpdateInterval().

Si no se ha llamado a setUpdateInterval(), la fuente emitirá actualizaciones en cuanto estén disponibles.

Se emitirá una señal errorOccurred() con el UpdateTimeoutError si esta subclase QGeoPositionInfoSource determina que no podrá proporcionar actualizaciones regulares. Esto puede ocurrir si se pierde la posición de un satélite o si se detecta un error de hardware. Las actualizaciones de posición se reanudarán si los datos vuelven a estar disponibles más adelante. El error UpdateTimeoutError no volverá a emitirse hasta que se reanuden las actualizaciones periódicas.

En iOS, a partir de la versión 8, Core Location framework requiere entradas adicionales en el Info.plist de la aplicación con las claves NSLocationAlwaysUsageDescription o NSLocationWhenInUseUsageDescription y una cadena que se mostrará en el prompt de autorización. La clave NSLocationWhenInUseUsageDescription se utiliza cuando se solicita permiso para utilizar los servicios de localización mientras la aplicación está en primer plano. La clave NSLocationAlwaysUsageDescription se utiliza cuando se solicita permiso para utilizar los servicios de localización siempre que la aplicación esté en ejecución (tanto en primer plano como en segundo plano). Si se definen ambas entradas, NSLocationWhenInUseUsageDescription tiene prioridad en el modo en primer plano.

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

Deja de emitir actualizaciones a intervalos regulares.

[pure virtual] QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::supportedPositioningMethods() const

Devuelve los métodos de posicionamiento disponibles para esta fuente. La disponibilidad se define como utilizable en el momento de llamar a esta función. Por lo tanto, los ajustes del usuario, como el servicio de localización desactivado o las limitaciones a los proveedores de posición por satélite, se reflejan en esta función. Las notificaciones en tiempo de ejecución cuando cambia el estado pueden obtenerse a través de supportedPositioningMethodsChanged().

No todas las plataformas distinguen los diferentes métodos de posicionamiento o comunican la configuración de usuario actual del dispositivo. La siguiente tabla ofrece una visión general de la situación actual de las plataformas:

Véase también supportedPositioningMethodsChanged() y setPreferredPositioningMethods().

[signal, since Qt 5.12] void QGeoPositionInfoSource::supportedPositioningMethodsChanged()

Esta señal se emite cuando cambian los métodos de localización admitidos. La causa de un cambio puede ser que un usuario active o desactive los servicios de localización o restrinja los servicios de localización a determinados tipos (por ejemplo, sólo GPS). Tenga en cuenta que los cambios en los métodos de posicionamiento admitidos no pueden detectarse en todas las plataformas. supportedPositioningMethods() proporciona una visión general del soporte actual de la plataforma.

Esta función se introdujo en Qt 5.12.