QGeoPositionInfoSource Class

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

Dokumentation zu den Member-Funktionen

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

Erstellt eine Positionsquelle mit der angegebenen „ parent “.

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Löscht die Positionsquelle.

[static] QStringList QGeoPositionInfoSource::availableSources()

Gibt eine Liste der verfügbaren Quell-Plugins zurück. Dazu gehört auch jedes Standard-Backend-Plugin für die aktuelle Plattform.

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

Gibt den Wert der backend-spezifischen Eigenschaft „ name “ zurück, sofern vorhanden. Andernfalls ist der zurückgegebene Wert ungültig. Unterstützte backend-spezifische Eigenschaften sind unter Qt Positioning plugins#Default-Plugins aufgelistet und beschrieben.

Diese Funktion wurde in Qt 5.14 eingeführt.

Siehe auch setBackendProperty.

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

Erstellt und gibt eine Positionsquelle mit dem angegebenen „ parent “ zurück, die aus den Standardquellen des Systems für Standortdaten oder aus dem Plugin mit der höchsten verfügbaren Priorität liest.

Gibt „ nullptr “ zurück, wenn das System über keine Standard-Positionsquelle verfügt, keine gültigen Plugins gefunden werden konnten oder der Benutzer keine Berechtigung zum Zugriff auf die aktuelle Position hat.

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

Erstellt und gibt eine Positionsquelle mit dem angegebenen „ parent “ zurück, die aus den Standardquellen des Systems für Standortdaten oder aus dem Plugin mit der höchsten verfügbaren Priorität ausliest.

Gibt „ nullptr “ zurück, wenn das System keine Standard-Positionsquelle hat, keine gültigen Plugins gefunden werden konnten oder der Benutzer keine Berechtigung zum Zugriff auf die aktuelle Position hat.

Diese Methode übergibt ` parameters ` an die Factory, um die Quelle zu konfigurieren.

Diese Funktion wurde in Qt 5.14 eingeführt.

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

Erstellt eine Positionsquelle mit dem angegebenen „ parent “ und gibt diese zurück, indem das Plugin mit dem Namen „ sourceName “ geladen wird.

Gibt ` nullptr ` zurück, wenn das Plugin nicht gefunden werden kann.

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

Erstellt und gibt eine Positionsquelle mit dem angegebenen „ parent “ zurück, indem das Plugin mit dem Namen „ sourceName “ geladen wird.

Gibt „ nullptr “ zurück, wenn das Plugin nicht gefunden werden kann.

Diese Methode übergibt ` parameters ` an die Factory, um die Quelle zu konfigurieren.

Diese Funktion wurde in Qt 5.14 eingeführt.

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

Gibt den Typ des zuletzt aufgetretenen Fehlers zurück.

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

Dieses Signal wird ausgegeben, nachdem ein Fehler aufgetreten ist. Der Parameter „ positioningError “ beschreibt die Art des aufgetretenen Fehlers.

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

Gibt ein Update zurück, das die zuletzt bekannte Position enthält, oder ein Null-Update, falls keine Position verfügbar ist.

Ist „ fromSatellitePositioningMethodsOnly “ auf „true“ gesetzt, wird die zuletzt bekannte Position zurückgegeben, die von einem Satellitenortungsverfahren empfangen wurde; ist keine verfügbar, wird ein Null-Update zurückgegeben.

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

Wenn „ startUpdates()“ oder „ requestUpdate()“ aufgerufen wird, wird dieses Signal ausgegeben, sobald ein Update verfügbar ist.

Der Wert von ` update ` enthält den Wert des neuen Updates.

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

Versucht, die aktuelle Position zu ermitteln, und sendet mit diesen Informationen ein „ positionUpdated()“-Signal aus. Wenn die aktuelle Position nicht innerhalb der angegebenen „ timeout “ (in Millisekunden) gefunden werden kann oder wenn „ timeout “ kleiner ist als der von „ minimumUpdateInterval()“ zurückgegebene Wert, wird ein „ errorOccurred()“-Signal mit dem „ UpdateTimeoutError “ ausgesendet.

Ist die Zeitüberschreitung gleich Null, wird standardmäßig eine für die Quelle angemessene Zeitüberschreitungsdauer verwendet.

Dies hat keine Auswirkungen, wenn gerade eine andere Aktualisierungsanforderung läuft. Die Funktion kann jedoch auch dann aufgerufen werden, wenn „ startUpdates()“ bereits aufgerufen wurde und reguläre Aktualisierungen laufen.

Wenn die Quelle mehrere Positionsbestimmungsmethoden verwendet, versucht sie, die aktuelle Position innerhalb des angegebenen Timeouts von der genauesten Positionsbestimmungsmethode zu ermitteln.

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

Setzt die backend-spezifische Eigenschaft „ name “ auf „ value “. Gibt bei Erfolg „ true “ zurück, andernfalls „ false “. Backend-spezifische Eigenschaften können verwendet werden, um das Verhalten des Positionierungssubsystems zur Laufzeit zu konfigurieren. Unterstützte backend-spezifische Eigenschaften sind unter Qt Positioning plugins#Default-Plugins aufgelistet und beschrieben.

Diese Funktion wurde in Qt 5.14 eingeführt.

Siehe auch backendProperty.

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

Gibt in regelmäßigen Abständen Aktualisierungen aus, wie durch die Funktion „ setUpdateInterval()“ festgelegt.

Wurde ` setUpdateInterval()` nicht aufgerufen, sendet die Quelle Aktualisierungen, sobald diese verfügbar sind.

Ein Signal „ errorOccurred()“ mit dem Wert „ UpdateTimeoutError “ wird ausgelöst, wenn diese Unterklasse von „ QGeoPositionInfoSource “ feststellt, dass sie keine regelmäßigen Aktualisierungen bereitstellen kann. Dies kann passieren, wenn die Satellitenverbindung unterbrochen wird oder ein Hardwarefehler erkannt wird. Die Positionsaktualisierungen werden wieder aufgenommen, sobald die Daten später wieder verfügbar sind. Der Fehler „ UpdateTimeoutError “ wird erst wieder ausgelöst, nachdem die periodischen Aktualisierungen wieder aufgenommen wurden.

Unter iOS erfordert das Core Location-Framework ab Version 8 zusätzliche Einträge in der Datei „Info.plist“ der Anwendung mit den Schlüsseln „NSLocationAlwaysUsageDescription“ oder „NSLocationWhenInUseUsageDescription“ sowie einer Zeichenfolge, die in der Autorisierungsabfrage angezeigt werden soll. Der Schlüssel „NSLocationWhenInUseUsageDescription“ wird verwendet, wenn die Berechtigung zur Nutzung von Standortdiensten angefordert wird, während sich die App im Vordergrund befindet. Der Schlüssel „NSLocationAlwaysUsageDescription“ wird verwendet, wenn die Berechtigung zur Nutzung von Standortdiensten angefordert wird, sobald die App ausgeführt wird (sowohl im Vordergrund als auch im Hintergrund). Sind beide Einträge definiert, hat „NSLocationWhenInUseUsageDescription“ im Vordergrundmodus Vorrang.

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

Beendet die Ausgabe von Aktualisierungen in regelmäßigen Abständen.

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

Gibt die für diese Quelle verfügbaren Ortungsmethoden zurück. Die Verfügbarkeit ist definiert als die Nutzbarkeit zum Zeitpunkt des Aufrufs dieser Funktion. Daher werden Benutzereinstellungen wie deaktivierte Ortungsdienste oder Einschränkungen für satellitengestützte Ortungsanbieter von dieser Funktion berücksichtigt. Laufzeitbenachrichtigungen bei Statusänderungen können über ` supportedPositioningMethodsChanged()` abgerufen werden.

Nicht alle Plattformen unterscheiden zwischen den verschiedenen Ortungsmethoden oder geben die aktuelle Benutzerkonfiguration des Geräts weiter. Die folgende Tabelle bietet einen Überblick über die aktuelle Situation auf den verschiedenen Plattformen:

Siehe auch supportedPositioningMethodsChanged() und setPreferredPositioningMethods().

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

Dieses Signal wird ausgegeben, wenn sich die unterstützten Ortungsmethoden geändert haben. Der Grund für eine Änderung könnte sein, dass ein Benutzer die Ortungsdienste ein- oder ausgeschaltet oder auf bestimmte Arten beschränkt hat (z. B. nur GPS). Beachten Sie, dass Änderungen an den unterstützten Ortungsmethoden nicht auf allen Plattformen erkannt werden können. Die Funktion ` supportedPositioningMethods()` bietet einen Überblick über die aktuelle Plattformunterstützung.

Diese Funktion wurde in Qt 5.12 eingeführt.