QGeoPositionInfoSource Class

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

メンバー関数ドキュメント

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

指定されたparent を持つ位置ソースを作成する。

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

ポジション・ソースを破棄します。

[static] QStringList QGeoPositionInfoSource::availableSources()

利用可能なソース・プラグインのリストを返します。これには、現在のプラットフォームのデフォルトのバックエンド・プラグインが含まれます。

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

name というバックエンド固有のプロパティが存在する場合は、その値を返します。それ以外の場合、返される値は無効です。サポートされているバックエンド固有のプロパティの一覧と説明は、Qt Positioning plugins#Default plugins にあります。

この関数は Qt 5.14 で導入されました。

setBackendPropertyも参照してください 。

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

システムのデフォルトの位置データソース、または利用可能な優先順位が最も高いプラグインから読み込む、与えられたparent を持つ位置ソースを作成し、返します。

システムにデフォルトの位置ソースがない場合、有効なプラグインが見つからない場合、またはユーザーが現在の位置にアクセスする権限を持っていない場合は、nullptr を返します。

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

システムのデフォルトの位置データソース、または利用可能な優先順位が最も高いプラグインから読み込む、指定されたparent の位置ソースを作成して返します。

システムにデフォルトの位置ソースがない場合、有効なプラグインが見つからない場合、またはユーザーが現在の位置にアクセスする権限を持っていない場合は、nullptr を返します。

このメソッドは、parameters をファクトリーに渡し、ソースを構成します。

この関数は Qt 5.14 で導入されました。

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

sourceName という名前のプラグインをロードすることによって、指定されたparent を持つ位置ソースを作成し、返します。

プラグインが見つからない場合はnullptr を返します。

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

sourceName という名前のプラグインをロードすることによって、与えられたparent を持つ位置ソースを作成し、返します。

プラグインが見つからない場合はnullptr を返します。

このメソッドは、parameters をファクトリーに渡し、ソースを構成します。

この関数は Qt 5.14 で導入されました。

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

最後に発生したエラーのタイプを返します。

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

このシグナルは、エラーが発生した後に発せられます。positioningError パラメータには、発生したエラーのタイプが記述されます。

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

最後の既知の位置を含む更新情報を返します。

fromSatellitePositioningMethodsOnly が true の場合、衛星測位メソッドから受信した最後の既知の位置を返す。

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

startUpdates （）またはrequestUpdate （）が呼び出されると、更新が利用可能になったときにこのシグナルが発せられる。

update の値には、新しい更新の値が格納される。

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

現在位置の取得を試み、この情報とともにpositionUpdated() を発する。与えられたtimeout （ミリ秒）以内に現在位置が見つからなかった場合、またはtimeout がminimumUpdateInterval （）によって返された値より小さい場合、UpdateTimeoutError を持つerrorOccurred （）シグナルが発せられる。

タイムアウトがゼロの場合、タイムアウトのデフォルトは、ソースに適した妥当なタイムアウト時間になります。

別の更新要求が進行中の場合、これは何もしない。ただし、startUpdates （）がすでに呼び出され、通常の更新が進行中であっても呼び出すことができます。

ソースが複数の測位方法を使用している場合、指定されたタイムアウト時間内に最も正確な測位方法から現在位置を取得しようとします。

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

name というバックエンド固有のプロパティをvalue に設定します。成功した場合はtrue を、そうでない場合はfalse を返します。バックエンド固有のプロパティを使用すると、実行時にポジショニング・サブシステムの動作を設定できます。サポートされているバックエンド固有のプロパティは、Qt Positioning plugins#Default plugins にリストされ、説明されています。

この関数は Qt 5.14 で導入されました。

backendPropertyも参照してください 。

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

setUpdateInterval() で指定された間隔で更新を開始します。

setUpdateInterval() が呼び出されていない場合、ソースは、更新が利用可能になり次第、更新を発行します。

このQGeoPositionInfoSource サブクラスが定期的な更新を提供できないと判断した場合は、UpdateTimeoutError のerrorOccurred() シグナルが発行されます。これは、衛星の修正が失われた場合や、ハードウェア・エラーが検出された場合に発生する可能性があります。後でデータが利用可能になれば、位置の更新は再開される。定期的な更新が再開されるまで、UpdateTimeoutError のエラーは再発行されません。

iOSでは、バージョン8から、Core Location frameworkは、アプリケーションのInfo.plistに、NSLocationAlwaysUsageDescriptionまたはNSLocationWhenInUseUsageDescriptionというキーと、認証プロンプトに表示する文字列を持つ追加のエントリを必要とします。NSLocationWhenInUseUsageDescriptionキーは、アプリがフォアグラウンドにあるときに位置情報サービスの使用許可を要求するときに使用されます。NSLocationAlwaysUsageDescription は、アプリが実行中（フォアグラウンドとバックグラウンドの両方）であればいつでも位置情報サービスの使用許可を要求するときに使用される。両方のエントリが定義されている場合、NSLocationWhenInUseUsageDescriptionはフォアグラウンドモードで優先されます。

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

定期的な更新を停止します。

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

このソースで使用可能な位置決めメソッドを返します。利用可能とは、この関数を呼び出した時点で使用可能であると定義されます。したがって、位置情報サービスのオフや衛星ベースの位置情報プロバイダーの制限などのユーザー設定は、この関数に反映されます。ステータスが変更されたときのランタイム通知は、supportedPositioningMethodsChanged （）を介して取得できます。

すべてのプラットフォームが異なる測位方法を区別したり、デバイスの現在のユーザー設定を伝達するわけではありません。以下の表は、現在のプラットフォーム状況の概要を示しています：

supportedPositioningMethodsChanged() およびsetPreferredPositioningMethods()も参照 。

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

このシグナルは、サポートされている測位方法が変更されたときに発行される。変更の原因としては、ユーザーが位置情報サービスのオン/オフを切り替えたり、位置情報サービスを特定のタイプ（GPSのみなど）に制限したりしたことが考えられます。対応する測位方法の変更は、すべてのプラットフォームで検出できるわけではないことに注意してください。supportedPositioningMethods() は現在のプラットフォームサポートの概要を提供します。

この機能は Qt 5.12 で導入されました。