이 페이지에서

Qt Location QML Types

개요

간단히 말해, 주요 QML 유형과 그 역할은 다음과 같습니다:

  • Place 인스턴스는 표시 가능한 표현을 포함하여 대상 및 주변 객체에 대한 정보를 보유합니다.
  • Map 은 Place 객체에 포함된 정보를 표시하고, 이동(pan), 확대/축소(zoom) 등의 작업을 수행할 수 있게 합니다.
  • route 는 플러그인에 의해 결정되며, 각 routeSegment 는 지속적으로 업데이트되는 현재 Location 에 따라 안내되는 탐색 지침을 보관합니다.

플러그인

Plugin는 경로 및 내비게이션 지침을 계산하는 데 필요한 데이터를 제공하며, 일반적으로 특정 위치 기반 서비스와 연동됩니다. 예를 들어, 플러그인을 통해 지오코딩 및 경로 정보를 제공하는 서비스에 연결할 수 있으며, 애플리케이션에서 해당 정보를 활용할 수 있습니다.

다양한 작업을 위한 여러 GeoServices 플러그인이 있을 수 있으며, 일부 플러그인은 하나 이상의 서비스를 제공합니다. 각 GeoService 플러그인마다 하나의 QML Plugin 인스턴스를 생성해야 합니다. 경로 설정 및 지오코딩, 지도, 장소 기능에는 플러그인이 필요하지만, 기본 플러그인이 이 네 가지 서비스를 모두 처리합니다. 플러그인은 온라인 접속이 필요할 수도 있고, 내장형 지도 및 데이터를 지원할 수도 있습니다.

참고: 플러그인은 페이징이나 관련성 힌트와 같은 기능을 제공하지 않을 수 있습니다.

다음 링크에서 지도 및 장소에 대한 자세한 정보를 확인할 수 있습니다:

지도 및 내비게이션지도 표시 및 경로 찾기
장소관심 장소 검색 및 관리

일반적인 QML 유형

Plugin

Type은 위치 기반 서비스 플러그인을 설명합니다

PluginParameter

플러그인의 매개변수를 설명하는 유형

지도 QML 유형

GeoJsonData

GeoJSON 문서를 표현, 불러오기 및 저장하기 위한 모델

Map

지도를 표시하는 타입

MapCircle

Type은 지도에 지리적 원을 표시합니다

MapCopyrightNotice

Item은 지도 요소에 대한 현재 유효한 저작권 고지문을 표시합니다

MapItemGroup

지도 항목을 담는 컨테이너인 타입

MapItemView

모델에서 지도를 채우는 데 사용됩니다

MapPolygon

타입은 지도에 다각형을 표시합니다

MapPolyline

Type은 지도에 폴리라인을 표시합니다

MapQuickItem

이 타입은 지도에 임의의 Qt Quick 객체를 표시합니다

MapRectangle

Type은 지도에 사각형을 표시합니다

MapRoute

이 유형은 지도에 경로를 표시합니다

cameraCapabilities

Type은 특정 지도 유형에 대한 카메라 기능 정보를 보유합니다

mapType

이 타입은 지도 유형에 대한 정보를 보유합니다

RouteModel

Type은 경로에 대한 액세스를 제공합니다

RouteQuery

Type은 RouteModel에 쿼리 매개변수를 제공하는 데 사용됩니다

route

Type은 하나의 지리적 경로를 나타냅니다

routeManeuver

Type은 두 routeSegment가 만나는 지점과 관련된 정보를 나타냅니다

routeSegment

이 타입은 경로(Route)의 한 세그먼트를 나타냅니다

지오코딩 QML 타입

GeocodeModel

Type은 지리 정보와 관련된 검색 작업을 지원합니다

장소(Places) QML 유형

Category

Type은 Place가 연관될 수 있는 범주를 나타냅니다

CategoryModel

Type은 플러그인에서 지원하는 범주의 모델을 제공합니다

ContactDetails

Type은 Place의 연락처 정보를 포함합니다

EditorialModel

Type은 장소 관련 편집 내용을 위한 모델을 제공합니다

ExtendedAttributes

'Type'은 장소에 대한 추가 데이터를 포함합니다

ImageModel

'Type'은 장소 이미지에 대한 모델을 제공합니다

Place

Type은 주목할 만한 위치인 장소를 나타냅니다

PlaceSearchModel

장소 검색 결과에 대한 접근을 제공합니다

PlaceSearchSuggestionModel

검색어 제안에 대한 접근을 제공합니다

ReviewModel

'Type'은 장소 리뷰에 대한 모델을 제공합니다

contactDetail

'유형'은 전화번호나 웹사이트 주소와 같은 연락처 정보를 포함합니다

icon

'Type'은 장소의 아이콘을 나타냅니다

placeAttribute

이 타입은 일반적인 장소 속성 정보를 포함합니다

ratings

'Type'은 장소의 평점 정보를 저장합니다

supplier

장소의 제공자, 장소 이미지, 리뷰 또는 편집 콘텐츠에 관한 데이터를 저장합니다

user

이 유형은 특정 장소 콘텐츠 항목을 제공한 사용자를 식별합니다

모든 QML 유형의 알파벳순 목록

Category

타입은 장소가 연관될 수 있는 카테고리를 나타냅니다

CategoryModel

'Type'은 플러그인이 지원하는 카테고리의 모델을 제공합니다

ContactDetails

'Type'은 장소의 연락처 정보를 포함합니다.

EditorialModel

Type은 장소 관련 편집 콘텐츠의 모델을 제공합니다

ExtendedAttributes

타입은 장소에 대한 추가 데이터를 포함합니다

GeoJsonData

GeoJSON 문서를 표현, 불러오기 및 저장하기 위한 모델

GeocodeModel

Type은 지리 정보와 관련된 검색 작업을 지원합니다

ImageModel

Type은 장소 이미지에 대한 모델을 제공합니다

Map

Type은 지도를 표시합니다

MapCircle

Type은 지도에 지리적 원을 표시합니다

MapCopyrightNotice

Item은 Map 요소에 대한 현재 유효한 저작권 고지를 표시합니다

MapItemGroup

Type은 지도 항목을 담는 컨테이너입니다

MapItemView

모델에서 지도를 채우는 데 사용됩니다

MapPolygon

타입은 지도에 다각형을 표시합니다

MapPolyline

Type은 지도에 폴리라인을 표시합니다

MapQuickItem

이 타입은 지도에 임의의 Qt Quick 객체를 표시합니다

MapRectangle

Type은 지도에 사각형을 표시합니다

MapRoute

이 타입은 지도에 경로를 표시합니다

MapView

대화형 지도 뷰어 컴포넌트

Place

이 유형은 관심 지점을 나타냅니다

PlaceSearchModel

장소 검색 결과에 대한 액세스를 제공합니다

PlaceSearchSuggestionModel

검색어 제안 기능을 제공합니다

Plugin

Type은 위치 기반 서비스 플러그인을 설명합니다

PluginParameter

'Type'은 플러그인의 매개변수를 나타냅니다

ReviewModel

Type은 장소 리뷰 모델을 제공합니다

RouteModel

Type은 경로에 대한 액세스를 제공합니다

RouteQuery

이 타입은 RouteModel에 쿼리 매개변수를 제공하는 데 사용됩니다

cameraCapabilities

Type은 특정 지도 유형에 대한 카메라 기능 정보를 포함합니다

contactDetail

Type은 전화번호나 웹사이트 주소와 같은 연락처 세부 정보를 포함합니다

icon

Type은 장소의 아이콘을 나타냅니다

mapType

Type은 지도 유형에 대한 정보를 포함합니다

placeAttribute

Type은 일반적인 장소 속성 정보를 포함합니다

ratings

'Type'은 장소 평점 정보를 포함합니다

route

Type은 하나의 지리적 경로를 나타냅니다

routeManeuver

Type은 두 routeSegment가 만나는 지점과 관련된 정보를 나타냅니다

routeSegment

Type은 경로(Route)의 한 세그먼트를 나타냅니다

supplier

장소의 제공자, 장소의 이미지, 리뷰 또는 편집 내용에 관한 데이터를 포함합니다

user

'유형'은 특정 장소 콘텐츠 항목을 제공한 사용자를 식별합니다

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