Qt Location

Qt Location 모듈을 사용하면 Open Street Map과 같은 주요 위치 서비스 제공업체에서 제공하는 데이터를 활용하여 매핑 솔루션을 구축할 수 있습니다.

Qt Location API를 사용하면 다음을 수행할 수 있습니다.

• 지도 데이터에 접근하고 표시할 수 있습니다.
• 지도상의 특정 영역에서 터치 제스처를 지원합니다.
• 특정 지리적 위치 및 경로를 조회할 수 있습니다.
• 폴리라인이나 원과 같은 추가 레이어를 지도 위에 얹을 수 있습니다.
• 장소 및 관련 이미지를 검색할 수 있습니다.

모듈 사용 방법

QML API

이 타입을 사용하려면 .qml 파일에 다음 import 문을 추가하십시오:

import QtPositioning
import QtLocation

C++ API

C++ 프로젝트의 경우, 현재 사용 사례에 적합한 헤더 파일을 포함해야 합니다. 예를 들어, 경로를 사용하는 애플리케이션은 다음을 사용할 수 있습니다:

#include <QGeoRoute>

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

CMake를 사용한 빌드

find_package() 명령을 사용하여 Qt6 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오:

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

자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.

qmake를 사용한 빌드

qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 모듈을 추가하십시오:

QT += location

하위 모듈

API는 특정 용도에 맞는 QML 및 C++ 인터페이스를 제공하는 서브모듈로 나뉘어 있습니다. 이 모듈들은 주로 지도(Map) 및 장소(Place) 정보에 중점을 둡니다. 필요한 위치 데이터는 QtPositioning 모듈을 사용하여 가져올 수 있습니다.

장소

Places 서브모듈은 Positioning을 자연스럽게 보완하며, 관심 장소(POI)에 대한 지리 데이터 소스를 제공합니다. 소스 정보 외에도 이 API는 POI의 위치, 크기 및 기타 관련 정보를 제공합니다. 또한 Places API를 통해 장소와 관련된 이미지, 리뷰 및 기타 콘텐츠를 가져올 수 있습니다.

지도 및 내비게이션

이 모듈은 지도 및 내비게이션을 위한 QML 및 C++ 구현 방식을 제공합니다. C++ 구현 방식은 지오코딩(주소로부터 지리적 좌표 찾기) 및 내비게이션(운전 및 도보 길찾기 포함) 정보를 가져오는 유틸리티 클래스를 제공하는 반면, QML 구현 방식은 해당 정보를 렌더링하는 UI 컴포넌트를 제공합니다.

예제

API 참조

다음은 이 모듈에서 제공하는 클래스 및 UI 구성 요소 목록과, 그 사용법을 보여주는 예제 애플리케이션입니다:

플러그인 참조 및 매개변수

플러그인에 대한 정보, 사용 시 주의사항, 플러그인의 동작에 영향을 주기 위해 지정할 수 있는 매개변수.

새로운 백엔드 구현 및 포팅

시스템 통합업체 및 유통업체를 위해, Qt Location 을 새로운 플랫폼에서 사용할 수 있도록 하는 데 필요한 정보를 제공합니다.

라이선스

Qt Location Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2에 따라 제공됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.