Address QML Type

Der QML-Typ „Address“ stellt einen bestimmten Ort als Straßenadresse dar. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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

Ausführliche Beschreibung

Eine Adresse wird als Dateneinheit für Abfragen wie (Reverse-)Geokodierung oder Ortssuchen verwendet – viele dieser Vorgänge akzeptieren entweder eine Adresse oder geben eine zurück.

Nicht alle Eigenschaften einer Adresse sind zwangsläufig in allen Teilen der Welt und allen Sprachregionen verfügbar oder relevant. Die Eigenschaften „ district “, „ state “ und „ county “ sind bei vielen Datenquellen besonders regionsspezifisch, und oft sind nur eine oder zwei davon verfügbar oder nützlich.

Die Adresse verfügt über die Eigenschaft „ text “, die eine formatierte Zeichenfolge enthält. Dies ist die empfohlene Methode, um dem Benutzer eine Adresse anzuzeigen, und entspricht in der Regel dem Format einer Adresse, wie sie auf einem Briefumschlag zu finden ist; dies ist jedoch nicht immer der Fall. Die Eigenschaft „ text “ kann automatisch aus den zugehörigen Adresseigenschaften wie „ street “, „ city “ usw. generiert werden, kann aber auch explizit zugewiesen werden. Weitere Informationen finden Sie unter text.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt die Deklaration eines „Address“-Objekts.

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

Dieses könnte dann beispielsweise als Wert einer Geokodierungsabfrage verwendet werden, um die genauen Längen- und Breitengrade für die Adresse zu ermitteln.

Siehe auch QGeoAddress.

Dokumentation zu den Eigenschaften

address : QGeoAddress

Einzelheiten dazu, wie Sie diese Eigenschaft für die Anbindung zwischen C++ und QML nutzen können, finden Sie unter„Schnittstellen zwischen C++- und QML-Code“.

city : string

Diese Eigenschaft enthält den Namen der Stadt, auf die sich die Adresse bezieht, als einzelne formatierte Zeichenkette.

country : string

Diese Eigenschaft enthält das Land der Adresse als einzelne formatierte Zeichenfolge.

countryCode : string

Diese Eigenschaft enthält den Ländercode der Adresse als eine einzige formatierte Zeichenfolge.

county : string

Diese Eigenschaft enthält den Landkreis der Adresse als einzelne formatierte Zeichenfolge.

district : string

Diese Eigenschaft enthält den Bezirk der Adresse als einzelne formatierte Zeichenfolge.

isTextGenerated : bool

Diese Eigenschaft enthält einen booleschen Wert, der, falls er „true“ ist, angibt, dass „ text “ automatisch aus den Adress-Eigenschaften generiert wird. Ist der Wert „false“, bedeutet dies, dass „ text “ explizit zugewiesen wurde.

postalCode : string

Diese Eigenschaft enthält die Postleitzahl der Adresse als eine einzige formatierte Zeichenfolge.

state : string

Diese Eigenschaft enthält den Status der Adresse als einzelne formatierte Zeichenfolge.

street : string

Diese Eigenschaft enthält die Straße der Adresse.

streetNumber : string [since QtPositioning 6.2]

Diese Eigenschaft enthält die Hausnummer der Adresse, beispielsweise eine Wohnungsnummer, einen Gebäudenamen oder einen anderen Begriff, der zur Unterscheidung einer Adresse von einer anderen dienen kann.

Diese Eigenschaft wurde in QtPositioning 6.2 eingeführt.

text : string

Diese Eigenschaft enthält die Adresse als einzelne formatierte Zeichenfolge. Es handelt sich um die empfohlene Zeichenfolge, die zur Anzeige der Adresse für den Benutzer verwendet werden sollte. Sie hat in der Regel das Format einer Adresse, wie sie auf einem Briefumschlag zu finden ist, was jedoch nicht immer der Fall sein muss.

Die Adresse „ text “ wird entweder automatisch generiert oder explizit zugewiesen; dies lässt sich durch Überprüfung von „ isTextGenerated “ feststellen.

Wird „ text “ eine leere Zeichenkette zugewiesen, wird „ isTextGenerated “ auf „true“ gesetzt und „ text “ gibt eine Zeichenkette zurück, die lokal gemäß „ countryCode “ und basierend auf den Eigenschaften der Adresse formatiert ist. Das Ändern der Adress-Eigenschaften wie „ street “, „ city “ usw. kann dazu führen, dass sich der Inhalt von „ text “ ändert.

Wird „ text “ eine nicht leere Zeichenkette zugewiesen, wird „ isTextGenerated “ auf „false“ gesetzt und „ text “ gibt stets die explizit zugewiesene Zeichenkette zurück. Das Ändern der Adress-Eigenschaften hat keinen Einfluss auf die Eigenschaft „ text “.