Qt Positioning

Qt Positioning API는 QML 및 C++ 인터페이스를 통해 위치 정보를 제공합니다.

현재 이 API는 Android, iOS, macOS, Linux 및 Windows에서 지원됩니다(GPS 수신기가 직렬 포트로 노출되어 NMEA 문장을 제공하거나 Windows.Devices.Geolocation)에서 사용할 수 있습니다.

개요

Qt Positioning API를 사용하면 위성, Wi-Fi 또는 텍스트 파일 등 다양한 소스를 사용하여 위치를 파악할 수 있습니다. 그런 다음 해당 정보를 사용하여 예를 들어 지도에서 위치를 확인할 수 있습니다. 또한 API를 사용하여 위성 정보를 검색하고 지역 기반 모니터링을 수행할 수 있습니다.

모듈 사용하기

QML API

모듈의 QML 유형은 QtPositioning 가져오기를 통해 사용할 수 있습니다. 해당 유형을 사용하려면 .qml 파일에 다음 import 문을 추가하세요:

import QtPositioning

C++ API

Qt 모듈의 C++ API를 사용하려면 직접 또는 다른 종속성을 통해 모듈 라이브러리에 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 지원합니다.

CMake로 빌드하기

find_package() 명령을 사용하여 Qt6 패키지에서 필요한 모듈 컴포넌트를 찾습니다:

find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)

자세한 내용은 CMake로 빌드 개요를 참조하세요.

qmake로 빌드하기

qmake로 빌드하도록 모듈을 구성하려면 프로젝트의 .pro 파일에 QT 변수의 값으로 모듈을 추가합니다:

QT += positioning

권한

Qt 6.6부터 Qt Positioning 모듈은 새로운 QPermission API를 사용하여 location 권한을 처리합니다. 즉, Qt 자체에서 더 이상 이러한 권한을 쿼리하지 않으므로 클라이언트 애플리케이션에서 직접 수행해야 합니다.

새로운 QPermission API를 애플리케이션에 통합하는 방법에 대한 예는 애플리케이션 권한 페이지를 참조하세요.

문서 및 가이드

• C++용 포지셔닝 소개
• QML용 포지셔닝 소개
• Qt Positioning 플러그인
• C++와 QML 코드 간의 인터페이스 Qt Positioning
• Qt Positioning 안드로이드
• Qt Positioning iOS에서

예제

• Qt Positioning 예제

참조

• Qt Positioning C++ Classes
• Qt Positioning QML Types

모듈 진화

Qt Positioning 의 변경 사항에는 Qt 6 시리즈에 적용된 모듈 API 및 기능의 중요한 변경 사항이 나열되어 있습니다.

라이선스

Qt Positioning 는 Qt Company의 상용 라이선스에 따라 사용할 수 있습니다. 또한 무료 소프트웨어 라이선스로도 사용할 수 있습니다. Qt 5.4부터 이러한 무료 소프트웨어 라이선스는 GNU 약소 일반 공중 사용 허가서 버전 3 또는 GNU 일반 공중 사용 허가서 버전 2입니다. 자세한 내용은 Qt 라이선스를 참조하십시오.