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'parent spécifiée.

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Supprime la source de position.

[static] QStringList QGeoPositionInfoSource::availableSources()

Renvoie une liste des plugins source disponibles. Celle-ci inclut tout plugin 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 existe. Sinon, la valeur renvoyée sera invalide. Les propriétés spécifiques aux backends prises en charge sont répertoriées et décrites à l'adresse 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'parent on spécifiée, qui utilise les sources de données de localisation par défaut du système ou le plugin ayant la priorité la plus élevée parmi ceux disponibles.

Renvoie « nullptr » si le système ne dispose d'aucune source de position par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur ne dispose pas des autorisations nécessaires pour 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'parent spécifiée, qui utilise les sources de données de localisation par défaut du système ou le plugin ayant la priorité la plus élevée disponible.

Renvoie ` nullptr ` si le système ne dispose d’aucune source de position par défaut, si aucun plugin valide n’a pu être trouvé ou si l’utilisateur ne dispose pas des autorisations nécessaires pour accéder à la position actuelle.

Cette méthode transmet l'parameters à l'usine 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'parent spécifiée, 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'parent spécifiée, en chargeant le plugin nommé sourceName.

Renvoie ` nullptr ` si le plugin est introuvable.

Cette méthode transmet parameters à l'usine pour configurer la source.

Cette fonction a été introduite dans Qt 5.14.

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

Renvoie le type de l'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 » indique 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 la variable « fromSatellitePositioningMethodsOnly » est à « true », cette fonction renvoie la dernière position connue reçue via une méthode de positionnement par satellite ; si aucune n'est disponible, une mise à jour nulle est renvoyée.

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

Si la fonction ` startUpdates()` ou ` requestUpdate()` est appelée, ce signal est émis lorsqu’une mise à jour est disponible.

La variable ` 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 d'émettre un signal « positionUpdated() » avec cette information. Si la position actuelle ne peut être trouvée dans le délai spécifié par « timeout » (en millisecondes) ou si « timeout » est inférieur à la valeur renvoyée par « minimumUpdateInterval() », un signal « errorOccurred() » est émis avec la valeur « UpdateTimeoutError ».

Si le délai d’expiration est nul, il est défini par défaut sur une durée raisonnable, adaptée à la source.

Cette fonction n’a aucun effet si une autre requête de mise à jour est en cours. Elle peut toutefois être appelée même si startUpdates() a déjà été appelée 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 » sur la valeur « 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 lors de l'exécution. Les propriétés spécifiques au backend prises en charge sont répertoriées et décrites à l'adresse 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 la fonction setUpdateInterval().

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

Un signal errorOccurred() portant l’ UpdateTimeoutError sera émis si cette sous-classe de 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 de la position par satellite ou si une erreur matérielle est détectée. Les mises à jour de position reprendront dès que les données seront à nouveau disponibles. L’erreur UpdateTimeoutError ne sera pas réémise avant la reprise des mises à jour périodiques.

Sur iOS, à partir de la version 8, le framework Core Location nécessite des entrées supplémentaires dans le fichier Info.plist de l’application, avec les clés NSLocationAlwaysUsageDescription ou NSLocationWhenInUseUsageDescription et une chaîne de caractères à afficher dans la fenêtre 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 dès que l’application est en cours d’exécution (aussi bien au premier plan qu’en arrière-plan). Si les deux entrées sont définies, NSLocationWhenInUseUsageDescription a la priorité en mode premier plan.

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

Cesse d'émettre des mises à jour à intervalles réguliers.

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

Renvoie les méthodes de localisation disponibles pour cette source. La disponibilité est définie comme étant l'état « utilisable » au moment de l'appel de cette fonction. Par conséquent, les paramètres utilisateur, tels que la désactivation du service de localisation ou les restrictions imposées aux fournisseurs de localisation par satellite, sont pris en compte par cette fonction. Des notifications d'exécution signalant les changements d'état peuvent être obtenues via la fonction ` supportedPositioningMethodsChanged()`.

Toutes les plateformes ne distinguent pas les différentes méthodes de localisation ni ne communiquent la configuration actuelle de l’appareil par l’utilisateur. 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 localisation prises en charge changent. Ce changement peut être dû au fait qu'un utilisateur a activé ou désactivé les services de localisation, ou qu'il a limité ces derniers à certains types (par exemple, GPS uniquement). Notez que les modifications apportées aux méthodes de localisation prises en charge ne peuvent pas être détectées sur toutes les plateformes. La fonction ` supportedPositioningMethods()` fournit un aperçu de la prise en charge actuelle par les différentes plateformes.

Cette fonction a été introduite dans Qt 5.12.