En esta página

Address QML Type

El tipo QML «Address» representa una ubicación concreta en forma de dirección postal. Más información...

Import Statement: import QtPositioning

Propiedades

Descripción detallada

Una dirección se utiliza como unidad de datos para consultas como la geocodificación (inversa) o las búsquedas de lugares; muchas de estas operaciones aceptan una dirección o devuelven una.

No todas las propiedades de una dirección están necesariamente disponibles o son relevantes en todas las partes del mundo y en todas las configuraciones regionales. Las propiedades « district », « state » y « county » son especialmente específicas de cada zona en muchas fuentes de datos y, a menudo, solo una o dos de ellas están disponibles o resultan útiles.

La dirección dispone de una propiedad « text » que contiene una cadena formateada. Es la forma recomendada de mostrar una dirección al usuario y, por lo general, adopta el formato de una dirección tal y como aparece en un sobre, aunque no siempre es así. La propiedad « text » puede generarse automáticamente a partir de propiedades de dirección constitutivas, como « street », « city », etc., pero también puede asignarse explícitamente. Consulte text para obtener más detalles.

Ejemplo de uso

El siguiente fragmento de código muestra la declaración de un objeto Address.

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

Este podría utilizarse, por ejemplo, como valor de una consulta de geocodificación, para obtener la longitud y latitud exactas de la dirección.

Véase también QGeoAddress.

Documentación de las propiedades

address : QGeoAddress

Para obtener más información sobre cómo utilizar esta propiedad para establecer una interfaz entre C++ y QML, consulta «Interfaces entre el código C++ y QML».

city : string

Esta propiedad contiene el nombre de la ciudad de la dirección en forma de una única cadena formateada.

country : string

Esta propiedad almacena el país de la dirección como una única cadena formateada.

countryCode : string

Esta propiedad contiene el código de país de la dirección en forma de una única cadena formateada.

county : string

Esta propiedad contiene la provincia de la dirección como una única cadena formateada.

district : string

Esta propiedad contiene el distrito de la dirección como una única cadena formateada.

isTextGenerated : bool

Esta propiedad contiene un valor booleano que, si es verdadero, indica que la dirección « text » se genera automáticamente a partir de las propiedades de dirección. Si es falso, indica que la dirección « text » se ha asignado de forma explícita.

postalCode : string

Esta propiedad contiene el código postal de la dirección en forma de una única cadena formateada.

state : string

Esta propiedad almacena el estado de la dirección como una única cadena formateada.

street : string

Esta propiedad contiene el nombre de la calle de la dirección.

Nota: Antes de Qt6, esta propiedad también podía contener datos como un número de piso, el nombre de un edificio o cualquier otro dato que pudiera servir para distinguir una dirección de otra. Desde Qt6, se utiliza la propiedad « streetNumber » para dicha información.

streetNumber : string [since QtPositioning 6.2]

Esta propiedad contiene el número de la calle de la dirección, como el número de piso, el nombre del edificio o cualquier otro dato que pueda servir para distinguir una dirección de otra.

Esta propiedad se introdujo en QtPositioning 6.2.

text : string

Esta propiedad contiene la dirección en forma de 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í.

La dirección text se genera automáticamente o se asigna de forma explícita; esto se puede determinar comprobando isTextGenerated.

Si se asigna una cadena vacía a ` text`, entonces ` isTextGenerated ` se establecerá en `true` y ` text ` devolverá una cadena formateada localmente de acuerdo con ` countryCode ` y basada en las propiedades de la dirección. Modificar las propiedades de la dirección, como ` street`, ` city `, etc., puede provocar que cambie el contenido de ` text `.

Si se asigna una cadena no vacía a text, entonces isTextGenerated se establecerá en «false» y text siempre devolverá la cadena asignada explícitamente. La modificación de las propiedades de la dirección no afectará a la propiedad text.

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