PySide6.QtLocation.QGeoCodeReply¶

class QGeoCodeReply¶

QGeoCodeReply 类管理由 QGeoCodingManager 实例启动的操作。更多…

概要¶

方法¶

• def __init__()

• def addLocation()

• def error()

• def errorString()

• def isFinished()

• def limit()

• def locations()

• def offset()

• def setError()

• def setFinished()

• def setLimit()

• def setLocations()

• def setOffset()

• def setViewport()

• def viewport()

虚拟方法¶

• def abort()

信号¶

• def aborted()

• def errorOccurred()

• def finished()

注意

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

详细描述¶

QGeoCodeReply 的实例管理这些操作的状态和结果。

isFinished()、error() 和 errorString() 方法提供了操作是否已完成以及是否成功完成的信息。

finished() 和 errorOccurred ( Error ,QString) 信号可用于监视操作的进度。

一个新创建的QGeoCodeReply可能处于完成状态，最常见的原因是发生了错误。由于这样的实例永远不会发出finished()或errorOccurred（Error，QString）信号，因此在连接到信号之前检查isFinished()的结果非常重要。QGeoCodingManager的文档展示了如何执行此操作。

如果操作成功完成，结果将可以通过locations()访问。

class Error¶

描述了一个阻止操作完成的错误。

常量	描述
QGeoCodeReply.NoError	没有发生错误。
QGeoCodeReply.EngineNotSetError	使用的地理编码管理器没有与之关联的QGeoCodingManagerEngine实例。
QGeoCodeReply.CommunicationError	与服务提供商通信时发生错误。
QGeoCodeReply.ParseError	服务提供商的响应格式无法识别。
QGeoCodeReply.UnsupportedOptionError	服务提供商不支持请求的操作或操作的某个选项。
QGeoCodeReply.CombinationError	在从多个来源组合结果时发生了错误。
QGeoCodeReply.UnknownError	发生了一个不属于任何其他类别的错误。

__init__([parent=None])¶

Parameters:

父对象 – QObject

使用指定的parent构建一个地理编码回复。

__init__(error, errorString[, parent=None])

Parameters:

• 错误 – Error

• errorString – str

• parent – QObject

使用给定的error和errorString以及指定的parent构造一个地理编码回复。

abort()¶

立即取消操作。

如果回复已完成，这将不执行任何操作。

另请参阅

aborted()

aborted()¶

当操作被取消时，会发出此信号。

另请参阅

abort()

addLocation(location)¶

Parameters:

位置 – QGeoLocation

将location添加到此回复中的位置列表中。

error()¶

Return type:

错误

返回此回复的错误状态。

如果结果是 NoError 则表示没有发生错误。

另请参阅

setError()

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

Parameters:

• 错误 – Error

• errorString – str

当在处理此回复时检测到错误时，会发出此信号。finished()信号可能会紧随其后。

错误将由错误代码error描述。如果errorString不为空，它将包含错误的文本描述。

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

注意

不要删除与此信号连接的槽中的此回复对象。请改用deleteLater()。

errorString()¶

Return type:

字符串

返回此回复错误状态的文本表示。

如果没有发生错误，这将返回一个空字符串。也有可能发生了一个没有相关文本表示的错误，在这种情况下，这也将返回一个空字符串。

要确定是否发生了错误，请检查error()是否等于NoError。

finished()¶

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

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

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

注意

不要删除与此信号连接的槽中的此回复对象。请改用deleteLater()。

另请参阅

setFinished()

isFinished()¶

Return type:

布尔

如果操作成功完成或遇到导致操作停止的错误，则返回true。

limit()¶

Return type:

整数

返回每个数据源的响应数量限制。

如果没有设置限制，此函数将返回-1。

这可能超过locations() .length()，如果响应数量少于请求的数量。

另请参阅

setLimit()

locations()¶

Return type:

QGeoLocation的列表

返回位置列表。

这些位置是对应于创建此回复的QGeoCodingManager函数操作的结果。

另请参阅

setLocations()

offset()¶

Return type:

整数

返回开始获取结果时在整个结果集中的偏移量。

另请参阅

setOffset()

setError(error, errorString)¶

Parameters:

• 错误 – Error

• errorString – str

将此回复的错误状态设置为error，并将错误的文本表示设置为errorString。

这也将导致errorOccurred()和finished()信号按此顺序发出。

另请参阅

error()

setFinished(finished)¶

Parameters:

已完成 – bool

设置此回复是否已完成为finished。

如果 finished 为真，这将导致 finished() 信号被发出。

如果操作成功完成，setLocations() 应该在此函数之前调用。如果发生错误，则应使用 setError()。

另请参阅

finished()

setLimit(limit)¶

Parameters:

limit – int

设置每个数据源的响应数量限制为limit。

如果 limit 为 -1，则将返回所有可用的响应。

另请参阅

limit()

setLocations(locations)¶

Parameters:

locations – QGeoLocation 的列表

设置回复中的locations列表。

另请参阅

locations()

setOffset(offset)¶

Parameters:

offset – int

设置在整个结果集中开始获取结果的偏移量为offset。

另请参阅

offset()

setViewport(viewport)¶

Parameters:

视口 – QGeoShape

将包含结果的视口设置为viewport。

另请参阅

viewport()

viewport()¶

Return type:

QGeoShape

返回包含结果的视口。

如果没有在创建此回复的QGeoCodingManager函数中指定视口偏差，此函数将返回None。

另请参阅

setViewport()