Qt Location

Qt Location 모듈은 오픈스트리트맵과 같은 인기 있는 위치 서비스 제공업체에서 제공하는 데이터를 사용하여 매핑 솔루션을 만들 수 있도록 도와줍니다.

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

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

모듈 사용

QML API

유형을 사용하려면 .qml 파일에 다음 가져오기 문을 추가합니다:

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++ 인터페이스를 제공하는 하위 모듈로 나뉩니다. 주로 지도와 장소 정보에 중점을 둡니다. 필요한 위치 데이터는 QtPositioning 모듈을 사용하여 검색할 수 있습니다.

장소

장소 하위 모듈은 포지셔닝을 자연스럽게 보완하는 모듈로, 관심 장소(POI)에 대한 지리적 데이터 소스를 제공합니다. 소스 정보 외에도 API는 위치, 크기 및 기타 관련 정보에 대한 정보를 POI에 제공합니다. 장소 API는 장소와 관련된 이미지, 리뷰 및 기타 콘텐츠도 검색할 수 있습니다.

지도 및 내비게이션

이 모듈은 지도 및 내비게이션에 대한 QML 및 C++ 대안을 제공합니다. C++ 대안은 지오코딩(도로 주소에서 지리적 좌표 찾기) 및 내비게이션(운전 및 도보 경로 포함) 정보를 얻기 위한 유틸리티 클래스를 제공하는 반면, QML 대안은 정보를 렌더링하는 UI 컴포넌트를 제공합니다.

예제

API 참조

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

플러그인 참조 및 매개변수

플러그인에 대한 정보, 사용법에 대한 중요한 참고 사항, 플러그인의 동작에 영향을 주기 위해 제공할 수 있는 매개변수.

새로운 백엔드 구현 및 포팅

시스템 통합업체 및 배포업체의 경우 새 플랫폼에서 Qt Location 을 사용할 수 있도록 만드는 것과 관련된 정보입니다.

라이선스

Qt Location 는 Qt Company의 상용 라이선스에 따라 사용할 수 있습니다. 또한 GNU 약소 일반 공중 사용 허가서 버전 3 또는 GNU 일반 공중 사용 허가서 버전 2에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.