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) |
Elementos 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 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.