PySide6.QtLocation¶

使用模块¶

QML API¶

要使用这些类型，请将以下导入语句添加到您的.qml文件中：

C++ API¶

对于C++项目，包含适用于当前用例的头文件；例如，使用路由的应用程序可能使用：

#include <QGeoRoute>

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

使用CMake构建¶

使用 find_package() 命令在 Qt6 包中定位所需的模块组件：

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

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

使用qmake构建¶

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

QT += location

子模块¶

API被分为子模块，这些子模块为特定目的提供QML和C++接口。它们主要关注地图和地点信息。所需的位置数据可以使用QtPositioning模块获取。

地点¶

Places子模块是Positioning的自然补充，提供了关于兴趣点（POI）的地理数据来源。除了来源信息外，API还提供了关于POI的位置、大小和其他相关信息的信息。Places API还可以检索与地点相关的图像、评论和其他内容。

地点介绍：

for QML

for C++

地图和导航¶

该模块为地图和导航提供了QML和C++的替代方案。C++替代方案提供了实用类来获取地理编码（从街道地址查找地理坐标）和导航（包括驾驶和步行方向）信息，而其QML对应部分则提供了用于呈现信息的UI组件。

地图和导航介绍：

for QML

for C++

示例¶

Example Apps	展示如何使用Qt Location API的示例
地图和导航教程	介绍QML地图类型的教程

API参考¶

以下是模块提供的类和UI组件的列表，以及展示它们用法的示例应用程序：

QML API Reference	Qt Location API 中 QML 组件的完整列表
C++ API 参考按领域分类	按领域分类的 Qt Location API 的 C++ 类和方法完整列表
C++ API 参考	Qt 位置 API 的完整 C++ 类和方法列表

插件参考和参数¶

关于插件的信息，使用它们时的重要注意事项，以及可以提供的参数以影响它们的行为。

Qt-Location-Items-Overlay-Plugin	提供一个空地图，旨在用作地图项目覆盖层的背景。
Qt-Location-Open-Street-Map-Plugin	使用Open Street Map及相关服务。

实现新的后端和移植¶

对于系统集成商和分销商，有关使Qt Location可用于新平台的信息。

GeoServices	关于Qt位置地理服务插件的信息
地点	地点后端实现者的信息
API 变更	关于从 Qt 5 移植到 Qt 6 的信息

许可证¶

Qt Location 可从 Qt 公司获得商业许可。此外，它还可在 GNU 宽通用公共许可证第 3 版或 GNU 通用公共许可证第 2 版下使用。有关更多详细信息，请参阅 Qt 许可。

该模块还提供了QML类型。