geocircle QML Value Type

The geocircle type represents a circular geographic area. More...

Import Statement: import QtPositioning 6.5

Detailed Description

The geocircle type is a geoshape that represents a circular geographic area. It is a direct representation of a QGeoCircle and is defined in terms of a coordinate which specifies the center of the circle and a qreal which specifies the radius of the circle in meters.

The circle is considered invalid if the center coordinate is invalid or if the radius is less than zero.

Example Usage

Use properties of type var to store a geocircle. To create a geocircle value, use the QtPositioning.circle() function:

import QtPositioning

Item {
    property var region: QtPositioning.circle(QtPositioning.coordinate(-27.5, 153.1), 1000)
}

When integrating with C++, note that any QGeoCircle value passed into QML from C++ is automatically converted into a geocircle value, and vise-versa.

Properties

center

coordinate radius

This property holds the coordinate of the center of the geocircle.

radius

real radius

This property holds the radius of the geocircle in meters.

The default value for the radius is -1 indicating an invalid geocircle area.

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