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