このページでは

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 のコピーを作成します。

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

other からデータを取得して、geo address オブジェクトを生成します。

注: 移動元の 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

地区を返します。地区は、市の下位行政区画とみなされます。

setDistrict()も参照してください 。

bool QGeoAddress::isEmpty() const

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

bool QGeoAddress::isTextGenerated() const

QGeoAddress::text() がアドレス要素から自動的に生成された場合は true を返し、text() が明示的に割り当てられている場合は false を返します。

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() は false を返します。

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

text()も参照してください 。

QString QGeoAddress::state() const

状態を返します。状態は、国に次ぐ最初の行政区分とみなされます。

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

アドレスを、フォーマット済みの単一の文字列として返します。これは、ユーザーにアドレスを表示する際に使用することが推奨される文字列です。通常、封筒に記載されているような形式のアドレスになりますが、必ずしもそうであるとは限りません。

住所のテキストは、自動的に生成されるか、明示的に割り当てられます。これは、isTextGenerated を確認することで判別できます。

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

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

setText()も参照してください 。

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

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 を返します。

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