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()は同時に発火します。
注: このシグナルに接続されたスロット内で、この返信オブジェクトを削除しないでください 。代わりに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.