geoCoordinate QML Value Type
geoCoordinate型は、地理的な位置を表し、保存します。詳細...
Import Statement: | import QtPositioning |
プロパティ
方法
- geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
- real azimuthTo(geoCoordinate other)
- real distanceTo(geoCoordinate other)
詳細な説明
この型はQGeoCoordinate をQMLで表現したもので、latitude 、longitude 、altitude 属性の形式で地理的な位置を表します。latitude 属性は、赤道から何度上か下かを示す。正の緯度は北半球を示し、負の緯度は南半球を示します。longitude 属性は、東西の小数点以下の度数を指定します。正の経度は東半球を表し、負の経度は西半球を表します。altitude 属性は海抜メートル数を特定します。併せて、これらの属性は、地表やその近辺の三次元位置を特定します。
isValid 属性は、座標が有効かどうかを調べるのに使えます。座標が有効であ る と 見な さ れ る のは、 その座標が有効な緯度 と 経度を持っ てい る と き です。有効な高度は必要あ り ません。緯度は -90 から 90 の間でなければならず、経度は -180 から 180 の間でなければなりません。
geoCoordinate型は、Qt Location モジュール内の他の多くの型によって使用され、マップ上のオブジェクトの位置やデバイスの現在位置、その他多くのタスクを指定します。また、atDistanceAndAzimuth() のような、複雑な計算を簡単にする重要なユーティリティ・メソッドも数多く備えている。
精度
geoCoordinate型に格納される緯度、経度、高度属性はdoubleとして表現され、マイクロメートルを指定するのに十分な約16桁の小数点以下の精度を与えます。azimuthTo() やdistanceTo() などのgeoCoordinateのメソッドで実行される計算も、すべての中間値にdoubleを使用しますが、その球体地球モデル固有の不正確さが、その出力の誤差の大きさを支配しています。
使用例
ジオ座標を作成するには、以下に説明する方法のいずれかを使用する。いずれの場合も、altitude 属性の指定はオプションです。
ジオ座標値を作成するには、QtPositioning.coordinate() 関数を使用します:
import QtPositioning Location { coordinate: QtPositioning.coordinate(-27.5, 153.1) }
または、latitude 、longitude 、altitude の各コンポーネントとして使用します:
Location { coordinate { latitude: -27.5 longitude: 153.1 } }
C++ と統合する場合、C++ から QML に渡されたQGeoCoordinate の値は自動的に geoCoordinate の値に変換されることに注意してください。
プロパティの説明
altitude : real |
このプロパティは高度(海抜メートル)を保持する。このプロパティが設定されていない場合、デフォルト値はNaNである。
詳細はQGeoCoordinate::altitude プロパティを参照。
isValid : bool |
このプロパティは座標の現在の有効性を保持する。座標は、 有効な緯度 と 経度が設定 さ れていれば有効 と 見な さ れます (高度は必要あ り ません)。
緯度は -90 から 90 の間でなければ有効とみなされず、経度は -180 から 180 の間でなければ有効とみなされない。
このプロパティは読み出し専用である。
latitude : real |
このプロパティは、地理的位置の緯度値(10 進数)を保持する。正の緯度は北半球を示し、負の緯度は南半球を示す。このプロパティが設定されていない場合、デフォルト値は NaN である。
詳細はQGeoCoordinate::latitude プロパティを参照。
longitude : real |
このプロパティは、地理的位置の経度値(10 進数)を保持する。このプロパティが設定されていない場合、デフォルト値は NaN である。
詳細については、QGeoCoordinate::longitude プロパティを参照してください。
メソッドの説明
geoCoordinate atDistanceAndAzimuth(real distance, real azimuth) |
この座標から大円に沿ってazimuth 度でdistance メートル移動したときに到達する座標を返す。
この計算には、地球が球形であるという仮定があります。
real azimuthTo(geoCoordinate other) |
この座標からother で指定された座標までの方位(または方角)を度単位で返します。高度 は計算に使われない。
この計算では、地球は球形であるという前提があります。
real distanceTo(geoCoordinate other) |
この座標からother で指定した座標までの距離(メートル単位)を返します。高度 は計算に使用されない。
この計算では、地球が球形であると仮定して、2 つの座標間の大円距離を返します。
© 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.