PySide6.QtLocation.QPlaceManagerEngine¶

class QPlaceManagerEngine¶

QPlaceManagerEngine 类为QGeoServiceProvider插件的实现者提供了一个接口，这些实现者希望提供对地点功能的访问。更多…

概要¶

方法¶

• def __init__()

• def manager()

• def managerName()

• def managerVersion()

虚拟方法¶

• def category()

• def childCategories()

• def childCategoryIds()

• def compatiblePlace()

• def constructIconUrl()

• def getPlaceContent()

• def getPlaceDetails()

• def initializeCategories()

• def locales()

• def matchingPlaces()

• def parentCategoryId()

• def removeCategory()

• def removePlace()

• def saveCategory()

• def savePlace()

• def search()

• def searchSuggestions()

• def setLocales()

信号¶

• def categoryAdded()

• def categoryRemoved()

• def categoryUpdated()

• def dataChanged()

• def errorOccurred()

• def finished()

• def placeAdded()

• def placeRemoved()

• def placeUpdated()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

注意

后端类没有源代码或二进制兼容性保证。API 仅保证与开发时使用的 Qt 版本兼容。然而，API 更改只会在次要版本中进行。（6.6、6.7 等。）

应用程序开发人员不需要关心QPlaceManagerEngine。然而，后端实现者需要从QPlaceManagerEngine派生，并为抽象虚函数提供实现。

有关编写后端的更多信息，请参阅Places Backend文档。

另请参阅

QPlaceManager

__init__(parameters[, parent=None])¶

Parameters:

• parameters – 字典，键类型为 .QString，值类型为 QVariant。

• parent – QObject

使用指定的parent构造一个新的引擎，并使用parameters将任何特定于实现的数据传递给引擎。

category(categoryId)¶

Parameters:

categoryId – str

Return type:

QPlaceCategory

返回与给定categoryId对应的类别。

categoryAdded(category, parentCategoryId)¶

Parameters:

• 类别 – QPlaceCategory

• parentCategoryId – str

如果category已被添加到管理器引擎的数据存储中，则会发出此信号。category的父级由parentId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

categoryRemoved(categoryId, parentCategoryId)¶

Parameters:

• categoryId – str

• parentCategoryId – str

当与categoryId对应的类别已从管理器引擎的数据存储中移除时，会发出此信号。被移除类别的父类别由parentId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

categoryUpdated(category, parentCategoryId)¶

Parameters:

• 类别 – QPlaceCategory

• parentCategoryId – str

如果在管理器引擎的数据存储中修改了一个category，则会发出此信号。修改类别的父级由parentId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

childCategories(parentId)¶

Parameters:

parentId – str

Return type:

QPlaceCategory的列表

返回与parentId对应的类别的子类别列表。如果parentId为空，则返回所有顶级类别。

childCategoryIds(categoryId)¶

Parameters:

categoryId – str

Return type:

字符串列表

返回与categoryId对应的类别的子类别标识符。如果categoryId为空，则返回所有顶级类别标识符。

compatiblePlace(original)¶

Parameters:

原始 – QPlace

Return type:

QPlace

返回一个经过修剪或修改的original版本，适合由管理器引擎保存。

只有此管理器支持的场所详细信息才会出现在修改后的版本中。管理器特定的数据，如场所ID，不会从original复制过来。

constructIconUrl(icon, size)¶

Parameters:

• 图标 – QPlaceIcon

• size – QSize

Return type:

QUrl

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

从给定的icon和size构建一个图标URL。返回最匹配给定参数的图标图像的URL。

dataChanged()¶

*

如果引擎的底层数据存储发生大规模变化，并且引擎认为这些变化足够激进，需要客户端重新加载所有数据，则会发出此信号。

如果信号被发出，相关的更改将不会发出其他信号。

errorOccurred(reply, error[, errorString=""])¶

Parameters:

• 回复 – QPlaceReply

• 错误 – Error

• errorString – str

当在reply的处理过程中检测到错误时，会发出此信号。finished()信号可能会紧随其后。

错误将由错误代码error描述。如果errorString不为空，它将包含一个面向开发者的错误文本描述，而不是最终用户。

此信号和errorOccurred()将同时发出。

注意

不要删除连接到这个信号的槽中的reply对象。请使用deleteLater()代替。

finished(reply)¶

Parameters:

回复 – QPlaceReply

当reply完成处理时，会发出此信号。

如果 reply->error() 等于 NoError，则处理成功完成。

此信号和finished()将同时发出。

注意

不要删除连接到这个信号的槽中的reply对象。请使用deleteLater()代替。

getPlaceContent(request)¶

Parameters:

请求 – QPlaceContentRequest

Return type:

QPlaceContentReply

根据request中指定的参数检索地点的内容。

getPlaceDetails(placeId)¶

Parameters:

placeId – str

Return type:

QPlaceDetailsReply

检索与给定placeId对应的地点详细信息。

initializeCategories()¶

Return type:

QPlaceReply

初始化管理引擎的类别。

locales()¶

Return type:

QLocale的列表

返回首选语言环境的列表。这些语言环境用作管理引擎的提示，指示应返回哪种语言的地点和类别详细信息。

如果无法适应第一个指定的区域设置，管理引擎将回退到下一个，依此类推。

对语言环境的支持可能因提供商而异。对于那些确实支持语言环境的提供商，默认情况下将使用全局默认语言环境。如果管理器引擎没有分配语言环境，它将隐式使用全局默认语言环境。对于不支持语言环境的引擎，语言环境列表始终为空。

另请参阅

setLocales()

manager()¶

Return type:

QPlaceManager

返回用于创建此引擎的管理器实例。

managerName()¶

Return type:

字符串

返回此引擎实现用于区分自己与其他插件提供的实现的名称。

管理员的名称会自动设置为与QGeoServiceProviderFactory::providerName()相同。

managerVersion()¶

Return type:

整数

返回此引擎实现的版本。

管理器版本自动设置为与 QGeoServiceProviderFactory::providerVersion() 相同。

matchingPlaces(request)¶

Parameters:

请求 – QPlaceMatchRequest

Return type:

QPlaceMatchReply

返回一个包含与request中指定的地点对应/匹配的地点列表的回复。

parentCategoryId(categoryId)¶

Parameters:

categoryId – str

Return type:

字符串

返回与categoryId对应的类别的父类别标识符。

placeAdded(placeId)¶

Parameters:

placeId – str

如果某个地点已被添加到管理器引擎的数据存储中，则会发出此信号。具体添加的地点由placeId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

placeRemoved(placeId)¶

Parameters:

placeId – str

如果某个地点已从管理器引擎的数据存储中移除，则会发出此信号。已移除的特定地点由placeId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

placeUpdated(placeId)¶

Parameters:

placeId – str

如果管理器引擎的数据存储中的某个地点被修改，则会发出此信号。特定的修改地点由placeId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅

dataChanged()

removeCategory(categoryId)¶

Parameters:

categoryId – str

Return type:

QPlaceIdReply

从管理引擎的数据存储中移除与categoryId对应的类别。

removePlace(placeId)¶

Parameters:

placeId – str

Return type:

QPlaceIdReply

从管理引擎的数据存储中移除与placeId对应的地点。

saveCategory(category, parentId)¶

Parameters:

• 类别 – QPlaceCategory

• parentId – str

Return type:

QPlaceIdReply

保存一个category，它是parentId指定的类别的子类别。空的parentId意味着category被保存为顶级类别。

savePlace(place)¶

Parameters:

地点 – QPlace

Return type:

QPlaceIdReply

将指定的place保存到管理引擎的数据存储中。

search(request)¶

Parameters:

请求 – QPlaceSearchRequest

Return type:

QPlaceSearchReply

根据request中指定的参数搜索地点。

searchSuggestions(request)¶

Parameters:

请求 – QPlaceSearchRequest

Return type:

QPlaceSearchSuggestionReply

根据request中指定的参数请求一组搜索词建议。

setLocales(locales)¶

Parameters:

locales – QLocale 的列表

设置首选的locales列表。

另请参阅

locales()