이 페이지에서

Qt Positioning Android 플러그인

개요

Qt Positioning 안드로이드 플러그인은 네이티브 안드로이드 API를 래핑하여 위치 정보 및 위성 정보에 대한 액세스를 제공합니다.

이 플러그인은 android라는 제공자 이름을 사용하여 로드할 수 있습니다.

매개변수

다음 표에는 Android 플러그인에 전달할 수 있는 매개변수가 나열되어 있습니다.

매개 변수설명
useMslAltitude이 매개변수는 Qt 6.8에서 도입되었습니다. 이 매개변수는 플러그인이 평균 해수면(MSL)을 기준으로 한 고도를 제공할지 여부를 결정합니다. 기본값은 ` false`이며, 이는 WGS84 형식의 고도를 제공함을 의미합니다. 이 매개변수는 Android 14 이상 버전에서만 적용됩니다. 자세한 내용은 ‘고도 변환’ 섹션을 참조하십시오.

고도 변환

Android는 전통적으로 세계 측지 시스템 1984(WGS84) 기준 타원체를 기준으로 한 고도를 제공해 왔습니다. 그러나 Android 14부터 새로운 AltitudeConverter 클래스가 도입되었습니다. 이 클래스를 사용하면 WGS84 고도를 평균 해수면(MSL) 기준 고도로 변환할 수 있습니다.

useMslAltitude 플러그인 매개변수가 ` true`로 설정되어 있고, 애플리케이션이 Android 14 이상에서 실행 중인 경우, 위치 업데이트 중에 가져온 ` QGeoPositionInfo ` 객체의 ` QGeoCoordinate::altitude ` 컴포넌트에는 MSL 고도가 포함됩니다.

참고: Android 문서에따르면 , MSL 고도로의 변환에는 몇 초가 소요될 수 있습니다. 이는 해당 메서드가 동기식이기 때문에, 이 기능이 활성화되었을 때 lastKnownPosition() 요청의 실행 시간이 더 길어질 수 있음을 의미합니다. 다른 위치 업데이트 요청에는 영향을 미치지 않습니다.

예제

다음 예제는 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);

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