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

最後に確認された位置情報を含む更新情報を返します。情報が利用できない場合は、nullの更新情報を返します。

fromSatellitePositioningMethodsOnly がtrueの場合、衛星測位方式から受信した最新の既知位置を返します。利用可能な位置がない場合は、nullの更新情報を返します。

[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 で導入されました。