QGeoSatelliteInfo Class
QGeoSatelliteInfo クラスには、衛星に関する基本情報が格納されています。詳細...
| ヘッダー: | #include <QGeoSatelliteInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- QGeoSatelliteInfo は「暗黙的に共有されるクラス」の一部です。
パブリック型
| enum | Attribute { Elevation, Azimuth } |
| enum | SatelliteSystem { Undefined, GPS, GLONASS, GALILEO, BEIDOU, …, CustomType } |
プロパティ
- satelliteIdentifier : int
- satelliteSystem : SatelliteSystem
- signalStrength : qreal
公開関数
| QGeoSatelliteInfo() | |
| QGeoSatelliteInfo(const QGeoSatelliteInfo &other) | |
(since 6.2) | QGeoSatelliteInfo(QGeoSatelliteInfo &&other) |
| ~QGeoSatelliteInfo() | |
| qreal | attribute(QGeoSatelliteInfo::Attribute attribute) const |
| bool | hasAttribute(QGeoSatelliteInfo::Attribute attribute) const |
| void | removeAttribute(QGeoSatelliteInfo::Attribute attribute) |
| int | satelliteIdentifier() const |
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
| void | setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value) |
| void | setSatelliteIdentifier(int satId) |
| void | setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system) |
| void | setSignalStrength(int signalStrength) |
| int | signalStrength() const |
(since 6.2) void | swap(QGeoSatelliteInfo &other) |
(since 6.2) QGeoSatelliteInfo & | operator=(QGeoSatelliteInfo &&other) |
| QGeoSatelliteInfo & | operator=(const QGeoSatelliteInfo &other) |
関連する非メンバー
| bool | operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoSatelliteInfo &info) |
| bool | operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoSatelliteInfo &info) |
QGeoSatelliteInfoSourceも参照してください 。
メンバ型のドキュメント
enum QGeoSatelliteInfo::Attribute
衛星情報の属性を定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoSatelliteInfo::Elevation | 0 | 衛星の仰角（度単位）。 |
QGeoSatelliteInfo::Azimuth | 1 | 真北に対する方位角（度単位）。 |
enum QGeoSatelliteInfo::SatelliteSystem
衛星のGNSSシステムを定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | 未定義。 |
QGeoSatelliteInfo::GPS | 0x01 | 全地球測位システム（米国）。 |
QGeoSatelliteInfo::GLONASS | 0x02 | 全地球測位システム（ロシア）。 |
QGeoSatelliteInfo::GALILEO | 0x03 | 全地球測位システム（米国）。全地球測位システム（ロシア）。 |
QGeoSatelliteInfo::BEIDOU | 0x04 | 北斗（BeiDou）航法衛星システム（中国）。 |
QGeoSatelliteInfo::QZSS | 0x05 | 準天頂衛星システム（日本）。 |
QGeoSatelliteInfo::IRNSS (since Qt 6.12) | 0x06 | インド地域測位衛星システム。 |
QGeoSatelliteInfo::SBAS (since Qt 6.12) | 0x07 | 衛星ベースの補強システム。 |
QGeoSatelliteInfo::Multiple | 0xFF | このタイプは通常、情報が複数の衛星システムに対応するデバイスから受信されたことを示しており、衛星システムは明示的に指定されていません。 データソースによっては、他の情報を使用して実際のシステムタイプを判別する場合もあります。このタイプの使用例の一つとして、NMEA $GNGSA メッセージが挙げられます。このメッセージには、使用されている衛星の ID が含まれていますが、そのシステムタイプについては明示的に記載されていません。 |
QGeoSatelliteInfo::CustomType | 0x100 | ユーザーが目的のために使用できる最初のタイプ。たとえば、QNmeaSatelliteInfoSource での NMEA データ解析を再実装する場合などです。ユーザーは、CustomType + 1 、CustomType + 2 などを使用して、さらにタイプを追加することができます。 |
プロパティのドキュメント
[read-only] satelliteIdentifier : int
このプロパティには、衛星識別番号が格納されます。
衛星識別番号は、衛星システム内の衛星を特定するために使用できます。
実際の値は、プラットフォームや選択したバックエンドによって異なる場合があります。
たとえば、nmeaプラグインを使用する場合、GPS 衛星システムの衛星識別子は PRN (擬似ランダムノイズ) 番号を表し、GLONASS 衛星システムの衛星識別子はスロット番号を表します。
NMEA ベースのバックエンドの場合、他の情報源から衛星システムの種類が取得できないときは、衛星識別子を使用して衛星システムの種類を判別することができます。衛星 ID リストを参照して、さまざまな衛星システムの ID 範囲を確認することができます。
注：プラットフォームや選択したバックエンドによっては 、異なる衛星システムの衛星識別子の範囲が重複する場合があります。衛星を一意に識別するには、satelliteIdentifier()とsatelliteSystem()を組み合わせて使用する必要があります。
アクセス関数：
| int | satelliteIdentifier() const |
[read-only] satelliteSystem : SatelliteSystem
このプロパティには、GPSやGLONASSなど、使用中の衛星システムが格納されます。
衛星システム（GPS、GLONASS、…）を返します。
注：この 値は 、satelliteIdentifier と組み合わせて使用することで、衛星を一意に識別することができます。
アクセス関数：
| QGeoSatelliteInfo::SatelliteSystem | satelliteSystem() const |
「satelliteIdentifier」も参照してください 。
[read-only] signalStrength : qreal
このプロパティは信号強度を保持します。
アクセス関数：
| int | signalStrength() const |
メンバ関数のドキュメント
QGeoSatelliteInfo::QGeoSatelliteInfo()
衛星情報オブジェクトを作成します。
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
other の値を持つ衛星情報オブジェクトを作成します。
[constexpr noexcept default, since 6.2] QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
other から移動して、衛星情報オブジェクトを作成します。
なお、移動元の QGeoSatelliteInfo に対しては、破棄するか、または代入を行うことしかできません。デストラクタや代入演算子以外の関数を呼び出した場合の結果は未定義となります。
この関数は Qt 6.2 で導入されました。
[noexcept] QGeoSatelliteInfo::~QGeoSatelliteInfo()
衛星情報オブジェクトを削除します。
[invokable] qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
指定されたattribute の値をqreal型として返します。
値が設定されていない場合は -1 を返します。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
hasAttribute() およびsetAttribute()も参照してください 。
[invokable] bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
指定されたattribute が今回の更新に含まれている場合、trueを返します。
注：この関数は 、メタオブジェクトシステムを介して、およびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
指定されたattribute とその値を削除します。
int QGeoSatelliteInfo::satelliteIdentifier() const
衛星識別番号を返します。
注： プロパティ `satelliteIdentifier`のゲッター 関数です。
関連項目： setSatelliteIdentifier() およびsatelliteSystem()。
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
attribute の値をvalue に設定します。
attribute()も参照してください 。
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
衛星識別番号をsatId に設定します。
衛星識別番号は、衛星システム内の衛星を識別するために使用できます。
実際の値は、プラットフォームや選択したバックエンドによって異なる場合があります。
たとえば、nmeaプラグインを使用する場合、GPS 衛星システムの衛星識別子は PRN (擬似ランダムノイズ) 番号を表し、GLONASS 衛星システムの衛星識別子はスロット番号を表します。
satelliteIdentifier()も参照してください 。
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
衛星システム（GPS、GLONASSなど）を「system 」に設定します。
satelliteSystem()も参照してください 。
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
信号強度をデシベル単位でsignalStrength に設定します。
signalStrength()も参照してください 。
int QGeoSatelliteInfo::signalStrength() const
信号強度を返します。値が設定されていない場合は -1 を返します。
注： プロパティ signalStrengthのゲッター 関数です。
関連項目： setSignalStrength()。
[noexcept, since 6.2] void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
この衛星情報をother と交換します。この処理は非常に高速で、失敗することはありません。
この関数は Qt 6.2 で導入されました。
[noexcept, since 6.2] QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
other の値をこのオブジェクトに「移動代入」します
なお、移動元となったQGeoSatelliteInfo は、破棄されるか、代入されることしかできません。デストラクタや代入演算子以外の関数を呼び出した場合、その挙動は未定義となります。
この関数は Qt 6.2 で導入されました。
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
other の値をこのオブジェクトに割り当てます。
関連する非メンバー
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
lhs サテライトのパラメータのいずれかが、rhs のパラメータと一致しない場合、true を返します。それ以外の場合は、false を返します。
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
指定されたinfo を、指定されたstream に書き込みます。
「Qt データ型のシリアライズ」も参照してください 。
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
lhs サテライトのすべてのパラメータがrhs のパラメータと同一である場合、true を返します。それ以外の場合は、false を返します。
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
指定されたstream から衛星情報を読み取り、指定されたinfo に格納します。
「Qtデータ型のシリアライズ」も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
