PySide6.QtLocation.QGeoRouteReply¶

class QGeoRouteReply¶

QGeoRouteReply 类管理由 QGeoRoutingManager 实例启动的操作。更多…

概要¶

方法¶

• def __init__()

• def addRoutes()

• def error()

• def errorString()

• def isFinished()

• def request()

• def routes()

• def setError()

• def setFinished()

• def setRoutes()

虚拟方法¶

• def abort()

信号¶

• def aborted()

• def errorOccurred()

• def finished()

注意

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

详细描述¶

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

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

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

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

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

class Error¶

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

常量	描述
QGeoRouteReply.NoError	没有发生错误。
QGeoRouteReply.EngineNotSetError	使用的路由管理器没有关联的QGeoRoutingManagerEngine实例。
QGeoRouteReply.CommunicationError	与服务提供商通信时发生错误。
QGeoRouteReply.ParseError	服务提供者的响应格式无法识别。
QGeoRouteReply.UnsupportedOptionError	服务提供商不支持请求的操作或操作的某个选项。
QGeoRouteReply.UnknownError	发生了一个错误，该错误不属于任何其他类别。

__init__(request[, parent=None])¶

Parameters:

• 请求 – QGeoRouteRequest

• parent – QObject

根据request构建一个路由回复对象，并指定parent。

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

Parameters:

• 错误 – Error

• errorString – str

• parent – QObject

使用给定的error和errorString以及指定的parent构建一个路由回复。

abort()¶

立即取消操作。

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

aborted()¶

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

另请参阅

abort()

addRoutes(routes)¶

Parameters:

routes – QGeoRoute 的列表

将routes列表附加到现有列表中。

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。

request()¶

Return type:

QGeoRouteRequest

返回指定路由的路由请求。

routes()¶

Return type:

QGeoRoute的列表

返回请求的路由列表。

另请参阅

setRoutes()

setError(error, errorString)¶

Parameters:

• 错误 – Error

• errorString – str

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

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

另请参阅

error()

setFinished(finished)¶

Parameters:

已完成 – bool

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

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

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

另请参阅

finished()

setRoutes(routes)¶

Parameters:

routes – QGeoRoute 的列表

将回复中的路由列表设置为routes。

另请参阅

routes()