QGeoSatelliteInfoSource Class

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

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

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

指定されたparent を持つサテライトソースを作成します。

[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)

指定されたparent を持つソースを作成し、sourceName という名前のプラグインを読み込んで返します。

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

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

指定されたparent を持つサテライトソースを作成し、sourceName という名前のプラグインを読み込んで返します。

プラグインが見つからない場合は、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()シグナルが送信されます。

タイムアウトが 0 の場合、タイムアウトはソースに適した妥当な期間にデフォルト設定されます。

別の更新要求が進行中の場合、この呼び出しは何の効果も持ちません。ただし、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()

一定間隔での更新の送信を停止します。