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) |
No miembros relacionados
| 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.