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フレームワークは、アプリケーションの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 で導入されました。