En esta página

QGeoAddress Class

La clase QGeoAddress representa la dirección de un « QGeoLocation ». Más información...

Encabezado: #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 se normalizan según los nombres de elementos de EE. UU. y pueden asignarse a los niveles de elementos locales (por ejemplo, «State» se corresponde con «Bundesland» en Alemania).

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

Documentación de funciones de miembro

QGeoAddress::QGeoAddress()

Constructor por defecto.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Crea una copia de other.

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

Crea un objeto de dirección geográfica a partir de other.

Nota: El objeto `QGeoAddress` del que se ha obtenido 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.

[noexcept] QGeoAddress::~QGeoAddress()

Elimina esta dirección.

QString QGeoAddress::city() const

Devuelve el nombre de 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 la norma ISO 3166-1 alfa-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 de rango 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 los 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 el valor de « 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 código « countryCode » según la norma ISO 3166-1 alfa-3

Véase también countryCode().

void QGeoAddress::setCounty(const QString &county)

Establece el valor de « county ».

Véase también county().

void QGeoAddress::setDistrict(const QString &district)

Establece el valor « district ».

Véase también district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Establece el valor de « postalCode ».

Véase también postalCode().

void QGeoAddress::setState(const QString &state)

Establece el valor de « state ».

Véase también state().

void QGeoAddress::setStreet(const QString &street)

Establece el nombre de la calle como « street ».

Nota: Antes de Qt6, esto también podía incluir elementos como el número de piso, el nombre del edificio o cualquier otro dato que pudiera servir para distinguir una dirección de otra. Ahora, utiliza setStreetNumber() para establecer estos datos.

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 ».

También puede incluir datos como el número de piso, el nombre del edificio o cualquier otro dato que pueda servir 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éanse también streetNumber() y setStreet().

void QGeoAddress::setText(const QString &text)

Si « text » no está vacío, se asigna explícitamente « text » como la cadena que debe devolver « text()». « isTextGenerated()» devolverá «false».

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

Véase también text().

QString QGeoAddress::state() const

Devuelve el estado. Se considera que el estado es la primera subdivisión por debajo del 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 elementos como un número de portal, el nombre de un edificio o cualquier otro dato que pudiera servir para distinguir una dirección de otra. Ahora, utiliza 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.

También puede incluir datos como el número de piso, el nombre del edificio o cualquier otro dato que sirva para distinguir una dirección de otra.

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

Esta función se introdujo en Qt 6.2.

Véanse 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 adopta el formato de una dirección tal y como aparece en un sobre, aunque no siempre es así.

El texto de la dirección se genera automáticamente o se asigna de forma explícita. Esto se puede determinar comprobando ` isTextGenerated`.

Si se proporciona una cadena vacía a ` setText()` (), entonces ` isTextGenerated()` se establecerá en ` true ` y `text()` devolverá una cadena formateada localmente de acuerdo con ` countryCode()` y basada en los elementos de la dirección, como la calle, la 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() y 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()` siempre devolverá 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().

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

La operación de asignación por movimiento asigna el objeto ` other ` a esta dirección y devuelve una referencia a dicha dirección.

Nota: El objeto ` QGeoAddress ` del que se ha realizado la asignación por movimiento 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.

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

Asigna el « address » indicado a esta dirección y devuelve una referencia a dicha dirección.

Elementos relacionados no miembros

[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.