Тип QML Location
Тип Location хранит данные о местоположении. Подробнее...
| Заявление об импорте: | import QtPositioning |
| С момента: | Qt 5.2 |
Свойства
- address : Адрес
- boundingShape : геоформа
- coordinate : координата
- location : QGeoLocation
Подробное описание
Типы Location представляют географическое "местоположение" в человеческом смысле. Это включает в себя конкретную координату, адрес и ограничивающую форму. Ограничивающая форма представляет собой рекомендуемую область для отображения при просмотре этого местоположения.
Тип Location чаще всего используется как содержимое модели поиска, например, GeocodeModel. Когда GeocodeModel возвращает список найденных местоположений для заданного запроса, он представляет их как объекты Location.
Пример использования
Следующий пример показывает объявление простого объекта Location:
Location {
coordinate {
latitude: -27.3
longitude: 153.1
}
address: Address {
...
}
} Документация по свойствам
address : Address
Это свойство содержит адрес местоположения, который можно использовать для получения деталей адреса местоположения.
[с QtPositioning 6.2] boundingShape : geoshape
Это свойство содержит рекомендуемую область, которую следует использовать при отображении местоположения. Например, местоположение здания может иметь область, сосредоточенную вокруг здания, но эта область достаточно велика, чтобы показать его непосредственное географическое окружение.
Примечание: Сигнал changed() этого свойства в настоящее время генерируется только при изменении всего объекта, а не только при изменении содержимого объекта.
Примечание: Это свойство было введено в Qt6 вместо свойства boundingBox. Оно возвращает геоформу вместо геопрямоугольника. Используйте QGeoShape::boundingGeoRectangle() для получения ограничивающего геопрямоугольника для формы.
Если вам нужно преобразовать возвращаемую форму в определенный тип, используйте свойство type геоформы вместе с удобными методами из QtPositioning, например, QtPositioning.shapeToRectangle().
Это свойство было введено в QtPositioning 6.2.
coordinate : coordinate
Это свойство содержит точную географическую координату местоположения, которая может использоваться для получения широты, долготы и высоты местоположения.
Примечание: Сигнал changed() этого свойства в настоящее время генерируется только при изменении всего объекта, а не только при изменении содержимого объекта.
location : QGeoLocation
Для получения подробной информации о том, как использовать это свойство для взаимодействия между C++ и QML, см. "Интерфейсы между кодом C++ и QML".
Примечание: Это свойство обновляет всю информацию о геолокации, поэтому его использование приведет к разрыву всех связей для всех других свойств.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtpositioning-location.html