geoCoordinate QML Value Type

geoCoordinate 型は、地理的位置を表し、それを格納します。詳細...

プロパティ

• altitude : real
• isValid : bool
• latitude : real
• longitude : real

方法

• geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)
• real azimuthTo(geoCoordinate other)
• real distanceTo(geoCoordinate other)

詳細な説明

この型は、QGeoCoordinate の QML 表現であり、latitude 、longitude 、altitude 属性の形式で地理的位置を表します。latitude 属性は、赤道より上または下にある度数を小数点付きで指定します。正の緯度は北半球を、負の緯度は南半球を示します。longitude 属性は、東または西にある度数を小数点付きで指定します。 正の経度は東半球を、負の経度は西半球を示します。altitude 属性は、海抜の高さをメートル単位で指定します。これらの属性を組み合わせることで、地球の表面上またはその付近の任意の場所における3次元位置を指定することができます。

isValid 属性を使用すると、座標が有効かどうかを検証できます。座標は、有効な緯度と経度を持つ場合に有効とみなされます。有効な高度は必須ではありません。緯度は-90から90（両端を含む）の範囲内、経度は-180から180（両端を含む）の範囲内である必要があります。

geoCoordinate 型は、Qt Location モジュール内の他の多くの型で使用され、マップ上のオブジェクトの位置やデバイスの現在位置の指定など、さまざまなタスクに利用されます。また、atDistanceAndAzimuth() など、本来は複雑な計算を簡単に実行できる重要なユーティリティメソッドも多数備えています。

精度

geoCoordinate型に格納される緯度、経度、高度の各属性はdouble型で表され、小数点以下約16桁の精度を持っています。これは、マイクロメートル単位での指定にも十分な精度です。azimuthTo() やdistanceTo() などの geoCoordinate のメソッドで実行される計算でも、すべての中間値に double が使用されますが、球体としての地球モデルに固有の不正確さが、出力される誤差の大部分を占めています。

使用例

geoCoordinate を作成するには、以下に説明するメソッドのいずれかを使用します。いずれの場合も、altitude 属性の指定は任意です。

geoCoordinate値を作成するには、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

このプロパティには、地理的位置の緯度値（小数点付きの度）が格納されます。正の緯度は北半球を、負の緯度は南半球を示します。このプロパティが設定されていない場合、そのデフォルト値は NaN になります。

詳細については、QGeoCoordinate::latitude プロパティを参照してください。

longitude : real

このプロパティには、地理的位置の経度値（小数点付き度）が格納されます。正の経度は東半球を示し、負の経度は西半球を示します。このプロパティが設定されていない場合、そのデフォルト値は NaN になります。

詳細については、QGeoCoordinate::longitude プロパティを参照してください。

メソッドのドキュメント

geoCoordinate atDistanceAndAzimuth(real distance, real azimuth)

この座標から、azimuth 度の経度方向に沿って大円上をdistance メートル移動した地点の座標を返します。

この計算では、地球が球体であるという仮定が用いられています。

real azimuthTo(geoCoordinate other)

この座標から、other で指定された座標までの方位角（またはベアリング）を度単位で返します。高度は計算に使用されません。

この計算では、地球が球体であるという仮定が用いられています。

real distanceTo(geoCoordinate other)

この座標から、other で指定された座標までの距離（メートル単位）を返します。高度は計算に使用されません。

この計算では、2つの座標間の大円距離が返されます。なお、この計算では、地球が球体であるという仮定に基づいています。