QGeoPositionInfoSource Class

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

Dokumentation der Mitgliedsfunktionen

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

Erzeugt eine Positionsquelle mit der angegebenen parent.

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

Zerstört die Positionsquelle.

[static] QStringList QGeoPositionInfoSource::availableSources()

Gibt eine Liste der verfügbaren Quell-Plugins zurück. Dazu gehören alle Standard-Backend-Plugins für die aktuelle Plattform.

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

Gibt den Wert der Backend-spezifischen Eigenschaft namens name zurück, falls vorhanden. Andernfalls ist der zurückgegebene Wert ungültig. Unterstützte Backend-spezifische Eigenschaften sind aufgelistet und beschrieben in Qt Positioning plugins#Default plugins.

Diese Funktion wurde in Qt 5.14 eingeführt.

Siehe auch setBackendProperty.

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

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

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

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

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

Gibt nullptr zurück, wenn das System keine Standardpositionsquelle hat, keine gültigen Plugins gefunden werden konnten oder der Benutzer nicht die Berechtigung hat, auf die aktuelle Position zuzugreifen.

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)

Erzeugt und liefert eine Positionsquelle mit der angegebenen parent, indem das Plugin mit dem Namen sourceName geladen wird.

Gibt nullptr zurück, wenn das Plugin nicht gefunden wird.

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

Erzeugt und liefert eine Positionsquelle mit der angegebenen parent, 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, wenn ein Fehler aufgetreten ist. Der Parameter positioningError beschreibt die Art des aufgetretenen Fehlers.

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

Liefert ein Update mit der letzten bekannten Position oder ein Null-Update, wenn keine verfügbar ist.

Wenn fromSatellitePositioningMethodsOnly true ist, wird die letzte bekannte Position zurückgegeben, die von einer Satellitenpositionierungsmethode empfangen wurde; wenn keine verfügbar ist, wird ein Null-Update zurückgegeben.

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

Wenn startUpdates() oder requestUpdate() aufgerufen wird, wird dieses Signal ausgegeben, wenn eine Aktualisierung verfügbar wird.

Der Wert update enthält den Wert der neuen Aktualisierung.

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

Versucht, die aktuelle Position zu ermitteln und sendet positionUpdated() mit dieser Information. 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 UpdateTimeoutError gesendet.

Ist die Zeitüberschreitung gleich Null, wird die Zeitüberschreitung auf eine für die Quelle angemessene Zeitspanne zurückgesetzt.

Dies hat keine Auswirkungen, wenn eine andere Aktualisierungsanforderung im Gange ist. Es kann jedoch auch dann aufgerufen werden, wenn startUpdates() bereits aufgerufen wurde und regelmäßige Aktualisierungen im Gange sind.

Wenn die Quelle mehrere Positionierungsmethoden verwendet, wird versucht, die aktuelle Position von der genauesten Positionierungsmethode innerhalb des angegebenen Timeouts zu erhalten.

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

Setzt die Backend-spezifische Eigenschaft namens 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 aufgelistet und beschrieben in Qt Positioning plugins#Default plugins.

Diese Funktion wurde in Qt 5.14 eingeführt.

Siehe auch backendProperty.

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

Startet die Ausgabe von Aktualisierungen in regelmäßigen Abständen, wie von setUpdateInterval() angegeben.

Wenn setUpdateInterval() nicht aufgerufen wurde, gibt die Quelle Aktualisierungen aus, sobald sie verfügbar sind.

Ein errorOccurred()-Signal mit dem UpdateTimeoutError wird ausgegeben, wenn diese QGeoPositionInfoSource -Unterklasse feststellt, dass sie nicht in der Lage ist, regelmäßige Aktualisierungen zu liefern. Dies könnte der Fall sein, wenn ein Satellitenfix verloren geht oder ein Hardwarefehler festgestellt wird. Die Positionsaktualisierung wird wieder aufgenommen, wenn die Daten zu einem späteren Zeitpunkt verfügbar sind. Der Fehler UpdateTimeoutError wird erst wieder ausgegeben, wenn die regelmäßigen Aktualisierungen wieder aufgenommen werden.

Unter iOS erfordert das Core Location Framework ab Version 8 zusätzliche Einträge in der Info.plist der Anwendung mit den Schlüsseln NSLocationAlwaysUsageDescription oder NSLocationWhenInUseUsageDescription und einem String, der in der Autorisierungsaufforderung angezeigt werden soll. Der Schlüssel NSLocationWhenInUseUsageDescription wird verwendet, wenn die Berechtigung zur Verwendung von Standortdiensten angefordert wird, während sich die Anwendung im Vordergrund befindet. Der Schlüssel NSLocationAlwaysUsageDescription wird verwendet, wenn die Erlaubnis zur Nutzung von Ortungsdiensten angefordert wird, wann immer die App läuft (sowohl im Vordergrund als auch im Hintergrund). Wenn beide Einträge definiert sind, hat NSLocationWhenInUseUsageDescription im Vordergrundmodus Vorrang.

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

Beendet die regelmäßige Ausgabe von Updates.

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

Gibt die für diese Quelle verfügbaren Positionierungsmethoden zurück. Die Verfügbarkeit ist definiert als nutzbar zum Zeitpunkt des Aufrufs dieser Funktion. Daher werden Benutzereinstellungen, wie z. B. die Deaktivierung des Ortungsdienstes oder Beschränkungen auf satellitengestützte Positionsanbieter, von dieser Funktion berücksichtigt. Laufzeitbenachrichtigungen, wenn sich der Status ändert, können über supportedPositioningMethodsChanged() abgerufen werden.

Nicht alle Plattformen unterscheiden die verschiedenen Ortungsmethoden oder teilen die aktuelle Benutzerkonfiguration des Geräts mit. Die folgende Tabelle gibt einen Überblick über die aktuelle Plattformsituation:

Siehe auch supportedPositioningMethodsChanged() und setPreferredPositioningMethods().

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

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

Diese Funktion wurde in Qt 5.12 eingeführt.