En esta página

QGeoLocation Class

La clase QGeoLocation representa información básica sobre una ubicación. Más...

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

Funciones públicas

QGeoLocation()
QGeoLocation(const QGeoLocation &other)
(since 6.2) QGeoLocation(QGeoLocation &&other)
~QGeoLocation()
QGeoAddress address() const
(since 6.2) QGeoShape boundingShape() const
QGeoCoordinate coordinate() const
QVariantMap extendedAttributes() const
bool isEmpty() const
void setAddress(const QGeoAddress &address)
(since 6.2) void setBoundingShape(const QGeoShape &boundingShape)
void setCoordinate(const QGeoCoordinate &coordinate)
void setExtendedAttributes(const QVariantMap &data)
(since 6.2) void swap(QGeoLocation &other)
(since 6.2) QGeoLocation &operator=(QGeoLocation &&other)
QGeoLocation &operator=(const QGeoLocation &other)
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)

Descripción detallada

Una QGeoLocation consiste en una coordenada y su correspondiente dirección, junto con una forma delimitadora opcional, que es la región que se recomienda mostrar al visualizar la ubicación.

Documentación de las funciones de los miembros

QGeoLocation::QGeoLocation()

Construye un nuevo objeto de localización.

QGeoLocation::QGeoLocation(const QGeoLocation &other)

Construye una copia de other

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

Construye un objeto de geo-localización moviendo desde other.

Nota: El objeto QGeoLocation movido desde sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.

Esta función se introdujo en Qt 6.2.

[noexcept] QGeoLocation::~QGeoLocation()

Destruye el objeto de localización.

QGeoAddress QGeoLocation::address() const

Devuelve la dirección del lugar.

Véase también setAddress().

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

Devuelve una forma delimitadora que representa la región recomendada para mostrar cuando se visualiza esta ubicación.

Por ejemplo, la ubicación de un edificio puede tener una región centrada alrededor del edificio, pero la región es lo suficientemente grande como para mostrar su contexto geográfico circundante inmediato.

Nota: Este método se introdujo en Qt6 en lugar del método boundingBox(). Devuelve un QGeoShape en lugar de un QGeoRectangle. Utilice QGeoShape::boundingGeoRectangle() para obtener un QGeoRectangle delimitador de la forma.

Esta función se introdujo en Qt 6.2.

Véase también setBoundingShape().

QGeoCoordinate QGeoLocation::coordinate() const

Devuelve la coordenada del lugar.

Véase también setCoordinate().

QVariantMap QGeoLocation::extendedAttributes() const

Devuelve los atributos extendidos asociados a esta ubicación. Los atributos extendidos dependen del backend y pueden depender de la ubicación.

Véase también setExtendedAttributes().

bool QGeoLocation::isEmpty() const

Devuelve true si la coordenada de ubicación es invalid, y todos los demás campos de ubicación están vacíos. En caso contrario, devuelve false.

void QGeoLocation::setAddress(const QGeoAddress &address)

Establece la dirección address de la ubicación.

Véase también address().

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

Establece el boundingShape de la ubicación.

Esta función se introdujo en Qt 6.2.

Véase también boundingShape().

void QGeoLocation::setCoordinate(const QGeoCoordinate &coordinate)

Establece la dirección coordinate de la ubicación.

Véase también coordinate().

void QGeoLocation::setExtendedAttributes(const QVariantMap &data)

Establece los atributos extendidos de la ubicación con los parámetros especificados en data.

Véase también extendedAttributes().

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

Cambia esta ubicación por other. Esta operación es muy rápida y nunca falla.

Esta función se introdujo en Qt 6.2.

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

Mueve-asigna other a esta ubicación y devuelve una referencia a esta ubicación.

Nota: El objeto movido-desde QGeoLocation sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.

Esta función se introdujo en Qt 6.2.

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

Asigna other a esta ubicación y devuelve una referencia a la misma.

No miembros relacionados

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

Devuelve el valor hash de location, utilizando seed para el cálculo.

Nota: El hash no tiene en cuenta los atributos extendidos. Esto significa que dos objetos de geolocalización que difieran sólo en los atributos extendidos proporcionarán hashes similares.

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

Devuelve true si la ubicación lhs no es igual a rhs, en caso contrario devuelve false.

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

Devuelve true si la ubicación lhs es igual a rhs, en caso contrario devuelve false.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.