WebEngine 小工具地图示例

演示如何处理地理位置请求。

Maps演示了如何处理来自QWebEnginePage 的地理位置请求。

Geolocation API是一种 JavaScript API，网络应用程序可使用它来确定用户的物理位置，以便在地图上显示。由于Qt WebEngine 依靠 Qt Positioning模块来支持该 API，因此目标平台需要一个可行的定位后端。

为避免向第三方意外发送位置信息，默认情况下拒绝地理位置请求。本示例演示了应用程序开始接受这些请求时必须采取的步骤。

注意： 在 Windows 11 上，启用设置以允许应用程序访问 Windows 定位服务。在Privacy & Security >Location 下的 "设置 "应用程序中，启用Location services 、Let apps access your location 和Let desktop apps access your location 。

运行示例

运行示例 Qt Creator，打开Welcome 模式，然后从Examples 中选择示例。更多信息，请参阅Qt Creator: 教程：构建和运行。

代码

示例程序由一个继承自QMainWindow 的类MainWindow 组成：

#include <QMainWindow>
#include <QWebEngineView>

class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    explicit MainWindow(QWidget *parent = nullptr);

private:
    QWebEngineView *m_view;
};

在构造函数中，我们首先将QWebEngineView 设置为中心部件：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , m_view(new QWebEngineView(this))
{
    setCentralWidget(m_view);

然后，我们将一个 lambda 函数连接到QWebEnginePage::permissionRequested 信号：

    QWebEnginePage *page = m_view->page();

    connect(page, &QWebEnginePage::permissionRequested, [this](QWebEnginePermission permission) {

每当网页请求使用某种功能或设备（不仅包括定位服务，还包括音频捕捉设备或鼠标锁定等）时，就会发出该信号。在本例中，我们只处理定位服务请求：

        if (permission.permissionType() != QWebEnginePermission::PermissionType::Geolocation)
            return;

现在到了我们实际请求用户许可的部分：

        QMessageBox msgBox(this);
        msgBox.setText(tr("%1 wants to know your location").arg(permission.origin().host()));
        msgBox.setInformativeText(tr("Do you want to send your current location to this website?"));
        msgBox.setStandardButtons(QMessageBox::Yes | QMessageBox::No);
        msgBox.setDefaultButton(QMessageBox::Yes);

        if (msgBox.exec() == QMessageBox::Yes)
            permission.grant();
        else
            permission.deny();
    });

请注意，问题中包含了网站 URI 的主机部分（permission.origin() ），以告知用户究竟是哪个网站将接收他们的位置数据。

我们使用QWebEnginePermission::grant() 和QWebEnginePermission::deny() 方法将用户的回答传回网页。

最后，我们要求QWebEnginePage 加载可能要使用位置服务的网页：

    page->load(QUrl(QStringLiteral("https://bing.com/maps")));
}

示例项目 @ code.qt.io

另请参见 Qt WebEngine HTML5 地理定位。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.