QGeoRouteReply Class
QGeoRouteReply 클래스는 QGeoRoutingManager 의 인스턴스가 시작한 작업을 관리합니다. 더 보기...
| Header: | #include <QGeoRouteReply> |
| qmake: | QT += location |
| Inherits: | QObject |
공개 유형
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, UnknownError } |
공개 함수
| QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr) | |
| virtual | ~QGeoRouteReply() |
| virtual void | abort() |
| QGeoRouteReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| QGeoRouteRequest | request() const |
| QList<QGeoRoute> | routes() const |
신호
| void | aborted() |
| void | errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString()) |
| void | finished() |
보호된 함수
| QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr) | |
| void | addRoutes(const QList<QGeoRoute> &routes) |
| void | setError(QGeoRouteReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setRoutes(const QList<QGeoRoute> &routes) |
상세 설명
QGeoRouteReply의 인스턴스는 이러한 작업의 상태와 결과를 관리합니다.
isFinished(), error() 및 errorString() 메서드는 작업이 완료되었는지, 그리고 성공적으로 완료되었는지에 대한 정보를 제공합니다.
finished() 및 errorOccurred(QGeoRouteReply::Error,QString) 신호를 사용하여 작업 진행 상황을 모니터링할 수 있습니다.
새로 생성된 QGeoRouteReply가 완료된 상태일 수 있는데, 이는 대개 오류가 발생했기 때문입니다. 이러한 인스턴스는 finished() 또는 errorOccurred(QGeoRouteReply::Error,QString) 신호를 절대 발생시키지 않으므로, 신호에 연결하기 전에 isFinished()의 결과를 확인하는 것이 중요합니다. QGeoRoutingManager 문서는 이를 수행하는 방법을 보여줍니다.
작업이 성공적으로 완료되면 routes()를 통해 결과에 접근할 수 있습니다.
멤버 유형 문서
enum QGeoRouteReply::Error
작업 완료를 방해한 오류를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QGeoRouteReply::NoError | 0 | 오류가 발생하지 않았습니다. |
QGeoRouteReply::EngineNotSetError | 1 | 사용된 라우팅 관리자에 연결된 QGeoRoutingManagerEngine 인스턴스가 없습니다. |
QGeoRouteReply::CommunicationError | 2 | 서비스 제공자와 통신하는 동안 오류가 발생했습니다. |
QGeoRouteReply::ParseError | 3 | 서비스 제공자의 응답 형식이 인식할 수 없는 형식이었습니다. |
QGeoRouteReply::UnsupportedOptionError | 4 | 요청된 작업 또는 해당 작업의 옵션 중 하나가 서비스 제공자에서 지원되지 않습니다. |
QGeoRouteReply::UnknownError | 5 | 다른 범주에 해당하지 않는 오류가 발생했습니다. |
멤버 함수 설명서
[explicit protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)
request 를 기반으로, 지정된 parent 를 사용하여 경로 응답 객체를 생성합니다.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
지정된 error 및 errorString 와 함께, 지정된 parent 를 사용하여 경로 응답을 생성합니다.
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
이 경로 응답 객체를 삭제합니다.
[virtual] void QGeoRouteReply::abort()
작업을 즉시 취소합니다.
응답 처리가 완료된 경우에는 아무런 동작도 수행되지 않습니다.
[signal] void QGeoRouteReply::aborted()
이 신호는 작업이 취소되었을 때 발생합니다.
abort()도 참조하십시오 .
[protected] void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)
routes 목록을 기존 목록에 추가합니다.
QGeoRouteReply::Error QGeoRouteReply::error() const
이 응답의 오류 상태를 반환합니다.
결과가 ` QGeoRouteReply::NoError `인 경우 오류가 발생하지 않았습니다.
setError()도 참조하십시오 .
[signal] void QGeoRouteReply::errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString())
이 신호는 해당 응답을 처리하는 과정에서 오류가 감지되었을 때 발생합니다. 이후 finished() 신호가 발생할 가능성이 높습니다.
오류는 오류 코드 ` error`로 설명됩니다. ` errorString `가 비어 있지 않은 경우, 이 변수에는 오류에 대한 텍스트 설명이 포함됩니다.
이 신호와 QGeoRoutingManager::errorOccurred()은 동시에 발생합니다.
참고: 이 신호에 연결된 슬롯에서 이 reply 객체를 삭제하지마십시오 . 대신 deleteLater()을 사용하십시오.
QString QGeoRouteReply::errorString() const
이 응답의 오류 상태를 텍스트로 변환하여 반환합니다.
오류가 발생하지 않은 경우 빈 문자열을 반환합니다. 텍스트 표현이 없는 오류가 발생한 경우에도 빈 문자열을 반환합니다.
오류가 발생했는지 확인하려면 ` QGeoRouteReply::error()`의 값이 ` QGeoRouteReply::NoError`와 동일한지 확인하십시오.
[signal] void QGeoRouteReply::finished()
이 신호는 해당 응답의 처리가 완료되었을 때 발생합니다.
error()의 결과가 QGeoRouteReply::NoError 와 같다면 처리가 성공적으로 완료된 것입니다.
이 신호와 QGeoRoutingManager::finished()은 동시에 발송됩니다.
참고: 이 신호에 연결된 슬롯에서 이 응답 객체를 삭제하지마십시오 . 대신 deleteLater()를 사용하십시오.
setFinished()도 참조하십시오 .
bool QGeoRouteReply::isFinished() const
작업이 성공적으로 완료되었거나, 작업이 중단되는 오류가 발생한 경우 true를 반환합니다.
QGeoRouteRequest QGeoRouteReply::request() const
해당 경로를 지정한 경로 요청을 반환합니다.
QList<QGeoRoute> QGeoRouteReply::routes() const
요청된 경로 목록을 반환합니다.
setRoutes()도 참조하십시오 .
[protected] void QGeoRouteReply::setError(QGeoRouteReply::Error error, const QString &errorString)
이 응답의 오류 상태를 ` error `로, 오류의 텍스트 표현을 ` errorString`로 설정합니다.
또한 이로 인해 errorOccurred() 및 finished() 신호가 해당 순서대로 발생합니다.
error()도 참조하십시오 .
[protected] void QGeoRouteReply::setFinished(bool finished)
finished 에 대한 이 응답이 완료되었는지 여부를 설정합니다.
finished 가 true인 경우, 이 함수는 finished() 신호를 발생시킵니다.
작업이 성공적으로 완료된 경우, 이 함수를 호출하기 전에 QGeoRouteReply::setRoutes()를 호출해야 합니다. 오류가 발생한 경우, 대신 QGeoRouteReply::setError()를 사용해야 합니다.
finished()도 참조하십시오 .
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
routes 에 대한 응답에 포함될 경로 목록을 설정합니다.
routes()도 참조하십시오 .
© 2026 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.