QGeoCoordinate Class

成员函数文档

QGeoCoordinate::QGeoCoordinate()

构造一个坐标。在调用setLatitude() 和setLongitude() 之前，坐标无效。

QGeoCoordinate::QGeoCoordinate(double latitude, double longitude)

用给定的latitude 和longitude 构建一个坐标。

如果纬度不在 -90 至 90 之间（包括 90），或经度不在 -180 至 180 之间（包括 180），则不设置任何值，type() 将是QGeoCoordinate::InvalidCoordinate 。

另请参见 isValid()。

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

用给定的latitude 、longitude 和altitude 构建一个坐标。

如果纬度不在 -90 至 90 之间（包括 90），或经度不在 -180 至 180 之间（包括 180），则不设置任何值，type() 将是QGeoCoordinate::InvalidCoordinate 。

请注意，altitude 指定的是海拔高度。

另请参见 isValid()。

QGeoCoordinate::QGeoCoordinate(const QGeoCoordinate &other)

根据other 的内容构建坐标。

[noexcept, 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 的方位。计算时假设地球为球面。

如果该坐标的类型或other 的类型为QGeoCoordinate::InvalidCoordinate ，则返回 0。

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

返回此坐标到other 指定坐标的距离（以米为单位）。计算中不使用海拔高度。

计算时假定地球为球面，返回两个坐标之间的大圆距离。

如果该坐标的类型或other 的类型为QGeoCoordinate::InvalidCoordinate ，则返回 0。

bool QGeoCoordinate::isValid() const

如果longitude 和latitude 有效，则返回true 。

double QGeoCoordinate::latitude() const

以十进制度为单位返回纬度。如果未设置纬度，则返回值未定义。

正纬度表示北半球，负纬度表示南半球。

另请参阅 setLatitude() 和type()。

double QGeoCoordinate::longitude() const

以十进制度为单位返回经度。如果没有设置经度，则返回值未定义。

正经度表示东半球，负经度表示西半球。

另请参阅 setLongitude() 和type()。

void QGeoCoordinate::setAltitude(double altitude)

将高度（海拔米）设为altitude 。

另请参阅 altitude() 。

void QGeoCoordinate::setLatitude(double latitude)

将纬度（十进制度）设置为latitude 。该值应使用 WGS84 基准。

纬度值必须在 -90 至 90 之间（含 90）才有效。

另请参阅 latitude() 。

void QGeoCoordinate::setLongitude(double longitude)

将经度（十进制度）设置为longitude 。该值应使用 WGS84 基准。

经度值必须在 -180 至 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)

Move-assignsother 到此坐标，并返回此坐标的引用。

此函数在 Qt 6.2 中引入。

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

为该坐标指定other 并返回该坐标的引用。