QGeoAddress Class

QGeoAddressクラスは、QGeoLocation のアドレスを表す

ヘッダー #include <QGeoAddress>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning

パブリック関数

QGeoAddress()
QGeoAddress(const QGeoAddress &other)
(since 6.2) QGeoAddress(QGeoAddress &&other)
~QGeoAddress()
QString city() const
void clear()
QString country() const
QString countryCode() const
QString county() const
QString district() const
bool isEmpty() const
bool isTextGenerated() const
QString postalCode() const
void setCity(const QString &city)
void setCountry(const QString &country)
void setCountryCode(const QString &countryCode)
void setCounty(const QString &county)
void setDistrict(const QString &district)
void setPostalCode(const QString &postalCode)
void setState(const QString &state)
void setStreet(const QString &street)
(since 6.2) void setStreetNumber(const QString &streetNumber)
void setText(const QString &text)
QString state() const
QString street() const
(since 6.2) QString streetNumber() const
(since 6.2) void swap(QGeoAddress &other)
QString text() const
(since 6.2) QGeoAddress &operator=(QGeoAddress &other)
QGeoAddress &operator=(const QGeoAddress &address)
size_t qHash(const QGeoAddress &address, size_t seed = 0)
bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

詳細説明

住所の属性は、米国のフィーチャ名に正規化されており、ローカルのフィーチャレベルにマッピングすることができます(例えば、Stateはドイツの "Bundesland "にマッチします)。

住所には、表示用のtext() と、住所の構成要素にアクセスするための追加プロパティが含まれます:

メンバ関数ドキュメント

QGeoAddress::QGeoAddress()

デフォルトのコンストラクタ。

QGeoAddress::QGeoAddress(const QGeoAddress &other)

other のコピーを作成する。

[noexcept, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)

other から移動して地理住所オブジェクトを構築します。

注意: 移動元の QGeoAddress オブジェクトは破棄または代入のみ可能です。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

この関数は Qt 6.2 で導入されました。

[noexcept] QGeoAddress::~QGeoAddress()

このアドレスを破壊する。

QString QGeoAddress::city() const

都市を返す。

setCity()も参照

void QGeoAddress::clear()

アドレスのデータフィールドをすべてクリアする。

QString QGeoAddress::country() const

国名を返します。

setCountry()も参照

QString QGeoAddress::countryCode() const

ISO 3166-1 alpha-3 に従った国コードを返します。

setCountryCode()も参照 ください。

QString QGeoAddress::county() const

郡を返します。郡は国から 2 番目の下位区分とみなされます。

setCounty()も参照してください

QString QGeoAddress::district() const

地区を返します。地区は、city以下の小区域とみなされます。

setDistrict()も参照

bool QGeoAddress::isEmpty() const

この住所が空であるかどうかを返します。すべてのフィールドが空の場合、アドレスは空であるとみなされます。

bool QGeoAddress::isTextGenerated() const

QGeoAddress::text() がアドレス要素から自動的に生成された場合は真を返し、そうでない場合はtext() が明示的に割り当てられた場合に偽を返す。

text() およびsetText()も参照

QString QGeoAddress::postalCode() const

郵便番号を返します。

setPostalCode()も参照

void QGeoAddress::setCity(const QString &city)

city を設定する。

city()も参照

void QGeoAddress::setCountry(const QString &country)

country 名を設定する。

country()も参照のこと

void QGeoAddress::setCountryCode(const QString &countryCode)

ISO 3166-1 alpha-3 に従ってcountryCode を設定する。

countryCode()も参照

void QGeoAddress::setCounty(const QString &county)

county を設定する。

county()も参照

void QGeoAddress::setDistrict(const QString &district)

district を設定する。

district()も参照

void QGeoAddress::setPostalCode(const QString &postalCode)

postalCode を設定する。

postalCode()も参照

void QGeoAddress::setState(const QString &state)

state を設定する。

state()も参照

void QGeoAddress::setStreet(const QString &street)

ストリート名をstreet に設定します。

注意: Qt6以前では、番地や建物名など、住所を区別するのに使われるようなものも含まれていました。このデータを設定するには、setStreetNumber() を使用してください。

street() およびsetStreetNumber()も参照してください

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

ストリート番号をstreetNumber に設定します。

これには、番地や建物名など、住所を区別するための情報を含めることができます。

注: Qt6以前では、この情報はsetStreet ()メソッドで設定されていました。

この関数はQt 6.2で導入されました。

streetNumber() やsetStreet()も参照してください

void QGeoAddress::setText(const QString &text)

text が空でない場合、text() が返す文字列としてtext を明示的に代入する。isTextGenerated() は偽を返す。

text が空の場合、text() がアドレス要素から自動生成されることを示す。isTextGenerated() はtrueを返す。

text()も参照

QString QGeoAddress::state() const

州を返します。州は、country よりも下位の最初の部分とみなされます。

setState()も参照

QString QGeoAddress::street() const

通りの名前を返します。

注意: Qt6以前では、番地や建物名など、住所を区別するために使われるようなものを含むことができました。このデータを取得するには、streetNumber() を使用してください。

setStreet() およびstreetNumber()も参照してください

[since 6.2] QString QGeoAddress::streetNumber() const

ストリートナンバーを返します。

また、番地や建物名など、住所を区別するための情報を含むこともあります。

注: Qt6以前では、この情報はstreet ()メソッドで返されていました。

この関数はQt 6.2で導入されました。

setStreetNumber() およびstreet()も参照してください

[noexcept, since 6.2] void QGeoAddress::swap(QGeoAddress &other)

このアドレスをother と交換する。この操作は非常に高速で、失敗することはありません。

この関数は Qt 6.2 で導入されました。

QString QGeoAddress::text() const

住所を1つのフォーマットされた文字列として返します。これは、ユーザーに住所を表示する際に推奨される文字列です。通常、封筒に書かれているような住所の書式をとりますが、必ずしもそうであるとは限りません。

住所テキストは自動的に生成されるか、明示的に割り当てられるかのどちらかです。これはisTextGenerated をチェックすることで判断できる。

setText() に空の文字列が指定された場合、isTextGenerated() はtrue に設定され、text() はcountryCode() に従って、street や city などの住所の要素に基づいてローカルにフォーマットされた文字列を返す。テキスト文字列は住所要素から生成されるため、text()、setStreet()、text() といった一連の呼び出しは、text() を呼び出すたびに異なる文字列を返す可能性がある。

setText() に空でない文字列が指定された場合、isTextGenerated() はfalse に設定され、text() は常に明示的に指定された文字列を返す。setStreet() やsetCity() などの他の要素を変更するための呼び出しは、text() の結果の文字列には影響しない。

setText()も参照

[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

move-このアドレスにother を割り当て、このアドレスへの参照を返す。

注意: 移動元のQGeoAddress オブジェクトは、破棄または代入しかできない。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

この関数は Qt 6.2 で導入されました。

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

与えられたaddress をこのアドレスに割り当て、このアドレスへの参照を返します。

関連する非会員

[noexcept] size_t qHash(const QGeoAddress &address, size_t seed = 0)

address のハッシュ値を返す。計算にはseed を使用する。

bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)

lhs のアドレスがrhs と等しくなければtrue を返し、そうでなければfalse を返す。

bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

lhs のアドレスがrhs と等しければtrue を返し、そうでなければfalse を返す。

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