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.