QGeoPositionInfo Class
QGeoPositionInfo クラスには、特定の時点における全球座標、方向、および速度に関する情報が格納されています。詳細...
| ヘッダー: | #include <QGeoPositionInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QGeoPositionInfoは「暗黙的に共有されるクラス」の一部です。
パブリック型
| enum | Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy } |
パブリック関数
| QGeoPositionInfo() | |
| QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp) | |
| QGeoPositionInfo(const QGeoPositionInfo &other) | |
(since 6.2) | QGeoPositionInfo(QGeoPositionInfo &&other) |
| ~QGeoPositionInfo() | |
| qreal | attribute(QGeoPositionInfo::Attribute attribute) const |
| QGeoCoordinate | coordinate() const |
| bool | hasAttribute(QGeoPositionInfo::Attribute attribute) const |
| bool | isValid() const |
| void | removeAttribute(QGeoPositionInfo::Attribute attribute) |
| void | setAttribute(QGeoPositionInfo::Attribute attribute, qreal value) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setTimestamp(const QDateTime ×tamp) |
(since 6.2) void | swap(QGeoPositionInfo &other) |
| QDateTime | timestamp() const |
(since 6.2) QGeoPositionInfo & | operator=(QGeoPositionInfo &&other) |
| QGeoPositionInfo & | operator=(const QGeoPositionInfo &other) |
関連する非メンバー
| bool | operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr) |
| QDataStream & | operator<<(QDataStream &stream, const QGeoPositionInfo &info) |
| bool | operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo &info) |
| QDataStream & | operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr) |
QGeoPositionInfoSourceも参照してください 。
メンバ型のドキュメント
enum QGeoPositionInfo::Attribute
位置情報の属性を定義します。
| 定数 | 値 | 説明 |
|---|---|---|
QGeoPositionInfo::Direction | 0 | 真北から進行方向に向かって時計回りに度単位で測定された方位。 |
QGeoPositionInfo::GroundSpeed | 1 | 対地速度（メートル/秒）。 |
QGeoPositionInfo::VerticalSpeed | 2 | 垂直速度（メートル/秒）。 |
QGeoPositionInfo::MagneticVariation | 3 | 磁場の水平成分と真北との間の角度（度）。磁気偏角とも呼ばれます。正の値は真北から時計回りの方向を示し、負の値は反時計回りの方向を示します。 |
QGeoPositionInfo::HorizontalAccuracy | 4 | 提供された緯度・経度の値の精度（メートル単位）。 |
QGeoPositionInfo::VerticalAccuracy | 5 | 提供された高度値の精度（メートル単位）。 |
QGeoPositionInfo::DirectionAccuracy | 6 | 提供された方位の精度（単位：度）。この属性は、Android（API レベル 26 以上）および macOS/iOS でのみ利用可能です。詳細については、対応するAndroidおよびAppleのドキュメントを参照してください。 |
NMEAプロトコルでは、もう1つの精度タイプである「PositionAccuracy」（3次元精度値）も定義されています。Qtではこれに対する個別の属性は提供されていません。この値が必要な場合は、以下の式に基づいて計算できます：
PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2
メンバ関数のドキュメント
QGeoPositionInfo::QGeoPositionInfo()
無効な QGeoPositionInfo オブジェクトを作成します。
isValid()も参照してください 。
QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime ×tamp)
指定されたcoordinate およびtimestamp に対して、QGeoPositionInfoを作成します。
QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
other の値を持つQGeoPositionInfoを作成します。
[constexpr noexcept default, since 6.2] QGeoPositionInfo::QGeoPositionInfo(QGeoPositionInfo &&other)
other から移動して、QGeoPositionInfoオブジェクトを作成します。
なお、移動元の QGeoPositionInfo に対しては、破棄するか、または代入を行うことしかできません。デストラクタや代入演算子以外の関数を呼び出した場合の結果は未定義となります。
この関数は Qt 6.2 で導入されました。
[noexcept] QGeoPositionInfo::~QGeoPositionInfo()
QGeoPositionInfo オブジェクトを破棄します。
qreal QGeoPositionInfo::attribute(QGeoPositionInfo::Attribute attribute) const
指定されたattribute の値をqreal値として返します。
値が設定されていない場合は、NaNを返します。
属性に値が設定されているかどうかを判断するには、hasAttribute() 関数を使用する必要があります。
hasAttribute() およびsetAttribute()も参照してください 。
QGeoCoordinate QGeoPositionInfo::coordinate() const
この位置の座標を返します。
座標が設定されていない場合は、無効な座標を返します。
setCoordinate()も参照してください 。
bool QGeoPositionInfo::hasAttribute(QGeoPositionInfo::Attribute attribute) const
このQGeoPositionInfo オブジェクトに対して、指定されたattribute が存在する場合、trueを返します。
bool QGeoPositionInfo::isValid() const
timestamp() およびcoordinate() の値が両方とも有効な場合、true を返します。
QGeoCoordinate::isValid() およびQDateTime::isValid()も参照してください 。
void QGeoPositionInfo::removeAttribute(QGeoPositionInfo::Attribute attribute)
指定されたattribute とその値を削除します。
void QGeoPositionInfo::setAttribute(QGeoPositionInfo::Attribute attribute, qreal value)
attribute の値をvalue に設定します。
attribute()も参照してください 。
void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
この位置の座標を `coordinate` に設定します。
coordinate()も参照してください 。
void QGeoPositionInfo::setTimestamp(const QDateTime ×tamp)
このポジションがtimestamp に報告された日時を設定します。
timestamp はUTC時間である必要があります。
timestamp()も参照してください 。
[noexcept, since 6.2] void QGeoPositionInfo::swap(QGeoPositionInfo &other)
この位置情報をother と交換します。この処理は非常に高速で、失敗することはありません。
この関数は Qt 6.2 で導入されました。
QDateTime QGeoPositionInfo::timestamp() const
この位置情報が報告された日時を、UTC時間で返します。
日時値が設定されていない場合は、無効なQDateTime を返します。
setTimestamp()も参照してください 。
[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)
other の値をこのオブジェクトに「移動代入」します。
なお、移動元の `QGeoPositionInfo ` に対しては、破棄するか、代入を行うことしかできません。デストラクタや代入演算子以外の関数を呼び出した場合の結果は未定義です。
この関数は Qt 6.2 で導入されました。
QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo &other)
other の値を、このQGeoPositionInfo に割り当てます。
関連する非メンバー
bool operator!=(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
lhs オブジェクトの値のいずれかがrhs の値と一致しない場合、true を返します。それ以外の場合は、false を返します。
QDataStream &operator<<(QDataStream &stream, QGeoPositionInfo::Attribute attr)
指定されたattr 列挙型を、指定されたstream に書き込みます。
「Qtデータ型のシリアライズ」も参照してください 。
QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
指定されたinfo を、指定されたstream に書き込みます。
「Qt データ型のシリアライズ」も参照してください 。
bool operator==(const QGeoPositionInfo &lhs, const QGeoPositionInfo &rhs)
lhs オブジェクトのすべての値がrhs の値と一致する場合、true を返します。それ以外の場合は、false を返します。
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
指定されたstream から座標を読み取り、指定されたinfo に格納します。
「Qt データ型のシリアライズ」も参照してください 。
QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo::Attribute &attr)
指定されたstream 情報から属性列挙を読み取り、指定されたattr に格納します。
「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.
