Qt Positioning Plugin Android

Vue d'ensemble

Le plugin Android Qt Positioning intègre les API natives d'Android et permet d'accéder aux informations de positionnement et de satellite.

Le plugin peut être chargé en utilisant le nom du fournisseur android.

Paramètres

Le tableau suivant répertorie les paramètres qui peuvent être transmis au plugin Android.

Conversion de l'altitude

Android fournit traditionnellement l'altitude au-dessus de l'ellipsoïde de référence du Système géodésique mondial 1984 (WGS84). Cependant, à partir d'Android 14, une nouvelle classe AltitudeConverter a été introduite. Cette classe permet de convertir l'altitude WGS84 en altitude au-dessus du niveau moyen de la mer (MSL).

Si le paramètre du plugin useMslAltitude est défini sur true et que l'application fonctionne sous Android 14 ou une version ultérieure, le composant QGeoCoordinate::altitude des objets QGeoPositionInfo récupérés lors des mises à jour de position contiendra l'altitude MSL.

Exemples de mise à jour de la position

Les exemples suivants montrent comment créer un site android PositionSource à partir de C++ et de QML.

QML

L'extrait suivant crée un site PositionSource sans aucun paramètre. L'altitude sera indiquée au format WGS84.

PositionSource {
    name: "android"
}

L'extrait suivant ajoute explicitement le useMslAltitude PluginParameter et définit sa valeur à true. Ce PositionSource indiquera l'altitude au format MSL.

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

C++

L'extrait suivant montre comment utiliser C++ pour créer un site position source qui indique l'altitude au format MSL.

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