Qt Positioning Androidプラグイン

概要

Qt Positioning のAndroidプラグインは、AndroidのネイティブAPIをラップし、位置情報や衛星情報へのアクセスを提供します。

このプラグインは、プロバイダ名「android」を使用して読み込むことができます。

パラメータ

以下の表は、Android プラグインに渡すことができるパラメータの一覧です。

高度の変換

Androidでは従来、世界測地系1984（WGS84）基準楕円体からの高度が提供されてきました。しかし、Android 14以降、新しいAltitudeConverterクラスが導入されました。このクラスを使用すると、WGS84形式の高度を平均海面（MSL）からの高度形式に変換することができます。

useMslAltitude プラグインのパラメータがtrue に設定されており、アプリケーションがAndroid 14以降で実行されている場合、位置情報の更新中に取得されるQGeoPositionInfo オブジェクトのQGeoCoordinate::altitude コンポーネントには、MSL高度が含まれます。

例

以下の例は、C++ および QML からAndroid版 `PositionSource ` を作成する方法を示しています。

QML

以下のコードスニペットは、パラメータを指定せずに `PositionSource ` を作成します。高度は WGS84 形式で報告されます。

PositionSource {
    name: "android"
}

次のスニペットでは、useMslAltitude PluginParameter を明示的に追加し、その値をtrue に設定しています。このPositionSource は、高度を MSL 形式で報告します。

PositionSource {
    name: "android"
    PluginParameter {
        name: "useMslAltitude"
        value: true
    }
}

C++

以下のスニペットは、C++ を使用して、高度を MSL 形式で報告する `position source ` を作成する方法を示しています。

QVariantMap params;
params["useMslAltitude"] = true;
QGeoPositionInfoSource *positionSource = QGeoPositionInfoSource::createSource("android", params, this);