class QGeoAreaMonitorInfo#

The QGeoAreaMonitorInfo class describes the parameters of an area or region to be monitored for proximity. More…

Synopsis#

Methods#

备注

本文档可能包含从C++自动转换成Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您遇到翻译问题，也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建工单的方式通知我们

详细说明#

区域监控的目的是通知用户当他/她接近一个感兴趣的区域。一般来说，该区域由一个 QGeoCircle 描述。圆的中心代表感兴趣的地方，周围的区域识别了发送通知的地理区域。

QGeoAreaMonitorInfo 对象有效，如果它有一个非空的名称和有效的 area() 。这样的对象必须注册到 QGeoAreaMonitorSource 来开始和停止监控过程。请注意，广泛的监控可能会非常耗费资源，因为定位引擎必须保持活跃，并且必须将每个 QGeoAreaMonitorInfo 实例的位置与当前位置进行匹配。

为了进一步减轻系统负担，有可选属性可以设置。每个监测区域都可以设置一个过期日期，一旦到达过期日期，将被监测的区域将从监测源中自动删除。另一个选项是调整监测区域的有效期。如果设置了isPersistent，则QGeoAreaMonitorInfo会超出当前应用程序的生命周期仍然保持激活状态。如果监测应用程序未运行时进入区域，则应用程序将被启动。注意，此功能并非在所有平台上都可用。其可用性可以通过supportedAreaMonitorFeatures进行检查。

另请参阅

QGeoAreaMonitorSource

__init__([name=""])#
参数：

name – str

使用指定的name构建QGeoAreaMonitorInfo对象。

另请参阅

name()

__init__(other)
参数：

other – QGeoAreaMonitorInfo

复制other构建一个QGeoAreaMonitorInfo对象。

area()#
返回类型：

QGeoShape

返回将被监测区域的边界。该区域不能为空。

另请参阅

setArea()

expiration()#
返回类型：

QDateTime

返回过期日期。

当一个活动的QGeoAreaMonitorInfo过期后，该区域将不再被监测，并且QGeoAreaMonitorInfo对象将从active monitors列表中删除。

如果过期日期无效，则QGeoAreaMonitorInfo对象被视为没有过期日期。如果该对象是持久的，则意味着 indefinite monitoring period，否则直到当前应用程序关闭。

identifier()#
返回类型：

str

返回QGeoAreaMonitorInfo对象的标识符。标识符在创建新的QGeoAreaMonitorInfo对象时自动生成。

isPersistent()#
返回类型：

bool

如果QGeoAreaMonitorInfo是持久的，则返回true。此属性的默认值为false。

非持久性的QGeoAreaMonitorInfo将在拥有监视对象的程序停止时被系统移除。持久对象保持活跃，并在程序重新启动后可以被检索。

如果系统激发与持久性的QGeoAreaMonitorInfo相关的事件，则相关应用程序将被重新启动并发射出适当的信号。

另请参阅

setPersistent()

isValid()#
返回类型：

bool

如果监视器有效，则返回true。有效的QGeoAreaMonitorInfo有非空的名字，并且监视的区域不是空的empty()。否则此函数返回false。

name()#
返回类型：

str

返回QGeoAreaMonitorInfo对象的名字。名字应该用作用户可见的目的。

另请参阅

setName()

notificationParameters()#
返回类型：

键为QString类型，值为QVariant类型的字典。

返回用于此QGeoAreaMonitorInfo的平台特定参数集合。

__ne__(rhs)#
参数：

rhs – QGeoAreaMonitorInfo

返回类型：

bool

如果 lhs 对象的任何值与 rhs 对象的值不同，则返回 true。否则返回 false。

__eq__(rhs)#
参数：

rhs – QGeoAreaMonitorInfo

返回类型：

bool

如果 lhs 对象的所有值与 rhs 对象的值相同，则返回 true。否则返回 false。

setArea(newShape)#
参数：

newShape – QGeoShape

将待监控区域设置为 newShape。

另请参阅

area()

setExpiration(expiry)#
参数：

expiry – QDateTime

将过期日期和时间设置为 expiry。

另请参阅

expiration()

setName(name)#
参数：

name – str

设置用户可见的 name。

另请参阅

name()

setNotificationParameters(parameters)#
参数：

parameters – 键为 QString 类型，值为 QVariant 类型的字典。

设置由 QGeoAreaMonitorInfo 使用的平台特定 parameters 集合。

setPersistent(isPersistent)#
参数：

isPersistent – bool

将 QGeoAreaMonitorInfo 对象的持久性设置为 isPersistent。

请注意，设置此标志并不意味着 QGeoAreaMonitorSource 支持“持续监控”。可以使用 supportedAreaMonitorFeatures() 检查此功能的可用性。

另请参阅

isPersistent()

swap(other)#
参数：

other – QGeoAreaMonitorInfo