QGeoPositionInfoSource Class

// Emit updates every 10 seconds if available
QGeoPositionInfoSource *source = QGeoPositionInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

成员函数文档

[explicit] QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *parent)

创建一个带有指定parent 的定位源。

[virtual noexcept] QGeoPositionInfoSource::~QGeoPositionInfoSource()

销毁位置源。

[static] QStringList QGeoPositionInfoSource::availableSources()

返回一个包含可用源插件的列表。其中包含当前平台的任何默认后端插件。

[virtual, since Qt 5.14] QVariant QGeoPositionInfoSource::backendProperty(const QString &name) const

如果存在名为name 的后端特定属性，则返回该属性的值；否则，返回的值将无效。支持的后端特定属性及其说明请参见Qt Positioning plugins#Default plugins。

该函数于 Qt 5.14 中引入。

另请参阅 setBackendProperty 。

[static] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(QObject *parent)

创建并返回一个位置来源，该来源使用指定的parent 从系统的默认位置数据源读取数据，或者使用可用优先级最高的插件。

如果系统没有默认位置来源、未找到有效的插件，或者用户无权访问当前位置，则返回nullptr 。

[static, since Qt 5.14] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

创建并返回一个位置来源，该来源使用给定的parent ，从系统的默认位置数据来源或可用优先级最高的插件中读取数据。

如果系统没有默认位置来源、未找到有效的插件，或者用户无权访问当前位置，则返回nullptr 。

此方法将 `parameters ` 传递给工厂类以配置该源。

该函数于 Qt 5.14 中引入。

[static] QGeoPositionInfoSource *QGeoPositionInfoSource::createSource(const QString &sourceName, QObject *parent)

通过加载名为sourceName 的插件，创建并返回一个具有指定parent 的定位源。

如果找不到该插件，则返回nullptr 。

[static, since Qt 5.14] QGeoPositionInfoSource *QGeoPositionInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

通过加载名为sourceName 的插件，创建并返回一个具有指定parent 的位置源。

如果找不到该插件，则返回nullptr 。

该方法将parameters 传递给工厂以配置该源。

该函数在 Qt 5.14 中引入。

[pure virtual] QGeoPositionInfoSource::Error QGeoPositionInfoSource::error() const

返回上次发生的错误类型。

[signal] void QGeoPositionInfoSource::errorOccurred(QGeoPositionInfoSource::Error positioningError)

该信号在发生错误后发出。positioningError 参数描述了发生的错误类型。

[pure virtual] QGeoPositionInfo QGeoPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const

返回包含最后已知位置的更新，若无可用位置，则返回空更新。

如果 `fromSatellitePositioningMethodsOnly ` 为真，则返回从卫星定位方法接收到的最后已知位置；如果没有可用位置，则返回空更新。

[signal] void QGeoPositionInfoSource::positionUpdated(const QGeoPositionInfo &update)

如果调用了startUpdates()或requestUpdate()，当有更新可用时，将触发此信号。

update 变量存储新更新的值。

[pure virtual slot] void QGeoPositionInfoSource::requestUpdate(int timeout = 0)

尝试获取当前位置，并利用该信息触发positionUpdated()信号。如果在给定的timeout （以毫秒为单位）内无法找到当前位置，或者timeout 小于minimumUpdateInterval()返回的值，则会触发一个带有UpdateTimeoutError 的errorOccurred()信号。

如果超时时间为零，则超时时间将默认设置为适合该源的合理超时周期。

如果另一个更新请求正在进行中，则此操作不会产生任何效果。但是，即使已经调用了startUpdates() 且常规更新正在进行中，也可以调用此函数。

如果源使用多种定位方法，它将尝试在给定的超时时间内从最精确的定位方法中获取当前位置。

[virtual, since Qt 5.14] bool QGeoPositionInfoSource::setBackendProperty(const QString &name, const QVariant &value)

将名为name 的后端特定属性设置为value 。成功时返回true ，否则返回false 。后端特定属性可用于在运行时配置定位子系统的行为。支持的后端特定属性及其说明详见Qt Positioning plugins#Default plugins。

该函数于 Qt 5.14 中引入。

另请参阅 backendProperty 。

[pure virtual slot] void QGeoPositionInfoSource::startUpdates()

开始按setUpdateInterval()中指定的间隔定期发布更新。

如果尚未调用setUpdateInterval()，源将在更新一经可用时立即发出更新。

如果该QGeoPositionInfoSource 子类确定无法提供定期更新，则会发出带有UpdateTimeoutError 的errorOccurred() 信号。这可能发生在卫星定位丢失或检测到硬件错误的情况下。如果后续数据可用，位置更新将重新开始。在定期更新恢复之前，UpdateTimeoutError 错误不会再次发出。

在 iOS 8 及更高版本中，Core Location 框架要求在应用程序的 Info.plist 文件中添加额外条目，键名为 NSLocationAlwaysUsageDescription 或 NSLocationWhenInUseUsageDescription，并包含将在授权提示中显示的字符串。 键 NSLocationWhenInUseUsageDescription 用于在应用处于前台时请求使用位置服务的权限。 键 NSLocationAlwaysUsageDescription 用于请求在应用运行时（包括前台和后台）使用定位服务的权限。如果同时定义了这两个条目，在前台模式下 NSLocationWhenInUseUsageDescription 具有优先级。

[pure virtual slot] void QGeoPositionInfoSource::stopUpdates()

停止按固定间隔发送更新。

[pure virtual] QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::supportedPositioningMethods() const

返回该来源可用的定位方法。可用性是指在调用此函数时可用的状态。因此，诸如关闭定位服务或对基于卫星的定位提供商设置限制等用户设置，都会体现在此函数的返回结果中。当状态发生变化时，可通过supportedPositioningMethodsChanged() 获取运行时通知。

并非所有平台都能区分不同的定位方法，或传达设备的当前用户配置。下表概述了当前各平台的情况：

另请参阅 supportedPositioningMethodsChanged() 和setPreferredPositioningMethods()。

[signal, since Qt 5.12] void QGeoPositionInfoSource::supportedPositioningMethodsChanged()

当支持的定位方法发生变化时，会发出此信号。导致变化的原因可能是用户开启或关闭了定位服务，或者将定位服务限制为特定类型（例如仅限 GPS）。请注意，并非所有平台都能检测到支持的定位方法的变化。supportedPositioningMethods() 提供了当前平台支持情况的概览。

该函数于 Qt 5.12 版本中引入。