En esta página

Qt Positioning Complemento para Android

Descripción general

El complemento de Android « Qt Positioning » integra las API nativas de Android y proporciona acceso a la información de posicionamiento y de satélites.

El complemento se puede cargar utilizando el nombre de proveedor «android».

Parámetros

En la siguiente tabla se enumeran los parámetros que se pueden pasar al complemento para Android.

ParámetroDescripción
useMslAltitudeEste parámetro se introdujo en Qt 6.8. Determina si el complemento intentará proporcionar una altitud por encima del nivel medio del mar (MSL). El valor por defecto es « false », lo que significa que proporciona la altitud en formato WGS84. Este parámetro solo es relevante para Android 14 y versiones posteriores. Consulta la sección «Conversión de altitud» para obtener más detalles.

Conversión de altitud

Tradicionalmente, Android proporciona la altitud sobre el elipsoide de referencia del Sistema Geodésico Mundial de 1984 (WGS84). Sin embargo, a partir de Android 14, se introdujo una nueva clase llamada `AltitudeConverter`. Esta clase permite convertir la altitud WGS84 al formato de altitud sobre el nivel medio del mar (MSL).

Si el parámetro del complemento ` useMslAltitude ` se establece en ` true` y la aplicación se ejecuta en Android 14 o versiones posteriores, el componente ` QGeoCoordinate::altitude ` de los objetos ` QGeoPositionInfo ` recuperados durante las actualizaciones de posición contendrá la altitud MSL.

Nota: Según la documentación de Android, la conversión a la altitud MSL puede tardar varios segundos. Esto significa que las solicitudes de ` lastKnownPosition()` pueden tardar más en ejecutarse cuando esta función está activada, ya que el método es síncrono. El resto de solicitudes de actualización de posición no se ven afectadas.

Ejemplos

Los siguientes ejemplos muestran cómo crear un objeto ` PositionSource ` de Android desde C++ y QML.

QML

El siguiente fragmento de código crea un « PositionSource » sin parámetros. La altitud se indicará en formato WGS84.

PositionSource {
    name: "android"
}

El siguiente fragmento de código añade explícitamente el ` useMslAltitude ` ` PluginParameter ` y establece su valor en ` true`. Este ` PositionSource ` indicará la altitud en formato MSL.

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

C++

El siguiente fragmento de código muestra cómo utilizar C++ para crear un « position source » que indique la altitud en formato MSL.

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

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