QGeoPositionInfo Class

QGeoPositionInfo クラスは、特定の時点でのグローバルな位置、方向、速度に関する情報を収集したものです。詳細...

Header: #include <QGeoPositionInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

パブリックタイプ

enum Attribute { Direction, GroundSpeed, VerticalSpeed, MagneticVariation, HorizontalAccuracy, …, DirectionAccuracy }

パブリック関数

QGeoPositionInfo()
QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &timestamp)
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 &timestamp)
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)

詳細説明

QGeoPositionInfo には、最低限、地理座標とタイムスタンプが含まれます。また、提供されたデータの精度の推定値だけでなく、方位と速度の測定値を持つこともあります。

QGeoPositionInfoSourceも参照

メンバ型ドキュメント

enum QGeoPositionInfo::Attribute

位置情報の属性を定義する。

定数説明
QGeoPositionInfo::Direction0進行方向に対して、真北から時計回りで測った方位。
QGeoPositionInfo::GroundSpeed1対地速度、単位はメートル/秒。
QGeoPositionInfo::VerticalSpeed2垂直速度、メートル/秒単位。
QGeoPositionInfo::MagneticVariation3磁場の水平成分と真北との角度(度)。偏角ともいう。正の値は真北から時計回りの方向を示し、負の値は反時計回りの方向を示す。
QGeoPositionInfo::HorizontalAccuracy4提供された緯度経度値の精度(メートル単位)。
QGeoPositionInfo::VerticalAccuracy5提供された高度値の精度(メートル単位)。
QGeoPositionInfo::DirectionAccuracy6提供された方位の精度、単位は度。この属性はAndroid(APIレベル26以上)とmacOS/iOSでのみ利用可能です。詳細については、対応するAndroidと Appleのドキュメントを参照してください。

NMEA プロトコルでは、3D 精度の値である PositionAccuracy という別のタイプの精度も提案しています。Qtはこの精度を表す個別の属性を提供していません。この値が必要な場合は、以下の式に基づいて計算することができます:

PositionAccuracy 2 = HorizontalAccuracy 2 + VerticalAccuracy 2

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

QGeoPositionInfo::QGeoPositionInfo()

無効な QGeoPositionInfo オブジェクトを作成します。

isValid()も参照

QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &timestamp)

与えられたcoordinate およびtimestamp の QGeoPositionInfo を作成します。

QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)

other の値を持つ QGeoPositionInfo を作成します。

[noexcept, 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

指定されたattribute がこのQGeoPositionInfo オブジェクトに存在する場合は true を返します。

bool QGeoPositionInfo::isValid() const

timestamp() およびcoordinate() の値が両方とも有効な場合は真を返す。

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 &timestamp)

この位置が報告された日時をtimestamp に設定します。

timestamp は UTC 時間でなければなりません。

timestamp() も参照して ください。

QDateTime QGeoPositionInfo::timestamp() const

この位置が報告された日時を UTC 時間で返します。

日時値が設定されていない場合は、無効なQDateTime を返します。

setTimestamp()も参照

[noexcept, since 6.2] QGeoPositionInfo &QGeoPositionInfo::operator=(QGeoPositionInfo &&other)

Move-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 info から、指定されたattr に属性列挙を読み込みます。

Qt データ型のシリアライズ」も参照して ください。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。