QGeoCoordinate Class

メンバ関数のドキュメント

QGeoCoordinate::QGeoCoordinate()

座標を構築します。setLatitude() およびsetLongitude() が呼び出されるまでは、この座標は無効となります。

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

指定されたlatitude およびlongitude を用いて座標を生成します。

緯度が-90から90（両端を含む）の範囲外である場合、または経度が-180から180（両端を含む）の範囲外である場合、いずれの値も設定されず、type()はQGeoCoordinate::InvalidCoordinate となります。

isValid()も参照してください 。

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude, double altitude)

指定された `latitude`、`longitude `、および `altitude` を用いて座標を生成します。

緯度が-90から90の範囲（両端を含む）外である場合、または経度が-180から180の範囲（両端を含む）外である場合、どの値も設定されず、type()はQGeoCoordinate::InvalidCoordinate となります。

なお、altitude は海抜（メートル単位）を指定します。

isValid()も参照してください 。

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

other の内容から座標を生成します。

[constexpr noexcept default, since 6.2] QGeoCoordinate::QGeoCoordinate(QGeoCoordinate &&other)

other から移動して座標を生成します。

この関数は Qt 6.2 で導入されました。

[noexcept] QGeoCoordinate::~QGeoCoordinate()

座標オブジェクトを削除します。

double QGeoCoordinate::altitude() const

高度（海抜メートル）を返します。

高度が設定されていない場合、戻り値は未定義となります。

関連項目： setAltitude() およびtype()。

[invokable] QGeoCoordinate QGeoCoordinate::atDistanceAndAzimuth(qreal distance, qreal azimuth, qreal distanceUp = 0.0) const

現在の座標から、azimuth （または方位）に沿って大円に沿ってdistance メートル移動した地点の座標を返します。この計算では、地球が球体であることを前提としています。

高度にはdistanceUp が加算されます。

この座標が無効な場合は、無効な座標を返します。

[invokable] qreal QGeoCoordinate::azimuthTo(const QGeoCoordinate &other) const

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

返される方位角は、原点からother までの、2つの座標を結ぶ大円に沿った方位角です。この計算では、地球が球体であるという仮定に基づいています。

この座標の型またはother の型がQGeoCoordinate::InvalidCoordinate である場合、0を返します。

[invokable] qreal QGeoCoordinate::distanceTo(const QGeoCoordinate &other) const

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

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

この座標の型またはother の型がQGeoCoordinate::InvalidCoordinate の場合、0を返します。

bool QGeoCoordinate::isValid() const

longitude およびlatitude が有効な場合、true を返します。

double QGeoCoordinate::latitude() const

緯度を10進度の形式で返します。緯度が設定されていない場合、戻り値は未定義となります。

正の緯度は北半球を、負の緯度は南半球を示します。

関連項目： setLatitude() およびtype()。

double QGeoCoordinate::longitude() const

経度を10進度の値で返します。経度が設定されていない場合、戻り値は未定義となります。

正の経度は東半球、負の経度は西半球を示します。

関連項目： setLongitude() およびtype()。

void QGeoCoordinate::setAltitude(double altitude)

高度（海抜メートル）をaltitude に設定します。

altitude()も参照してください 。

void QGeoCoordinate::setLatitude(double latitude)

緯度（小数点表記の度）をlatitude に設定します。値はWGS84座標系で指定する必要があります。

有効な値とするには、緯度は-90から90までの範囲（両端を含む）でなければなりません。

latitude()も参照してください 。

void QGeoCoordinate::setLongitude(double longitude)

経度（小数度）をlongitude に設定します。値はWGS84座標系で指定する必要があります。

有効な値とするには、経度は -180 から 180 の範囲内（両端を含む）でなければなりません。

longitude()も参照してください 。

[noexcept, since 6.2] void QGeoCoordinate::swap(QGeoCoordinate &other)

この座標を `other` と入れ替えます。この操作は非常に高速で、失敗することはありません。

この関数は Qt 6.2 で導入されました。

[invokable] QString QGeoCoordinate::toString(QGeoCoordinate::CoordinateFormat format = DegreesMinutesSecondsWithHemisphere) const

この座標を、指定されたformat 形式の文字列として返します。

たとえば、この座標の緯度が -27.46758、経度が 153.027892、高度が 28.1 の場合、format に応じて次のような文字列が返されます：

高度が設定されていない場合、高度フィールドは省略されます。

座標が無効な場合、空の文字列が返されます。

QGeoCoordinate::CoordinateType QGeoCoordinate::type() const

この座標の型を返します。

[noexcept, since 6.2] QGeoCoordinate &QGeoCoordinate::operator=(QGeoCoordinate &&other)

other をこの座標に割り当てて、この座標への参照を返します。

この関数は Qt 6.2 で導入されました。

QGeoCoordinate &QGeoCoordinate::operator=(const QGeoCoordinate &other)

この座標にother を割り当て、この座標への参照を返します。