Qt Location

Qt Location モジュールは、Open Street Map などの一般的な位置情報サービスプロバイダから入手可能なデータを使用して、マッピングソリューションを作成するのに役立ちます。

Qt Location APIを使用すると、次のことが可能になります:

  • 地図データへのアクセスと表示
  • 地図データへのアクセスと提示。
  • 特定の地理的な場所やルートを検索する。
  • ポリラインやサークルなどの追加レイヤーの追加。
  • 場所や関連画像の検索

モジュールの使用

QML API

型を使用するには、.qml ファイルに以下の import 文を追加してください:

import QtPositioning
import QtLocation

注: Qt Location QML モジュールの API の多くは、Qt Positioning モジュールの型を使っています。例えば、地図の中心となる座標の定義にはQt Positioning モジュールの型が必要です。

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++のインターフェースを提供しています。これらのモジュールは主に地図と場所の情報に焦点を当てています。必要な位置データはQtPositioning モジュールで取得できます。

場所

PlacesサブモジュールはPositioningを自然に補完するもので、Places of Interest (POI)に関する地理データのソースを提供します。ソース情報の他に、APIはPOIの位置、サイズ、その他の関連情報についての情報を提供します。Places APIは、画像、レビュー、その他の場所に関連するコンテンツを取得することもできます。

Placesの紹介:QML用C++用

地図とナビゲーション

このモジュールは、地図とナビゲーションのためのQMLとC++の代替機能を提供します。C++の選択肢は、ジオコーディング(住所から地理座標を求めること)やナビゲーション(運転や徒歩の案内を含む)情報を取得するためのユーティリティクラスを提供し、QMLの選択肢は情報を表示するためのUIコンポーネントを提供します。

地図とナビゲーションの紹介:QML用C++用

アプリの例Qt Location API の使用例
マップとナビゲーションのチュートリアルQML Maps Typesを紹介するチュートリアル

APIリファレンス

以下は、モジュールが提供するクラスとUIコンポーネントのリストと、その使い方を示すサンプルアプリケーションです:

QML API ReferenceQt Location API の QML コンポーネントの全リスト
ドメイン別 C++ API リファレンスQt Location API の C++ クラスとメソッドの全リスト(ドメイン順
C++ API ReferenceQt Location API の C++ クラスとメソッドの完全リスト

プラグインの参照とパラメータ

プラグインに関する情報、プラグインの使用に関する重要な注意事項、プラグインの動作に影響を与えるために提供できるパラメータ。

Qt Location Items Overlay Plugin

マップアイテムのオーバーレイレイヤーの背景として使用されることを意図した空のマップを提供します。

Qt Location Open Street Map Plugin

Open Street Mapと関連サービスを使用します。

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

システムインテグレーターやディストリビューター向けに、Qt Location を新しいプラットフォームで利用できるようにするための情報を提供します。

ジオサービスQt Location GeoServices プラグインに関する情報。
場所プレイスバックエンド実装者向けの情報
API の変更Qt 5 から Qt 6 への移植に関する情報

ライセンス

Qt LocationThe Qt Company の商用ライセンスで入手できます。また、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。詳細はQt ライセンスをご覧ください。

© 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.