Back to Qt.io
Contact Us Blog Download Qt

Plugin QML Type

插件类型描述了基于位置的服务插件。更多

Import Statement: import QtLocation 6.9
Since: QtLocation 5.5

属性

方法

详细说明

Plugin 类型用于声明性地指定哪个可用的 GeoServices 插件应被用于位置 API 中的各种任务。插件被Map 、RouteModel 和GeocodeModel 以及其他各种类型使用。

系统识别的插件都有一个name 属性，这是一个简单的字符串，通常表示插件从中获取数据的服务名称。它们还有各种功能，可以使用supportsRouting(),supportsGeocoding(),supportsMapping(),supportsPlaces() 和supportsNavigation() 方法进行测试。

创建插件对象时，它是 "分离 "的，与任何实际服务插件都没有关联。一旦它通过设置name 、preferred 或required 属性接收到信息，它就会选择一个合适的服务插件进行附加。插件对象只能附加一次；要使用多个插件，请创建多个插件对象。

使用示例

下面的代码段显示了一个设置了required 和preferred 属性的 Plugin 对象。该插件将附加到第一个找到的同时支持制图和地理编码的插件上，并优先选择名为 "here "或 "osm "的插件，而不是其他任何插件。

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

属性文档

allowExperimental : bool

此属性表示是否可以使用实验插件。


availableServiceProviders : stringlist

该属性包含所有可用服务插件名称的列表。如果name 和required 提供的控制功能无法满足您的需要，则可使用此功能手动枚举可用插件。


isAttached : bool

该属性表示插件项是否附加到地理服务提供商插件。


locales : stringlist

该属性包含首选插件本地化的有序列表。如果第一个本地化无法满足要求，则后端会退回到使用第二个本地化，依此类推。默认情况下，loces 属性包含系统本地语言。

本地语言以字符串形式指定，格式为 "language[_script][_country]"或 "C"，其中

  • language 是小写的双字母 ISO 639 语言代码、
  • script 是大写、四个字母的 ISO 15924 文字编码、
  • country 是大写的两个或三个字母的 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 参数可以是以下标志的任意组合：

特征说明
Plugin.NoGeocodingFeatures不支持地理编码功能。
Plugin.OnlineGeocodingFeature支持在线地理编码。
Plugin.OfflineGeocodingFeature支持离线地理编码。
Plugin.ReverseGeocodingFeature支持反向地理编码。
Plugin.LocalizedGeocodingFeature支持返回带有本地化地址的地理编码结果。
Plugin.AnyGeocodingFeatures匹配提供任何地理编码功能的地理服务提供商。

bool supportsMapping(MappingFeatures features)

此方法返回一个布尔值，表示地理服务提供商插件是否支持指定的features 。如果支持所有指定的features ，则返回 true；否则返回 false。

features 参数可以是以下标志的任意组合：

特征描述
Plugin.NoMappingFeatures不支持映射功能。
Plugin.OnlineMappingFeature支持在线映射。
Plugin.OfflineMappingFeature支持离线映射。
Plugin.LocalizedMappingFeature支持返回本地化地图数据。
Plugin.AnyMappingFeatures匹配提供任何地图功能的地理服务提供商。

bool supportsNavigation(NavigationFeatures features)

此方法返回一个布尔值，表示地理服务提供商插件是否支持指定的features 。如果支持所有指定的features ，则返回 true；否则返回 false。

features 参数可以是以下标志的任意组合：

特征说明
Plugin.NoNavigationFeatures不支持导航功能。
Plugin.OnlineNavigationFeature支持在线导航。
Plugin.OfflineNavigationFeature支持离线导航。
Plugin.AnyNavigationFeatures匹配提供任何导航功能的地理服务提供商。

bool supportsPlaces(PlacesFeatures features)

此方法返回一个布尔值，表示地理服务提供商插件是否支持指定的features 。如果支持所有指定的features ，则返回 true；否则返回 false。

features 参数可以是以下标志的任意组合：

特征描述
Plugin.NoPlacesFeatures不支持地点功能。
Plugin.OnlinePlacesFeature支持在线地点功能。
Plugin.OfflinePlacesFeature支持离线地点功能。
Plugin.SavePlaceFeature支持保存类别。
Plugin.RemovePlaceFeature支持移除或删除地点。
Plugin.PlaceRecommendationsFeature支持搜索与另一地点相似的推荐地点。
Plugin.SearchSuggestionsFeature支持搜索建议。
Plugin.LocalizedPlacesFeature支持返回本地化地点数据。
Plugin.NotificationsFeature支持地点和类别变更通知。
Plugin.PlaceMatchingFeature支持匹配来自两个不同地理服务提供商的地点。
Plugin.AnyPlacesFeatures匹配提供任何地点特征的地理服务提供商。

bool supportsRouting(RoutingFeatures features)

此方法返回一个布尔值，表示地理服务提供商插件是否支持指定的features 。如果支持所有指定的features ，则返回 true；否则返回 false。

features 参数可以是以下标志的任意组合：

特征描述
Plugin.NoRoutingFeatures不支持路由功能。
Plugin.OnlineRoutingFeature支持在线路由。
Plugin.OfflineRoutingFeature支持离线路由。
Plugin.LocalizedRoutingFeature支持返回带有本地化地址和说明的路由。
Plugin.RouteUpdatesFeature支持根据当前位置更新现有路线。
Plugin.AlternativeRoutesFeature支持返回备选路线。
Plugin.ExcludeAreasRoutingFeature支持指定返回路线不得穿越的区域。
Plugin.AnyRoutingFeatures匹配提供任何路由功能的地理服务提供商。

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