Location QML Type
Der Typ „Standort“ enthält Standortdaten. Mehr dazu...
| Import Statement: | import QtPositioning |
Eigenschaften
- address : Address
- boundingShape : geoShape
(since QtPositioning 6.2) - coordinate : coordinate
- extendedAttributes : VariantMap
- location : QGeoLocation
Ausführliche Beschreibung
Standorttypen stellen einen geografischen „Standort“ im menschlichen Verständnis dar. Dieser besteht aus einem spezifischen coordinate, einem address und einem bounding shape. Der bounding shape gibt die empfohlene Region an, die bei der Anzeige dieses Standorts angezeigt werden soll.
Der Standorttyp tritt am häufigsten als Inhalt eines Suchmodells wie beispielsweise des GeocodeModel auf. Wenn ein GeocodeModel die Liste der für eine bestimmte Suchanfrage gefundenen Standorte zurückgibt, stellt er diese als Standortobjekte dar.
Anwendungsbeispiel
Das folgende Beispiel zeigt die Deklaration eines einfachen „Location“-Objekts:
Location {
coordinate {
latitude: -27.3
longitude: 153.1
}
address: Address {
...
}
}Dokumentation zu den Eigenschaften
address : Address
Diese Eigenschaft enthält die Adresse des Standorts, über die Adressdetails des Standorts abgerufen werden können.
boundingShape : geoShape [since QtPositioning 6.2]
Diese Eigenschaft enthält den empfohlenen Bereich, der bei der Anzeige des Standorts verwendet werden soll. Beispielsweise kann der Standort eines Gebäudes einen Bereich umfassen, dessen Mittelpunkt das Gebäude bildet, der jedoch groß genug ist, um die unmittelbare geografische Umgebung darzustellen.
Hinweis: Diese Eigenschaft wurde in Qt6 als Ersatz für die Eigenschaft „boundingBox“ eingeführt. Sie gibt ein „ geoShape “ anstelle eines „ geoRectangle “ zurück. Verwenden Sie „ QGeoShape::boundingGeoRectangle()“, um ein Begrenzungs geoRectangle für die Form zu erhalten.
Wenn Sie die zurückgegebene Form in einen bestimmten Typ konvertieren müssen, verwenden Sie die Eigenschaft „ type “ von „ geoShape “ zusammen mit den Hilfsmethoden aus „ QtPositioning “, wie z. B. „ QtPositioning.shapeToRectangle()“.
Diese Eigenschaft wurde in QtPositioning 6.2 eingeführt.
coordinate : coordinate
Diese Eigenschaft enthält die genauen geografischen Koordinaten des Standorts, anhand derer sich der Breitengrad, der Längengrad und die Höhe des Standorts ermitteln lassen.
extendedAttributes : VariantMap
Diese Eigenschaft enthält die erweiterten Attribute für diesen Standort. Erweiterte Attribute sind backendabhängig und können standortabhängig sein.
location : QGeoLocation
Einzelheiten zur Verwendung dieser Eigenschaft für die Anbindung zwischen C++ und QML finden Sie unter„Schnittstellen zwischen C++- und QML-Code“.
Hinweis: Diese Eigenschaft aktualisiert die gesamten Geolokalisierungsdaten, sodass ihre Verwendung dazu führt, dass alle Bindungen für alle anderen Eigenschaften unterbrochen werden.
© 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.