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 为 true，则返回从卫星定位方法接收到的最后已知位置；如果没有，则返回空更新。

[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 子类认为自己无法提供定期更新，则会发出errorOccurred() 信号（UpdateTimeoutError ）。这可能发生在卫星定位丢失或检测到硬件错误的情况下。如果稍后数据可用，位置更新将重新开始。直到恢复定期更新后，才会再次发生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 中引入。