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 を使用してモジュールをビルドするように設定するには、プロジェクトの .pro ファイル内の `QT ` 変数の値としてモジュールを追加します:

QT += positioning

権限

Qt 6.6以降、Qt Positioning モジュールは、location の権限処理に新しいQPermission APIを使用します。これにより、Qt自体がこれらの権限を照会しなくなったため、クライアントアプリケーション側から直接行う必要があります。

新しいQPermission APIをアプリケーションに組み込む方法の例については、「アプリケーションの権限」のページを参照してください。

記事とガイド

• C++ 向けポジショニング入門
• QML 向けポジショニング入門
• Qt Positioning プラグイン
• Android における C++ と QML コード間のインターフェースQt Positioning
• Qt Positioning Android上
• Qt Positioning iOS上でのコード
• Qt Positioning セキュリティ上の考慮事項

例

• Qt Positioning 例

リファレンス

• Qt Positioning C++ Classes
• Qt Positioning QML Types

モジュールの進化

「Qt Positioning 」には、Qt 6 シリーズ向けに実施された、モジュールの API および機能に関する重要な変更点が記載されています。

ライセンス

Qt Positioning は、The Qt Company から商用ライセンスで提供されています。さらに、フリーソフトウェアライセンスでも提供されています。Qt 5.4 以降、これらのフリーソフトウェアライセンスは、GNU Lesser General Public License バージョン 3 またはGNU General Public License バージョン 2 です。詳細については、「Qt ライセンス」を参照してください。