geoCoordinate QML Value Type

座標型は、地理的な位置を表し、保存します。詳細...

プロパティ

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

方法

• real distanceTo(geoCoordinate other)

詳細な説明

この型は、latitude およびlongitude プロパティの形式で地理的位置を表します。latitude プロパティは、赤道からの上下方向の度数を小数点付きで指定します。正の緯度は北半球を、負の緯度は南半球を示します。longitude プロパティは、東西方向の度数を小数点付きで指定します。 経度の値が正の場合は東半球、負の場合は西半球を示します。これらの属性を組み合わせることで、地球表面上の任意の地点における2次元座標を指定します。

isValid プロパティは、座標が有効かどうかを示すブール値を返します。座標の有効性は、その緯度および経度の値によって判断されます。緯度は-90から90までの範囲（両端を含む）でなければならず、経度は-180から180までの範囲（両端を含む）でなければなりません。

geoCoordinate 型は、Qt Location モジュールのMap 項目で、マップの中心を指定するために使用されます。

精度

coordinate型に格納される緯度および経度の属性はdouble型として表現され、小数点以下約16桁の精度を持ちます。これはマイクロメートル単位の指定に十分な精度です。

使用例

geoCoordinate 値を作成するには、そのlatitude およびlongitude プロパティを使用します。

Map {
    center {
        latitude: -27.5
        longitude: 153.1
    }
}

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

isValid : bool

このプロパティは、座標の現在の有効性を保持します。座標は、有効な緯度と経度が設定されている場合に有効とみなされます。

緯度は-90から90までの範囲（両端を含む）に、経度は-180から180までの範囲（両端を含む）に設定されている場合にのみ、有効とみなされます。

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

latitude : real

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

longitude : real

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

メソッドのドキュメント

real distanceTo(geoCoordinate other)

この座標から、other で指定された座標までの距離（メートル単位）を返します。

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

この座標またはother が無効な座標である場合は、0 を返します。

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。