Plugin QML Type

플러그인 유형은 위치 기반 서비스 플러그인을 나타냅니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• allowExperimental : bool
• availableServiceProviders : stringlist
• isAttached : bool
• locales : stringlist
• name : string
• parameters : list<PluginParameter>
• preferred : stringlist
• required : enumeration

방법

• bool supportsGeocoding(GeocodingFeatures features)
• bool supportsMapping(MappingFeatures features)
• bool supportsNavigation(NavigationFeatures features)
• bool supportsPlaces(PlacesFeatures features)
• bool supportsRouting(RoutingFeatures features)

상세 설명

플러그인 유형은 Location API의 다양한 작업에 사용할 사용 가능한 GeoServices 플러그인을 선언적으로 지정하는 데 사용됩니다. 플러그인은 Map, RouteModel, GeocodeModel 유형은 물론 그 외 다양한 유형에서 사용됩니다.

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

Plugin 객체가 생성되면, 이 객체는 "분리된" 상태가 되어 실제 서비스 플러그인과 연결되지 않습니다. name, preferred 또는 required 속성을 설정하여 정보를 수신하면, 연결할 적절한 서비스 플러그인을 선택합니다. Plugin 객체는 한 번만 연결할 수 있습니다. 여러 플러그인을 사용하려면 여러 개의 Plugin 객체를 생성해야 합니다.

사용 예시

다음 코드 조각은 required 및 preferred 속성이 설정된 Plugin 객체가 생성되는 모습을 보여줍니다. 이 Plugin은 매핑과 지오코딩을 모두 지원하는 첫 번째 플러그인에 연결되며, 다른 플러그인보다 "here" 또는 "osm"이라는 이름의 플러그인을 우선적으로 선택합니다.

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

속성 설명

allowExperimental : bool

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

availableServiceProviders : stringlist

이 속성은 사용 가능한 모든 서비스 플러그인의 이름 목록을 포함합니다. name 및 required 에서 제공하는 컨트롤만으로는 사용자의 요구를 충족하기에 충분하지 않은 경우, 이 속성을 사용하여 사용 가능한 플러그인을 수동으로 열거할 수 있습니다.

isAttached : bool

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

locales : stringlist

이 속성에는 우선순위가 지정된 플러그인 로케일 목록이 포함되어 있습니다. 첫 번째 로케일을 사용할 수 없는 경우, 백엔드는 두 번째 로케일로 대체하여 사용하며, 이 과정이 계속 이어집니다. 기본적으로 locales 속성에는 시스템 로케일이 포함됩니다.

로케일은 "language[_script][_country]" 또는 "C" 형식의 문자열로 지정되며, 여기서:

• language는 소문자, 두 글자로 구성된 ISO 639 언어 코드이며,
• script는 대소문자를 구분하는 4자 ISO 15924 문자 체계 코드이며,
• country는 대문자로 된 2자 또는 3자의 ISO 3166 국가 코드(유엔에서 정의한 "419"도 포함),
• "C" 로케일은 다음 문서에 따라 English/UnitedStates와 동작이 동일합니다. 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
• Plugin.GeocodingFeature
• Plugin.ReverseGeocodingFeature
• Plugin.RoutingFeature
• Plugin.MappingFeature
• Plugin.AnyPlacesFeature

메서드 문서

bool supportsGeocoding(GeocodingFeatures features)

이 메서드는 지정된 features 세트가 지리 정보 서비스 제공자 플러그인에서 지원되는지 여부를 나타내는 부울 값을 반환합니다. 지정된 모든 features 가 지원되는 경우 ‘ True ’이 반환되고, 그렇지 않은 경우 ‘ false ’이 반환됩니다.

features 매개변수는 다음 플래그 조합 중 하나일 수 있습니다:

bool supportsMapping(MappingFeatures features)

이 메서드는 지정된 일련의 features 가 지리 정보 서비스 제공자 플러그인에서 지원되는지 여부를 나타내는 부울 값을 반환합니다. 지정된 모든 features 가 지원되는 경우 True가 반환되고, 그렇지 않은 경우 false가 반환됩니다.

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

bool supportsNavigation(NavigationFeatures features)

이 메서드는 지정된 features 집합이 지리 정보 서비스 제공자 플러그인에서 지원되는지 여부를 나타내는 부울 값을 반환합니다. 지정된 모든 features 가 지원되는 경우 True가 반환되고, 그렇지 않은 경우 false가 반환됩니다.

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

bool supportsPlaces(PlacesFeatures features)

이 메서드는 지정된 features 세트가 지리 서비스 제공자 플러그인에서 지원되는지 여부를 나타내는 부울 값을 반환합니다. 지정된 모든 features 가 지원되는 경우 True가 반환되고, 그렇지 않은 경우 false가 반환됩니다.

features 매개변수는 다음 플래그의 임의의 조합으로 지정할 수 있습니다:

bool supportsRouting(RoutingFeatures features)

이 메서드는 지정된 features 세트가 지리 정보 서비스 제공자 플러그인에서 지원되는지 여부를 나타내는 부울 값을 반환합니다. 지정된 모든 features 가 지원되는 경우 True가 반환되고, 그렇지 않은 경우 false가 반환됩니다.

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