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 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 모듈은 location 권한을 처리하기 위해 새로운 QPermission API를 사용합니다. 즉, Qt 자체에서는 더 이상 이러한 권한을 조회하지 않으므로, 클라이언트 애플리케이션에서 직접 처리해야 합니다.

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

기사 및 가이드

• C++ 입문 안내
• QML용 위치 지정 소개
• Qt Positioning 플러그인
• Android에서 C++ 및 QML 코드 간의 인터페이스 Qt Positioning
• Qt Positioning Android에서
• Qt Positioning iOS에서
• Qt Positioning 보안 고려 사항

예제

• Qt Positioning 예제

참조

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

모듈의 발전

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

라이선스

Qt Positioning Qt는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, 자유 소프트웨어 라이선스 하에서도 제공됩니다. Qt 5.4부터 이러한 자유 소프트웨어 라이선스는 GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2입니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.