QGeoSatelliteInfoSource Class

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

メンバ関数ドキュメント

[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

サテライト・ソースを破棄する。

[static] QStringList QGeoSatelliteInfoSource::availableSources()

利用可能なソース・プラグインのリストを返します。利用可能な場合は、既定のシステム・バックエンドも含まれます。

[virtual, since 6.2] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

name というバックエンド固有のプロパティが存在する場合は、その値を返します。そうでない場合、返される値は無効です。

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

setBackendPropertyも参照してください 。

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

指定されたparent を持つソースを作成し、返します。このソースは、システムのデフォルトの衛星更新情報 ソース、または利用可能なプラグインの中で最も優先順位の高いものから読み取ります。

システムに既定の衛星ソースがない場合、有効なプラグインが見つからない場合、またはユーザが衛星 データにアクセスする権限を持っていない場合は、nullptr を返します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

最後に発生したエラーを返します。

[signal] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)

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

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

現在の衛星情報の取得を試み、その情報を用いてsatellitesInViewUpdated() およびsatellitesInUseUpdated() を発行する。与えられたtimeout （ミリ秒単位）以内に現在の衛星情報が見つからなかった場合、またはtimeout がminimumUpdateInterval() によって返された値より小さかった場合、UpdateTimeoutError を持つerrorOccurred() シグナルが発行される。

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

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

[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)

startUpdates() またはrequestUpdate() を呼び出すと、現在使用中の衛星の数が更新されたときにこのシグナルが発せられます。

これらの衛星は、「フィックス」、つまり現在位置を決定するために使用される衛星である。

satellites パラメータには、現在使用中の衛星が格納される。

[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)

startUpdates （）またはrequestUpdate （）が呼び出された場合、 このシグナルは、現在見えている衛星の更新が可能になったときに発せられる。

satellites パラメータは、現在表示中の衛星を保持する。

[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

name というバックエンド固有のプロパティをvalue に設定する。成功した場合はtrue を返し、失敗した場合はfalse を返す。バックエンド固有のプロパティを使用すると、実行時に衛星情報サブシステムの動作を設定できます。

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

backendPropertyも参照してください 。

QString QGeoSatelliteInfoSource::sourceName() const

使用中のサテライト・ソース実装の一意の名前を返します。

これは、createSource() に渡すことで、特定の衛星情報ソース実装の新しいインスタンスを作成できるのと同じ名前です。

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

定期的に更新を開始する。更新は、新しい衛星情報が利用可能になるたびに提供される。

衛星情報が取得できなかったり、何らかのタイムアウトが発生したりした場合は、satellitesInViewUpdated （）とsatellitesInUseUpdated （）のシグナルが空のパラメータリストで出力されることがあります。

satellitesInViewUpdated() およびsatellitesInUseUpdated()も参照してください 。

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

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