QGeoPositionInfoSource 类

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

成员函数文档

[显式] QGeoPositionInfoSource::QGeoPositionInfoSource(QObject *parent)

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

[虚，无异常] QGeoPositionInfoSource::~QGeoPositionInfoSource()

销毁位置源。

[静态] QStringList QGeoPositionInfoSource::availableSources()

返回一组可用源插件列表。这包括任何当前平台默认的后端插件。

[虚，自Qt 5.14起] QVariant QGeoPositionInfoSource::backendProperty(const QString &name) const

如果存在，返回名称为name的后端特定属性的值。否则，返回的值将是无效的。支持的后端特定属性列在其描述在Qt 定位插件 #默认插件中。

此函数是在Qt 5.14中引入的。

另请参阅setBackendProperty。

[静态] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(QObject *parent)

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

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

[静态，自 Qt 5.14 开始] QGeoPositionInfoSource *QGeoPositionInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

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

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

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

此函数是在Qt 5.14中引入的。

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

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

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

[静态，自 Qt 5.14 开始] QGeoPositionInfoSource *QGeoPositionInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

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

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

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

此函数是在Qt 5.14中引入的。

[纯虚函数] QGeoPositionInfoSource::Error QGeoPositionInfoSource::error() const

返回最后一次发生的错误类型。

[信号] void QGeoPositionInfoSource::errorOccurred(QGeoPositionInfoSource::Error positioningError)

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

[纯虚函数] QGeoPositionInfo QGeoPositionInfoSource::lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const

返回包含最后一次已知位置的更新，如果没有则返回 null 更新。

如果 fromSatellitePositioningMethodsOnly 为 true，则此函数返回从卫星定位方法接收到的最后一个已知位置；如果没有，则返回 null 更新。

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

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

参数 update 包含新更新的值。

[纯虚槽] void QGeoPositionInfoSource::requestUpdate(int timeout = 0)

尝试获取当前位置，并使用该信息发出 positionUpdated() 信号。如果在指定的 timeout（以毫秒为单位）内找不到当前位置，或者 timeout 小于由 minimumUpdateInterval 返回的值，则发出带有 UpdateTimeoutError 的 errorOccurred() 信号。

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

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

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

[虚拟，自 Qt 5.14 起使用] bool QGeoPositionInfoSource::setBackendProperty(const QString &name, const QVariant &value)

将名为 name 的后端特定属性设置为 value。如果成功返回 true，否则返回 false。后端特定属性可用于在运行时配置定位子系统的行为。支持的特定于后端的属性列于Qt 位置信息插件#默认插件中。

此函数是在Qt 5.14中引入的。

另请参阅：backendProperty。

[纯虚拟槽] void QGeoPositionInfoSource::startUpdates()

以根据 setUpdateInterval 设置的间隔定期发出更新。

如果没有调用 setUpdateInterval()，则源将在更新变得可用时立即发出更新。

如果此 QGeoPositionInfoSource 子类确定它无法提供定期更新，则将发出 errorOccurred() 信号，其中包含 UpdateTimeoutError。这可能发生在丢失卫星修复或检测到硬件错误的情况下。如果稍后数据变得可用，则将重新启动位置更新。在定期更新恢复后，将再次发射 UpdateTimeoutError 错误。

在 iOS 上，从版本 8 开始，Core Location 框架需要在应用程序的 Info.plist 中添加额外的条目，键为 NSLocationAlwaysUsageDescription 或 NSLocationWhenInUseUsageDescription，并在授权提示中显示一个字符串。键 NSLocationWhenInUseUsageDescription 用于在应用程序处于前台时请求使用位置服务的权限。键 NSLocationAlwaysUsageDescription 用于在应用程序运行时请求使用位置服务的权限（既包括前台也包括后台）。如果都定义了这两个条目，则 NSLocationWhenInUseUsageDescription 在前台模式下具有优先级。

[纯虚拟槽] void QGeoPositionInfoSource::stopUpdates()

停止以固定间隔发出更新。

[纯虚拟] QGeoPositionInfoSource::PositioningMethods QGeoPositionInfoSource::supportedPositioningMethods() const

返回此源可用的定位方法。可用性定义为在调用此函数时可供使用。因此，用户设置（如关闭位置服务或限制卫星定位提供商）也会通过此函数反映出来。可以通过supportedPositioningMethodsChanged() 获取状态变化时的运行时通知。

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

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

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

当支持定位方法更改时，会发出此信号。改变的原因可能是用户打开/关闭位置服务或限制位置服务到某些类型（例如，仅GPS）。请注意，并非所有平台都能检测到支持定位方法的变化。supportedPositioningMethods() 提供了当前平台支持的概述。

此函数在 Qt 5.12 中引入。