QGeoPositionInfo Class

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

ヘッダー #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)
(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)

詳細説明

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)

与えられたcoordinatetimestamp の 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() の両方が有効な場合に 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 &timestamp)

この位置が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)

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)

指定されたstream に、指定されたattr 列挙型を書き込みます。

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

QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)

指定されたstream に、指定されたinfo を書き込みます。

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)

指定されたattrstream info から属性列挙を読み込みます。

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

© 2025 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.