Qt Location

Qt Location モジュールを使用すると、OpenStreetMapなどの主要な位置情報サービスプロバイダーから入手可能なデータを利用して、マッピングソリューションを構築することができます。

Qt Location API を使用すると、以下のことが可能になります：

• 地図データへのアクセスおよび表示。
• 地図上の特定の領域でのタッチジェスチャーに対応する。
• 特定の地理的位置やルートを検索する。
• ポリラインや円などのレイヤーを追加する。
• 場所や関連画像を検索する。

モジュールの使用方法

QML API

これらの型を使用するには、.qml ファイルに以下のインポート文を追加してください：

import QtPositioning
import QtLocation

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

QT += location

サブモジュール

APIはサブモジュールに分割されており、特定の目的のためのQMLおよびC++インターフェースを提供します。これらは主にMapおよびPlaceの情報に焦点を当てています。必要な位置データは、QtPositioning モジュールを使用して取得できます。

場所

Placesサブモジュールは、Positioningを自然に補完するものであり、注目地点（POI）に関する地理データのソースを提供します。ソース情報に加え、このAPIはPOIの位置、サイズ、およびその他の関連情報も提供します。また、Places APIでは、場所に関連する画像、レビュー、その他のコンテンツも取得できます。

マップとナビゲーション

このモジュールは、地図およびナビゲーション機能のQML版とC++版を提供します。C++版では、ジオコーディング（住所から地理座標を特定すること）やナビゲーション（車や徒歩での経路案内を含む）情報を取得するためのユーティリティクラスを提供し、一方、QML版では、その情報を表示するためのUIコンポーネントを提供します。

サンプル

APIリファレンス

以下は、このモジュールが提供するクラスおよび UI コンポーネントの一覧と、その使用方法を示すサンプルアプリケーションです。

プラグインのリファレンスとパラメータ

プラグインに関する情報、その使用上の重要な注意事項、および動作を制御するために指定できるパラメータ。

新しいバックエンドの実装と移植

システムインテグレーターおよび販売代理店向けに、Qt Location を新しいプラットフォームで利用可能にするための情報を提供します。

ライセンス

Qt Location は、The Qt Company からの商用ライセンスの下で利用可能です。さらに、GNU Lesser General Public License バージョン 3 またはGNU General Public License バージョン 2 の下でも利用可能です。詳細については、「Qt ライセンス」を参照してください。