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::NoError0エラーは発生していません。
QGeoCodeReply::EngineNotSetError1使用されたジオコーディング・マネージャには、QGeoCodingManagerEngine インスタンスが関連付けられていませんでした。
QGeoCodeReply::CommunicationError2サービスプロバイダとの通信中にエラーが発生しました。
QGeoCodeReply::ParseError3サービスプロバイダからの応答が認識できない形式であった。
QGeoCodeReply::UnsupportedOptionError4要求された操作または操作のオプションの1つが、サービスプロバイダによってサポートされていません。
QGeoCodeReply::CombinationError5複数のソースからの結果を組み合わせているときにエラーが発生した。
QGeoCodeReply::UnknownError6他のどのカテゴリーにも当てはまらないエラーが発生した。

メンバー関数ドキュメント

[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

操作が正常に完了した場合、または操作が停止するようなエラーが発生した場合に真を返す。

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()も参照

© 2025 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.