Address QML Type

El tipo QML Dirección representa una ubicación específica como una dirección de calle. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• address : QGeoAddress
• city : string
• country : string
• countryCode : string
• county : string
• district : string
• isTextGenerated : bool
• postalCode : string
• state : string
• street : string
• streetNumber : string (since QtPositioning 6.2)
• text : string

Descripción detallada

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

No todas las propiedades de una dirección están necesariamente disponibles o son relevantes en todas las partes del mundo y en todos los lugares. Las propiedades district, state y county son particularmente específicas de cada zona para muchas fuentes de datos, y a menudo sólo una o dos de ellas están disponibles o son útiles.

La dirección tiene una propiedad text que contiene una cadena formateada. Es la forma recomendada de mostrar una dirección al usuario y suele adoptar el formato de una dirección como la que se encuentra en un sobre, pero no siempre es así. text puede generarse automáticamente a partir de propiedades de dirección constituyentes como street, city, etc., pero también puede asignarse explícitamente. Consulte text para obtener más información.

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"
}

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 propiedades

address : QGeoAddress

Para obtener más información sobre cómo utilizar esta propiedad para establecer interfaces entre C++ y QML, consulte"Interfaces entre código C++ y QML".

city : string

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

country : string

Esta propiedad contiene 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 como una única cadena formateada.

county : string

Esta propiedad contiene el condado 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 booleano que si es verdadero, indica que text se genera automáticamente a partir de las propiedades de dirección. Si es false, indica que text se ha asignado explícitamente.

postalCode : string

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

state : string

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

street : string

Esta propiedad contiene la calle de la dirección.

streetNumber : string [since QtPositioning 6.2]

Esta propiedad contiene el número de la calle de la dirección, como un número de unidad, un nombre de edificio o cualquier otra cosa que pueda utilizarse para distinguir una dirección de otra.

Esta propiedad se introdujo en QtPositioning 6.2.

text : string

Esta propiedad contiene 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 este no es siempre necesariamente el caso.

La dirección text se genera automáticamente o se asigna explícitamente, lo que puede determinarse comprobando isTextGenerated.

Si se asigna una cadena vacía a text, entonces isTextGenerated se pondrá a true y text devolverá una cadena formateada localmente según countryCode y basada en las propiedades de la dirección. La modificación de las propiedades de la dirección, como street, city, etc., puede hacer que cambie el contenido de text.

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