QGeoLocation Class
La clase QGeoLocation representa la información básica sobre una ubicación. Más información...
| Encabezado: | #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) |
Elementos no miembros relacionados
| 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
Un QGeoLocation consta de una coordenada y la dirección correspondiente, junto con una forma delimitadora opcional, que es la región recomendada que debe mostrarse al visualizar la ubicación.
Documentación de las funciones de miembro
QGeoLocation::QGeoLocation()
Crea un nuevo objeto de ubicación.
QGeoLocation::QGeoLocation(const QGeoLocation &other)
Crea una copia de other
[constexpr noexcept default, since 6.2] QGeoLocation::QGeoLocation(QGeoLocation &&other)
Crea un objeto de geolocalización a partir de other.
Nota: El objeto QGeoLocation del que se ha obtenido solo puede destruirse o asignarse. 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()
Elimina el objeto de ubicación.
QGeoAddress QGeoLocation::address() const
Devuelve la dirección de la ubicación.
Véase también setAddress().
[since 6.2] QGeoShape QGeoLocation::boundingShape() const
Devuelve una forma delimitadora que representa la zona recomendada para mostrar al visualizar esta ubicación.
Por ejemplo, la ubicación de un edificio puede tener una región centrada en torno al edificio, pero la región es lo suficientemente amplia como para mostrar el contexto geográfico de sus inmediaciones.
Nota: Este método se introdujo en Qt6 en sustitución del método `boundingBox()`. Devuelve un ` QGeoShape ` en lugar de un ` QGeoRectangle`. Utiliza ` QGeoShape::boundingGeoRectangle()` para obtener un ` QGeoRectangle ` delimitador para la forma.
Esta función se introdujo en Qt 6.2.
Véase también setBoundingShape().
QGeoCoordinate QGeoLocation::coordinate() const
Devuelve las coordenadas de la ubicación.
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 el valor de « 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 el valor de « 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)
Intercambia esta ubicación con 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 el objeto ` other ` a esta ubicación y devuelve una referencia a dicha ubicación.
Nota: El objeto « QGeoLocation » del que se ha realizado el traslado solo 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 dicha ubicación.
Elementos 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 solo difieran en los atributos extendidos proporcionarán hashes similares.
bool operator!=(const QGeoLocation &lhs, const QGeoLocation &rhs)
Devuelve « true » si la direcció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.