Location QML Type

Der Typ Standort enthält Standortdaten. Mehr...

Import Statement: import QtPositioning

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

address : Address
boundingShape : geoshape (since QtPositioning 6.2)
coordinate : coordinate
location : QGeoLocation

Detaillierte Beschreibung

Standorttypen stellen einen geografischen "Standort" im menschlichen Sinne dar. Er besteht aus einem bestimmten coordinate, einem address und einem bounding shape. Der bounding shape stellt die empfohlene Region dar, die bei der Anzeige dieses Ortes angezeigt werden soll.

Der Standorttyp wird am häufigsten als Inhalt eines Suchmodells wie GeocodeModel verwendet. Wenn GeocodeModel die Liste der für eine bestimmte Abfrage gefundenen Standorte zurückgibt, stellt es diese als Standortobjekte dar.

Beispielverwendung

Das folgende Beispiel zeigt, wie ein einfaches Location-Objekt deklariert wird:

Location {
    coordinate {
        latitude: -27.3
        longitude: 153.1
    }
    address: Address {
        ...
    }
}

Eigenschaft Dokumentation

address : Address

Diese Eigenschaft enthält die Adresse des Ortes, die verwendet werden kann, um Adressdetails des Ortes abzurufen.

boundingShape : geoshape [since QtPositioning 6.2]

Diese Eigenschaft enthält die empfohlene Region, die bei der Anzeige des Ortes zu verwenden ist. Zum Beispiel kann der Standort eines Gebäudes einen Bereich haben, der um das Gebäude herum zentriert ist, aber der Bereich ist groß genug, um den unmittelbaren geografischen Kontext zu zeigen.

Hinweis: Das Signal changed() dieser Eigenschaft wird derzeit nur ausgegeben, wenn sich das gesamte Objekt ändert, nicht wenn sich nur der Inhalt des Objekts ändert.

Hinweis: Diese Eigenschaft wurde in Qt6 anstelle der Eigenschaft boundingBox eingeführt. Sie gibt ein geoshape anstelle eines georectangle zurück. Verwenden Sie QGeoShape::boundingGeoRectangle(), um ein begrenzendes georectangle für die Form zu erhalten.

Wenn Sie die zurückgegebene Form in einen bestimmten Typ konvertieren müssen, verwenden Sie die type Eigenschaft von geoshape zusammen mit Komfortmethoden von QtPositioning wie QtPositioning.shapeToRectangle().

Diese Eigenschaft wurde in QtPositioning 6.2 eingeführt.

coordinate : coordinate

Diese Eigenschaft enthält die exakten geographischen Koordinaten des Ortes, die verwendet werden können, um den Breitengrad, Längengrad und die Höhe des Ortes zu ermitteln.

Hinweis: Das changed()-Signal dieser Eigenschaft wird derzeit nur ausgegeben, wenn sich das gesamte Objekt ändert, nicht wenn sich nur der Inhalt des Objekts ändert.

location : QGeoLocation

Details zur Verwendung dieser Eigenschaft als Schnittstelle zwischen C++ und QML finden Sie unter"Schnittstellen zwischen C++- und QML-Code".

Hinweis: Diese Eigenschaft aktualisiert die gesamte Geolocation-Information, so dass die Verwendung dieser Eigenschaft dazu führt, dass alle Bindungen für alle anderen Eigenschaften aufgehoben werden.

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