QGeoPositionInfoSource Class

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

Documentation des fonctions membres

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

Crée une source de position avec l'adresse parent spécifiée.

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Détruit la source de position.

[static] QStringList QGeoPositionInfoSource::availableSources()

Renvoie une liste des plugins source disponibles. Cela inclut tous les plugins backend par défaut pour la plateforme actuelle.

[virtual, since Qt 5.14] QVariant QGeoPositionInfoSource::backendProperty(const QString &name) const

Renvoie la valeur de la propriété spécifique au backend nommée name, si elle est présente. Sinon, la valeur renvoyée sera invalide. Les propriétés spécifiques au backend prises en charge sont répertoriées et décrites dans Qt Positioning plugins#Default plugins.

Cette fonction a été introduite dans Qt 5.14.

Voir également setBackendProperty.

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

Crée et renvoie une source de position avec l'adresse parent qui lit les sources de données de localisation par défaut du système, ou le plugin avec la plus haute priorité disponible.

Retourne nullptr si le système n'a pas de source de position par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur n'a pas la permission d'accéder à la position actuelle.

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

Crée et renvoie une source de position avec l'adresse parent qui lit les sources de données de localisation par défaut du système, ou le plugin avec la plus haute priorité disponible.

Retourne nullptr si le système n'a pas de source de position par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur n'a pas la permission d'accéder à la position actuelle.

Cette méthode transmet parameters à la fabrique pour configurer la source.

Cette fonction a été introduite dans Qt 5.14.

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

Crée et renvoie une source de position avec l'adresse parent, en chargeant le plugin nommé sourceName.

Renvoie nullptr si le plugin est introuvable.

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

Crée et renvoie une source de position avec l'adresse parent, en chargeant le plugin nommé sourceName.

Elle renvoie nullptr si le plugin est introuvable.

Cette méthode transmet parameters à la fabrique pour configurer la source.

Cette fonction a été introduite dans Qt 5.14.

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

Renvoie le type d'erreur qui s'est produite en dernier.

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

Ce signal est émis lorsqu'une erreur s'est produite. Le paramètre positioningError décrit le type d'erreur qui s'est produite.

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

Renvoie une mise à jour contenant la dernière position connue, ou une mise à jour nulle si aucune n'est disponible.

Si fromSatellitePositioningMethodsOnly est vrai, la dernière position connue reçue d'une méthode de positionnement par satellite est renvoyée ; si aucune n'est disponible, une mise à jour nulle est renvoyée.

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

Si startUpdates() ou requestUpdate() est appelé, ce signal est émis lorsqu'une mise à jour est disponible.

La valeur update contient la valeur de la nouvelle mise à jour.

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

Tente d'obtenir la position actuelle et émet positionUpdated() avec cette information. Si la position actuelle ne peut être trouvée dans le délai donné timeout (en millisecondes) ou si timeout est inférieur à la valeur renvoyée par minimumUpdateInterval(), un signal errorOccurred() avec UpdateTimeoutError est émis.

Si le délai d'attente est égal à zéro, le délai d'attente est fixé par défaut à une durée raisonnable correspondant à la source.

Cela ne fait rien si une autre demande de mise à jour est en cours. Cependant, elle peut être appelée même si startUpdates() a déjà été appelé et que des mises à jour régulières sont en cours.

Si la source utilise plusieurs méthodes de positionnement, elle tente d'obtenir la position actuelle à partir de la méthode de positionnement la plus précise dans le délai imparti.

[virtual, since Qt 5.14] bool QGeoPositionInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Définit la propriété spécifique au backend nommée name à value. Renvoie true en cas de succès, false dans le cas contraire. Les propriétés spécifiques au backend peuvent être utilisées pour configurer le comportement du sous-système de positionnement au moment de l'exécution. Les propriétés spécifiques au backend prises en charge sont répertoriées et décrites dans Qt Positioning plugins#Default plugins.

Cette fonction a été introduite dans Qt 5.14.

Voir également backendProperty.

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

Commence à émettre des mises à jour à intervalles réguliers, comme spécifié par setUpdateInterval().

Si setUpdateInterval() n'a pas été appelé, la source émettra des mises à jour dès qu'elles seront disponibles.

Un signal errorOccurred() avec UpdateTimeoutError sera émis si cette sous-classe QGeoPositionInfoSource détermine qu'elle ne sera pas en mesure de fournir des mises à jour régulières. Cela peut se produire en cas de perte des coordonnées d'un satellite ou de détection d'une erreur matérielle. Les mises à jour de position reprendront si les données sont disponibles ultérieurement. L'erreur UpdateTimeoutError ne sera émise qu'après la reprise des mises à jour périodiques.

Sur iOS, à partir de la version 8, Core Location framework requiert des entrées supplémentaires dans l'Info.plist de l'application avec les clés NSLocationAlwaysUsageDescription ou NSLocationWhenInUseUsageDescription et une chaîne à afficher dans l'invite d'autorisation. La clé NSLocationWhenInUseUsageDescription est utilisée pour demander l'autorisation d'utiliser les services de localisation lorsque l'application est au premier plan. La clé NSLocationAlwaysUsageDescription est utilisée pour demander l'autorisation d'utiliser les services de localisation lorsque l'application est en cours d'exécution (au premier plan et en arrière-plan). Si les deux entrées sont définies, NSLocationWhenInUseUsageDescription est prioritaire en mode avant-plan.

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

Arrête d'émettre des mises à jour à intervalles réguliers.

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

Renvoie les méthodes de positionnement disponibles pour cette source. La disponibilité est définie comme étant utilisable au moment de l'appel de cette fonction. Par conséquent, les paramètres de l'utilisateur tels que la désactivation du service de localisation ou les limitations des fournisseurs de position par satellite sont reflétés par cette fonction. Les notifications d'exécution en cas de changement d'état peuvent être obtenues via supportedPositioningMethodsChanged().

Toutes les plateformes ne distinguent pas les différentes méthodes de positionnement ou ne communiquent pas la configuration utilisateur actuelle de l'appareil. Le tableau suivant donne un aperçu de la situation actuelle des plateformes :

Voir également supportedPositioningMethodsChanged() et setPreferredPositioningMethods().

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

Ce signal est émis lorsque les méthodes de positionnement prises en charge ont changé. La cause de ce changement peut être l'activation/désactivation des services de localisation par l'utilisateur ou la restriction des services de localisation à certains types (par exemple, GPS uniquement). Il convient de noter que les modifications des méthodes de positionnement prises en charge ne peuvent pas être détectées sur toutes les plates-formes. supportedPositioningMethods() fournit une vue d'ensemble de la prise en charge actuelle des plates-formes.

Cette fonction a été introduite dans Qt 5.12.