Address QML Type

Le type QML Adresse représente un lieu spécifique sous la forme d'une adresse de rue. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

Une adresse est utilisée comme unité de données pour des requêtes telles que le géocodage (inversé) ou les recherches de lieux - beaucoup de ces opérations acceptent une adresse ou en renvoient une.

Toutes les propriétés d'une adresse ne sont pas nécessairement disponibles ou pertinentes dans toutes les parties du monde et dans tous les lieux. Les propriétés district, state et county sont particulièrement spécifiques à une région pour de nombreuses sources de données, et souvent seulement une ou deux d'entre elles sont disponibles ou utiles.

L'adresse possède une propriété text qui contient une chaîne formatée. Il s'agit de la méthode recommandée pour afficher une adresse à l'utilisateur et elle prend généralement le format d'une adresse figurant sur une enveloppe, mais ce n'est pas toujours le cas. La propriété text peut être générée automatiquement à partir de propriétés d'adresse constitutives telles que street, city et ainsi de suite, mais elle peut également être attribuée explicitement. Voir text pour plus de détails.

Exemple d'utilisation

L'extrait de code suivant montre la déclaration d'un objet Adresse.

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

Cet objet peut ensuite être utilisé, par exemple, comme valeur d'une requête de géocodage, pour obtenir la longitude et la latitude exactes de l'adresse.

Voir également QGeoAddress.

Documentation sur les propriétés

address : QGeoAddress

Pour plus de détails sur l'utilisation de cette propriété pour l'interface entre C++ et QML, voir"Interfaces entre le code C++ et QML".

city : string

Cette propriété contient la ville de l'adresse sous la forme d'une chaîne de caractères formatée.

country : string

Cette propriété contient le pays de l'adresse sous la forme d'une chaîne de caractères formatée.

countryCode : string

Cette propriété contient le code pays de l'adresse sous la forme d'une seule chaîne formatée.

county : string

Cette propriété contient le comté de l'adresse sous la forme d'une chaîne formatée unique.

district : string

Cette propriété contient le district de l'adresse sous la forme d'une seule chaîne formatée.

isTextGenerated : bool

Cette propriété contient un booléen qui, s'il est vrai, indique que text est automatiquement généré à partir des propriétés de l'adresse. Si elle est fausse, elle indique que l'adresse text a été explicitement attribuée.

postalCode : string

Cette propriété contient le code postal de l'adresse sous la forme d'une seule chaîne formatée.

state : string

Cette propriété contient l'état de l'adresse sous la forme d'une seule chaîne formatée.

street : string

Cette propriété contient la rue de l'adresse.

streetNumber : string [since QtPositioning 6.2]

Cette propriété contient le numéro de rue de l'adresse, comme un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre.

Cette propriété a été introduite dans QtPositioning 6.2.

text : string

Cette propriété contient l'adresse sous la forme d'une chaîne formatée unique. C'est la chaîne qu'il est recommandé d'utiliser pour afficher l'adresse à l'utilisateur. Elle prend généralement le format d'une adresse telle qu'on la trouve sur une enveloppe, mais ce n'est pas toujours le cas.

L'adresse text est soit générée automatiquement, soit attribuée explicitement, ce qui peut être déterminé en vérifiant isTextGenerated.

Si une chaîne vide est attribuée à text, alors isTextGenerated sera mis à vrai et text renverra une chaîne formatée localement selon countryCode et basée sur les propriétés de l'adresse. La modification des propriétés de l'adresse, telles que street, city et ainsi de suite, peut entraîner une modification du contenu de text.

Si une chaîne non vide est attribuée à text, isTextGenerated sera défini comme faux et text renverra toujours la chaîne explicitement attribuée. La modification des propriétés d'adresse n'affecte pas la propriété text.