QGeoAddress Class
QGeoAddress クラスはQGeoLocation の住所を表します。
Header: | #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 |
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
郡」を返します。郡は、country の 2 番目の下位区分とみなされます。
setCounty() も参照 。
QString QGeoAddress::district() const
地区」を返します。地区は、city より下位の小区分と見なされます。
setDistrict() も参照して ください。
bool QGeoAddress::isEmpty() const
この住所が空であるかどうかを返します。すべてのフィールドが空の場合、住所は空であると見なされます。
bool QGeoAddress::isTextGenerated() const
QGeoAddress::text() が address 要素から自動的に生成された場合は 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
状態を返します。州は、country 以下の最初の下位部分と見なされます。
setState() も参照 。
QString QGeoAddress::street() const
ストリート名を返します。
注意: Qt6 より前のバージョンでは、番地や建物名など、住所と別の住所を区別するために使われるようなものも含まれていました。このデータを取得するには、streetNumber() を使用してください。
setStreet() およびstreetNumber()も参照してください 。
[since 6.2]
QString QGeoAddress::streetNumber() const
通り番号を返します。
これには、番地や建物名など、住所を区別するための情報が含まれます。
注: Qt6以前では、この情報はstreet ()メソッドで返されていました。
この関数はQt 6.2で導入されました。
setStreetNumber() およびstreet()も参照してください 。
QString QGeoAddress::text() const
アドレスをフォーマットされた文字列として返します。これは、ユーザーに住所を表示する際に推奨される文字列です。通常、封筒に書かれているような住所の書式をとりますが、必ずしもそうとは限りません。
住所テキストは自動的に生成されるか、明示的に割り当てられるかのどちらかです。これは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
を返します。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。