このページでは

Position QML Type

「位置」タイプには、座標(経度、緯度、高度)や速度など、特定の時点における位置情報が格納されます。詳細...

Import Statement: import QtPositioning

プロパティ

詳細説明

Position型は、coordinate (経度、緯度、高度)などの地理的位置に関する値、Positionが取得された時点のtimestamp 、その時点のspeed 、およびデータの精度を保持します。

主に、PositionSource のposition プロパティで使用され、システムの位置情報データソースから取得できるデータの基本単位となります。

Position オブジェクトのすべてのプロパティが必ずしも有効である、あるいは利用可能であるとは限りません(たとえば、緯度や経度は有効であっても、速度の更新が受信されていない、あるいは手動で設定されていない場合があります)。その結果、この位置情報の更新においてデータが利用可能かつ有効であるかどうかを判別するために、対応する「有効な」プロパティ(たとえば、coordinate 、longitudeValid 、latitudeValid など)が利用可能になります。

Positionオブジェクトは読み取り専用であり、PositionSource によってのみ生成されます。

使用例

PositionSource 型の例、または「Satellite Info」サンプルアプリケーションを参照してください。

「 PositionSource 」および「coordinate 」も参照してください 。

プロパティのドキュメント

altitudeValid : bool

このプロパティは、座標の高度が設定されている場合にtrueとなります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

coordinateも参照してください 。

coordinate : coordinate

このプロパティには、Position の緯度、経度、および高度の値が格納されます。

これは読み取り専用のプロパティです。

longitudeValid 、latitudeValid 、およびaltitudeValidも参照してください 。

direction : double [since Qt Positioning 5.3]

このプロパティには、真北からの進行方向の角度(度単位)が格納されます。

これは読み取り専用のプロパティです。

このプロパティは、Qt Positioning 5.3 で導入されました。

「directionValid」も参照してください 。

directionAccuracy : double [since Qt Positioning 6.3]

このプロパティは、指定されたdirection の精度(度単位)を保持します。このプロパティは、AndroidおよびmacOS/iOSでのみ有効です。詳細については、QGeoPositionInfo::Attribute のドキュメントを参照してください。

このプロパティは、Qt Positioning 6.3で導入されました。

「 direction 」および「directionAccuracyValid 」も参照してください 。

directionAccuracyValid : bool [since Qt Positioning 6.3]

directionAccuracy が設定されている場合、このプロパティは `true ` となります。

このプロパティは、Qt Positioning 6.3 で導入されました。

「directionAccuracy」も参照してください 。

directionValid : bool [since Qt Positioning 5.3]

direction が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているわけではないため、そのデータが受信されたかどうかを示すためです)。

このプロパティは、Qt Positioning 5.3で導入されました。

「direction」も参照してください 。

horizontalAccuracy : real

このプロパティは、座標の水平精度(メートル単位)を保持します。

「 horizontalAccuracyValid 」および「coordinate 」も参照してください 。

horizontalAccuracyValid : bool

horizontalAccuracy が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

「horizontalAccuracy」も参照してください 。

latitudeValid : bool

このプロパティは、座標の緯度が設定されている場合にtrueとなります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

coordinateも参照してください 。

longitudeValid : bool

このプロパティは、座標の経度が設定されている場合にtrueとなります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

coordinateも参照してください 。

magneticVariation : double [since Qt Positioning 5.4]

このプロパティは、磁場の水平成分と真北との間の角度を度単位で保持します。磁偏角とも呼ばれます。正の値は真北から時計回りの方向を示し、負の値は反時計回りの方向を示します。

これは読み取り専用のプロパティです。

このプロパティは、Qt Positioning 5.4で導入されました。

「magneticVariationValid」も参照してください 。

magneticVariationValid : bool [since Qt Positioning 5.4]

magneticVariation が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

このプロパティは、Qt Positioning 5.4 で導入されました。

「magneticVariation」も参照してください 。

speed : double

このプロパティには、速度(対地速度、メートル/秒)の値が格納されます。

これは読み取り専用のプロパティです。

「 speedValid 」および「coordinate 」も参照してください 。

speedValid : bool

speed が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

「speed」も参照してください 。

timestamp : date

このプロパティには、この位置情報が受信された時点のタイムスタンプが格納されます。このプロパティが設定されていない場合、無効となります。

これは読み取り専用のプロパティです。

verticalAccuracy : real

このプロパティは、座標の垂直方向の精度(メートル単位)を保持します。

「 verticalAccuracyValid 」および「coordinate 」も参照してください 。

verticalAccuracyValid : bool

verticalAccuracy が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているわけではないため、そのデータが受信されたかどうかを示すためです)。

「verticalAccuracy」も参照してください 。

verticalSpeed : double [since Qt Positioning 5.3]

このプロパティには、メートル毎秒単位の垂直速度の値が格納されます。

これは読み取り専用のプロパティです。

このプロパティは、Qt Positioning 5.3で導入されました。

「verticalSpeedValid」も参照してください 。

verticalSpeedValid : bool [since Qt Positioning 5.3]

verticalSpeed が設定されている場合、このプロパティは true になります(すべての更新に必ずしもすべてのデータが含まれているとは限らないため、そのデータが受信されたかどうかを示すためです)。

このプロパティは、Qt Positioning 5.3で導入されました。

「verticalSpeed」も参照してください 。

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