En esta página

QGeoAddress Class

La clase QGeoAddress representa una dirección de un QGeoLocation. Más...

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

Funciones públicas

QGeoAddress()
QGeoAddress(const QGeoAddress &other)
(since 6.2) QGeoAddress(QGeoAddress &&other)
~QGeoAddress()
QString city() const
void clear()
QString country() const
QString countryCode() const
QString county() const
QString district() const
bool isEmpty() const
bool isTextGenerated() const
QString postalCode() const
void setCity(const QString &city)
void setCountry(const QString &country)
void setCountryCode(const QString &countryCode)
void setCounty(const QString &county)
void setDistrict(const QString &district)
void setPostalCode(const QString &postalCode)
void setState(const QString &state)
void setStreet(const QString &street)
(since 6.2) void setStreetNumber(const QString &streetNumber)
void setText(const QString &text)
QString state() const
QString street() const
(since 6.2) QString streetNumber() const
(since 6.2) void swap(QGeoAddress &other)
QString text() const
(since 6.2) QGeoAddress &operator=(QGeoAddress &other)
QGeoAddress &operator=(const QGeoAddress &address)
size_t qHash(const QGeoAddress &address, size_t seed = 0)
bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

Descripción detallada

Los atributos de la dirección están normalizados a nombres de características de EE.UU. y pueden asignarse a los niveles de características locales (por ejemplo, State coincide con "Bundesland" en Alemania).

La dirección contiene un text() a efectos de visualización y propiedades adicionales para acceder a los componentes de una dirección:

Documentación de las funciones miembro

QGeoAddress::QGeoAddress()

Constructor por defecto.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Construye una copia de other.

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

Construye un objeto geo address moviendo desde other.

Nota: El objeto QGeoAddress 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] QGeoAddress::~QGeoAddress()

Destruye esta dirección.

QString QGeoAddress::city() const

Devuelve la ciudad.

Véase también setCity().

void QGeoAddress::clear()

Borra todos los campos de datos de la dirección.

QString QGeoAddress::country() const

Devuelve el nombre del país.

Véase también setCountry().

QString QGeoAddress::countryCode() const

Devuelve el código de país según ISO 3166-1 alpha-3

Véase también setCountryCode().

QString QGeoAddress::county() const

Devuelve el condado. El condado se considera la segunda subdivisión por debajo del país.

Véase también setCounty().

QString QGeoAddress::district() const

Devuelve el distrito. El distrito se considera la subdivisión inferior a la ciudad.

Véase también setDistrict().

bool QGeoAddress::isEmpty() const

Devuelve si esta dirección está vacía. Una dirección se considera vacía si todos sus campos están vacíos.

bool QGeoAddress::isTextGenerated() const

Devuelve true si QGeoAddress::text() se genera automáticamente a partir de elementos de dirección, en caso contrario devuelve false si text() se ha asignado explícitamente.

Véase también text() y setText().

QString QGeoAddress::postalCode() const

Devuelve el código postal.

Véase también setPostalCode().

void QGeoAddress::setCity(const QString &city)

Establece la dirección city.

Véase también city().

void QGeoAddress::setCountry(const QString &country)

Establece el nombre de country.

Véase también country().

void QGeoAddress::setCountryCode(const QString &countryCode)

Establece el countryCode según ISO 3166-1 alpha-3

Véase también countryCode().

void QGeoAddress::setCounty(const QString &county)

Establece la dirección county.

Véase también county().

void QGeoAddress::setDistrict(const QString &district)

Establece la dirección district.

Véase también district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Establece la dirección postalCode.

Véase también postalCode().

void QGeoAddress::setState(const QString &state)

Establece la dirección state.

Véase también state().

void QGeoAddress::setStreet(const QString &street)

Establece el nombre de la calle en street.

Nota: Antes de Qt6 esto también podía contener cosas como un número de unidad, un nombre de edificio, o cualquier otra cosa que pudiera ser usada para distinguir una dirección de otra. Utilice setStreetNumber() para establecer estos datos ahora.

Véase también street() y setStreetNumber().

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

Establece el número de la calle en streetNumber.

Esto también puede contener cosas como un número de unidad, un nombre de edificio, o cualquier otra cosa que pueda ser usada para distinguir una dirección de otra.

Nota: Antes de Qt6 esta información se establecía mediante el método setStreet().

Esta función se introdujo en Qt 6.2.

Véase también streetNumber() y setStreet().

void QGeoAddress::setText(const QString &text)

Si text no está vacío, asigna explícitamente text como la cadena a devolver por text(). isTextGenerated() devolverá false.

Si text está vacío, indica que text() debe generarse automáticamente a partir de los elementos de dirección. isTextGenerated() devolverá true.

Véase también text().

QString QGeoAddress::state() const

Devuelve el estado. El estado se considera la primera subdivisión por debajo de país.

Véase también setState().

QString QGeoAddress::street() const

Devuelve el nombre de la calle.

Nota: Antes de Qt6 esto también podía contener cosas como un número de unidad, un nombre de edificio, o cualquier otra cosa que pudiera usarse para distinguir una dirección de otra. Utilice ahora streetNumber() para obtener estos datos.

Véase también setStreet() y streetNumber().

[since 6.2] QString QGeoAddress::streetNumber() const

Devuelve el número de la calle.

Esto también puede contener cosas como un número de unidad, un nombre de edificio, o cualquier otra cosa que pueda ser usada para distinguir una dirección de otra.

Nota: Antes de Qt6 esta información era devuelta por el método street().

Esta función se introdujo en Qt 6.2.

Véase también setStreetNumber() y street().

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

Intercambia esta dirección con other. Esta operación es muy rápida y nunca falla.

Esta función se introdujo en Qt 6.2.

QString QGeoAddress::text() const

Devuelve la dirección como una única cadena formateada. Es la cadena recomendada para mostrar la dirección al usuario. Normalmente toma el formato de una dirección tal y como se encuentra en un sobre, pero no siempre es así.

El texto de la dirección se genera automáticamente o se asigna explícitamente. Esto puede determinarse comprobando isTextGenerated.

Si se proporciona una cadena vacía a setText(), entonces isTextGenerated() se ajustará a true y text() devolverá una cadena formateada localmente según countryCode() y basada en los elementos de la dirección como calle, ciudad, etc. Dado que la cadena de texto se genera a partir de los elementos de la dirección, una secuencia de llamadas como text(), setStreet(), text() puede devolver cadenas diferentes en cada invocación de text().

Si se proporciona una cadena no vacía a setText(), entonces isTextGenerated() se establecerá en false y text() devolverá siempre la cadena asignada explícitamente. Las llamadas para modificar otros elementos como setStreet(), setCity(), etc., no afectarán a la cadena resultante de text().

Véase también setText().

[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

Mover-asigna el other a esta dirección y devuelve una referencia a esta dirección.

Nota: El objeto QGeoAddress movido 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.

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

Asigna el address dado a esta dirección y devuelve una referencia a esta dirección.

No miembros relacionados

[noexcept] size_t qHash(const QGeoAddress &address, size_t seed = 0)

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

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

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

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

Devuelve true si la direcció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.