QGeoLocation Class

The QGeoLocation class represents basic information about a location. 更多...

头: #include <QGeoLocation>
CMake: find_package(Qt6 COMPONENTS Positioning REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Since: Qt 5.2

公共函数

  QGeoLocation (QGeoLocation && other )
  QGeoLocation (const QGeoLocation & other )
  QGeoLocation ()
QGeoLocation & operator= (QGeoLocation && other )
QGeoLocation & operator= (const QGeoLocation & other )
  ~QGeoLocation ()
QGeoAddress address () const
QGeoShape boundingShape () const
QGeoCoordinate coordinate () const
QVariantMap extendedAttributes () const
bool isEmpty () const
void setAddress (const QGeoAddress & address )
void setBoundingShape (const QGeoShape & boundingShape )
void setCoordinate (const QGeoCoordinate & coordinate )
void setExtendedAttributes (const QVariantMap & data )
size_t qHash (const QGeoLocation & location , size_t seed = 0)
bool operator!= (const QGeoLocation & lhs , const QGeoLocation & rhs )
bool operator== (const QGeoLocation & lhs , const QGeoLocation & rhs )

详细描述

A QGeoLocation consists of a coordinate and corresponding address, along with an optional bounding shape, which is the recommended region to be displayed when viewing the location.

成员函数文档编制

[since 6.2] QGeoLocation:: QGeoLocation ( QGeoLocation && other )

Constructs a geo location object by moving from other .

注意: The moved-from QGeoLocation object can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

该函数在 Qt 6.2 引入。

QGeoLocation:: QGeoLocation (const QGeoLocation & other )

构造副本为 other

QGeoLocation:: QGeoLocation ()

Constructs an new location object.

[since 6.2] QGeoLocation &QGeoLocation:: operator= ( QGeoLocation && other )

Move-assings other to this location and returns a reference to this location.

注意: The moved-from QGeoLocation object can only be destroyed or assigned to. The effect of calling other functions than the destructor or one of the assignment operators is undefined.

该函数在 Qt 6.2 引入。

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

赋值 other to this location and returns a reference to this location.

QGeoLocation:: ~QGeoLocation ()

Destroys the location object.

QGeoAddress QGeoLocation:: address () const

Returns the address of the location.

另请参阅 setAddress ().

[since 6.2] QGeoShape QGeoLocation:: boundingShape () const

Returns a bounding shape which represents the recommended region to display when viewing this location.

For example, a building's location may have a region centered around the building, but the region is large enough to show it's immediate surrounding geographical context.

注意: This method was introduced in Qt6 instead of boundingBox() method. It returns a QGeoShape 而不是 QGeoRectangle 。使用 QGeoShape::boundingGeoRectangle () to obtain a bounding QGeoRectangle for the shape.

该函数在 Qt 6.2 引入。

另请参阅 setBoundingShape ().

QGeoCoordinate QGeoLocation:: coordinate () const

Returns the coordinate of the location.

另请参阅 setCoordinate ().

[since 5.13] QVariantMap QGeoLocation:: extendedAttributes () const

Returns the extended attributes associated to this location. Extended attributes are backend-dependent and can be location-dependent.

该函数在 Qt 5.13 引入。

另请参阅 setExtendedAttributes ().

bool QGeoLocation:: isEmpty () const

返回 true if the location coordinate is invalid , and all the other location fields are empty. Otherwise returns false .

void QGeoLocation:: setAddress (const QGeoAddress & address )

设置 address of the location.

另请参阅 address ().

[since 6.2] void QGeoLocation:: setBoundingShape (const QGeoShape & boundingShape )

设置 boundingShape of the location.

该函数在 Qt 6.2 引入。

另请参阅 boundingShape ().

void QGeoLocation:: setCoordinate (const QGeoCoordinate & coordinate )

设置 coordinate of the location.

另请参阅 coordinate ().

[since 5.13] void QGeoLocation:: setExtendedAttributes (const QVariantMap & data )

Sets the extended attributes of the location with the parameters specified in data .

该函数在 Qt 5.13 引入。

另请参阅 extendedAttributes ().

相关非成员

size_t qHash (const QGeoLocation & location , size_t seed = 0)

返回哈希值为 location ,使用 seed for the calculation.

注意: The hash does not take extended attributes into account. This means that two geo location objects that differ only in the extended attributes will provide similar hashes.

bool operator!= (const QGeoLocation & lhs , const QGeoLocation & rhs )

返回 true lhs location is not equal to rhs ,否则返回 false .

bool operator== (const QGeoLocation & lhs , const QGeoLocation & rhs )

返回 true lhs location is equal to rhs ,否则返回 false .