Plugin QML Type

플러그인 유형은 위치 기반 서비스 플러그인에 대해 설명합니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

속성

방법

상세 설명

플러그인 유형은 위치 API의 다양한 작업에 사용할 사용 가능한 위치 서비스 플러그인을 선언적으로 지정하는 데 사용됩니다. 플러그인은 Map, RouteModel, GeocodeModel 유형 및 기타 다양한 유형에서 사용됩니다.

시스템에서 인식되는 플러그인에는 일반적으로 플러그인이 데이터를 검색하는 서비스의 이름을 나타내는 간단한 문자열인 name 속성이 있습니다. 또한 supportsRouting(), supportsGeocoding(), supportsMapping(), supportsPlaces() 및 supportsNavigation() 메서드를 사용하여 테스트할 수 있는 다양한 기능을 가지고 있습니다.

플러그인 객체가 생성되면 실제 서비스 플러그인과 연결되지 않고 "분리"됩니다. name , preferred 또는 required 속성을 설정하여 정보를 수신하면 연결할 적절한 서비스 플러그인을 선택합니다. 플러그인 객체는 한 번만 연결할 수 있으며, 여러 플러그인을 사용하려면 여러 플러그인 객체를 생성하세요.

사용 예

다음 스니펫은 requiredpreferred 속성이 설정된 플러그인 객체를 만드는 과정을 보여줍니다. 이 플러그인은 매핑과 지오코딩을 모두 지원하는 첫 번째로 발견된 플러그인에 첨부되며, 다른 플러그인보다 "here" 또는 "osm"이라는 이름의 플러그인을 선호합니다.

Plugin {
    id: plugin
    preferred: ["here", "osm"]
    required: Plugin.AnyMappingFeatures | Plugin.AnyGeocodingFeatures
}

속성 문서

allowExperimental : bool

이 속성은 실험용 플러그인을 사용할 수 있는지 여부를 나타냅니다.


availableServiceProviders : stringlist

이 속성에는 사용 가능한 모든 서비스 플러그인 이름 목록이 들어 있습니다. namerequired 에서 제공하는 컨트롤이 사용자의 필요에 충분하지 않은 경우 사용 가능한 플러그인을 수동으로 열거하는 데 사용할 수 있습니다.


isAttached : bool

이 속성은 플러그인 항목이 위치정보 서비스 공급자 플러그인에 연결되어 있는지 여부를 나타냅니다.


locales : stringlist

이 속성에는 기본 설정 플러그인 로캘의 정렬된 목록이 포함되어 있습니다. 첫 번째 로캘을 수용할 수 없는 경우 백엔드는 두 번째 로캘을 사용하는 식으로 돌아가게 됩니다. 기본적으로 locales 속성에는 시스템 로캘이 포함됩니다.

로캘은 "language[_script][_country]" 또는 "C" 형식의 문자열로 지정되며, 여기서 언어는 소문자입니다:

  • language는 소문자, 두 글자로 된 ISO 639 언어 코드입니다,
  • 스크립트는 대문자, 4글자, ISO 15924 스크립트 코드입니다,
  • 국가는 대문자, 두 글자 또는 세 글자, ISO 3166 국가 코드(유엔에서 정의한 "419"도 포함)입니다,
  • "C" 로캘은 다음과 같이 영어/미국과 동작이 동일합니다. QLocale

처음 지정된 로캘을 수용할 수 없는 경우 Plugin 이 다음 로캘로 넘어가는 식으로 동작합니다. 일부 Plugin 백엔드는 엄격하게 정의된 로캘 집합을 지원하지 않을 수 있습니다. 임의의 예를 들어 프랑스의 일부 Place 에는 프랑스어와 영어 로캘이 있을 수 있지만 미국의 특정 지역에서는 영어 로캘만 사용할 수 있습니다. 위의 시나리오에서 지원되는 로캘 세트는 검색 위치에 따라 상황에 따라 달라집니다.

Plugin 에서 선호하는 로캘을 수용할 수 없는 경우 관리자는 백엔드별로 지원되는 언어를 사용하게 됩니다.

로캘을 지원하지 않는 Plugin 의 경우 로캘 목록은 항상 비어 있습니다.

다음 코드는 단일 및 다중 로캘을 설정하는 방법을 보여줍니다:

//single locale
Plugin {
    locales: "en_US"
}

//multiple locales
Plugin {
    locales: ["fr_FR","en_US"]
}

name : string

이 속성은 플러그인의 이름을 보유합니다. 이 속성을 설정하면 플러그인이 정확히 이 이름을 가진 플러그인에만 연결됩니다. required 값은 무시됩니다.


parameters : list<PluginParameter> [default]

이 속성은 플러그인 매개변수 목록을 보유합니다.


preferred : stringlist

이 속성에는 기본 설정 플러그인 이름의 정렬된 목록이 포함되어 있으며, 사용 가능한 다른 플러그인을 확인하기 전에 required 에 설정된 필수 기능이 있는지 확인합니다.


required : enumeration

이 속성에는 연결할 서비스 플러그인을 선택할 때 플러그인 객체에 필요한 기능 집합이 포함되어 있습니다. name 속성이 설정되어 있으면 이 속성은 아무런 영향을 미치지 않습니다.

다음 값 중 하나 또는 여러 값을 비트 단위로 조합하여 설정할 수 있습니다:

  • Plugin.NoFeatures
  • 플러그인.지오코딩 기능
  • 플러그인.리버스 지오코딩 기능
  • 플러그인.라우팅 기능
  • 플러그인.매핑 기능
  • 플러그인.애니플레이스 기능

메서드 문서

bool supportsGeocoding(GeocodingFeatures features)

이 메서드는 지정된 features 세트가 지오 서비스 공급자 플러그인에서 지원되는지 여부를 나타내는 부울을 반환합니다. 지정된 features 가 모두 지원되면 True 이 반환되고, 그렇지 않으면 false 이 반환됩니다.

features 매개변수는 임의의 플래그 조합일 수 있습니다:

기능설명
Plugin.NoGeocodingFeatures지오코딩 기능이 지원되지 않습니다.
플러그인.온라인 지오코딩 기능온라인 지오코딩이 지원됩니다.
Plugin.오프라인 지오코딩 기능오프라인 지오코딩이 지원됩니다.
플러그인.리버스 지오코딩 기능리버스 지오코딩이 지원됩니다.
플러그인.현지화된 지오코딩 기능지역화된 주소로 지오코딩 결과 반환을 지원합니다.
플러그인.애니 지오코딩 기능모든 지오코딩 기능을 제공하는 지오코딩 서비스 제공업체를 일치시킵니다.

bool supportsMapping(MappingFeatures features)

이 메서드는 지정된 features 집합이 지오코딩 서비스 공급자 플러그인에서 지원되는지 여부를 나타내는 부울을 반환합니다. 지정된 features 이 모두 지원되면 참이 반환되고, 그렇지 않으면 거짓이 반환됩니다.

features 매개 변수는 임의의 플래그 조합일 수 있습니다:

기능설명
Plugin.NoMappingFeatures매핑 기능이 지원되지 않습니다.
플러그인.온라인매핑기능온라인 매핑이 지원됩니다.
Plugin.OfflineMappingFeature오프라인 매핑이 지원됩니다.
Plugin.LocalizedMappingFeature현지화된 지도 데이터 반환을 지원합니다.
플러그인.애니매핑 기능모든 매핑 기능을 제공하는 지리 서비스 제공업체를 일치시킵니다.

bool supportsNavigation(NavigationFeatures features)

이 메서드는 지정된 features 집합이 지리적 서비스 공급자 플러그인에서 지원되는지 여부를 나타내는 부울을 반환합니다. 지정된 features 가 모두 지원되면 참이 반환되고, 그렇지 않으면 거짓이 반환됩니다.

features 매개 변수는 임의의 플래그 조합일 수 있습니다:

기능설명
Plugin.NoNavigationFeatures탐색 기능이 지원되지 않습니다.
플러그인.온라인 내비게이션 기능온라인 내비게이션이 지원됩니다.
Plugin.OfflineNavigationFeature오프라인 내비게이션이 지원됩니다.
Plugin.AnyNavigationFeatures내비게이션 기능을 제공하는 지리적 서비스 제공업체를 일치시킵니다.

bool supportsPlaces(PlacesFeatures features)

이 메서드는 지정된 features 집합이 지리적 서비스 공급자 플러그인에서 지원되는지 여부를 나타내는 부울을 반환합니다. 지정된 features 이 모두 지원되면 참이 반환되고, 그렇지 않으면 거짓이 반환됩니다.

features 매개 변수는 임의의 플래그 조합일 수 있습니다:

기능설명
플러그인.장소 기능 없음장소 기능이 지원되지 않습니다.
플러그인.온라인플레이스기능온라인 장소가 지원됩니다.
플러그인.오프라인플레이스기능오프라인 장소가 지원됩니다.
플러그인.저장 장소 기능카테고리 저장이 지원됩니다.
플러그인.장소 제거 기능장소 제거 또는 삭제가 지원됩니다.
플러그인.장소추천기능다른 장소와 유사한 추천 장소 검색이 지원됩니다.
플러그인.검색 제안 기능검색 제안 기능이 지원됩니다.
플러그인.현지화된 장소 기능현지화된 장소 데이터 반환을 지원합니다.
플러그인.알림기능장소 및 카테고리 변경 알림이 지원됩니다.
플러그인.장소 일치 기능서로 다른 두 지오 서비스 제공업체의 장소 매칭을 지원합니다.
플러그인.애니플레이스 기능모든 장소 기능을 제공하는 지리적 서비스 제공업체를 일치시킵니다.

bool supportsRouting(RoutingFeatures features)

이 메서드는 지정된 features 집합이 지역 서비스 공급자 플러그인에서 지원되는지 여부를 나타내는 부울을 반환합니다. 지정된 features 이 모두 지원되면 참이 반환되고, 그렇지 않으면 거짓이 반환됩니다.

features 매개 변수는 임의의 플래그 조합일 수 있습니다:

기능설명
플러그인.아니라우팅기능라우팅 기능이 지원되지 않습니다.
플러그인.온라인 라우팅 기능온라인 라우팅이 지원됩니다.
Plugin.오프라인 라우팅 기능오프라인 라우팅이 지원됩니다.
Plugin.LocalizedRoutingFeature현지화된 주소와 지침이 포함된 경로 반환을 지원합니다.
플러그인.경로 업데이트 기능현재 위치를 기반으로 기존 경로를 업데이트하는 기능이 지원됩니다.
플러그인.대체 경로 기능대체 경로 반환을 지원합니다.
플러그인.제외지역경로 기능반환된 경로가 통과해서는 안 되는 지역을 지정하는 기능을 지원합니다.
플러그인.애니라우팅 기능라우팅 기능을 제공하는 지리적 서비스 제공업체를 일치시킵니다.

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