Qt Positioning

Qt Positioning API 通过 QML 和 C++ 接口提供位置信息。

目前，API 在 Android、iOS、macOS、Linux 和 Windows（GPS 接收器以串口形式暴露，提供 NMEA 句或使用 Windows.Devices.Geolocation）上得到支持。

概览

Qt Positioning API 允许您通过多种可能的来源（包括卫星、Wi-Fi 或文本文件）来确定位置。然后可以用来确定地图上的位置。此外，您可以使用此 API 检索卫星信息并执行基于区域的监控。

使用模块

QML API

模块的 QML 类型可通过 QtPositioning 导入获取。要使用这些类型，请将以下导入语句添加到您的 .qml 文件中

import QtPositioning

C++ API

使用 Qt 模块的 C++ API 需要将模块库链接到项目中，无论是直接链接还是通过其他依赖项。一些构建工具都为此提供了专门的支持，包括 CMake 和 qmake。

使用 CMake 构建

使用 find_package() 命令在 Qt6 套件中查找所需的模块组件

find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)

有关更多详细信息，请参阅 使用 CMake 构建 概览。

使用 qmake 构建

要使用 qmake 构建 配置模块，请将模块作为 QT 变量的一个值添加到项目的 .pro 文件中

QT += positioning

权限

从 Qt 6.6 开始，Qt Positioning 模块使用新的 QPermission API 处理 位置 权限。这意味着 Qt 本身不再查询这些权限，因此需要在客户端应用程序中直接完成此操作。

有关如何将新的 QPermission API 集成到应用程序中的示例，请参阅 应用程序权限 页面。

文章和指南

• C++ 位置介绍
• QML 位置介绍
• Qt Positioning 插件
• Qt Positioning 中 C++ 和 QML 代码之间的接口
• Qt Positioning on Android
• Qt Positioning on iOS

示例

• Qt Positioning 示例

参考

• Qt Positioning C++ 类
• Qt Positioning QML 类型

模块演进

Qt位置变化 列出了为Qt 6系列Qt所做的模块API和功能的重要更改。

许可证

Qt位置可在Qt公司的商业许可证下获得。此外，它还可在免费软件许可证下获得。从Qt 5.4起，这些免费软件许可证是 GNU通用公共许可证（LGPL）版本3，或 GNU通用公共许可证（GPL）版本2。有关更多信息，请参阅Qt许可证。