Address QML Type

Address QML型は特定の場所を番地として表します。詳細...

Import Statement: import QtPositioning

継承されたメンバを含むすべてのメンバの一覧

プロパティ

address : QGeoAddress
city : string
country : string
countryCode : string
county : string
district : string
isTextGenerated : bool
postalCode : string
state : string
street : string
streetNumber : string (since QtPositioning 6.2)
text : string

詳細説明

住所は、(Reverse) Geocoding や Places 検索などのクエリのデータ単位として使用されます。

Addressのすべてのプロパティが、必ずしも世界のすべての地域やロケールで利用可能であったり、関連性があるとは限らない。district 、state 、county のプロパティは、多くのデータソースで特に地域固有であり、多くの場合、これらのうち1つか2つしか利用できないか、有用でない。

Addressにはtext プロパティがあり、フォーマットされた文字列を保持する。これはユーザーに住所を表示するための推奨される方法で、通常、封筒に記載されているような住所の書式を取りますが、必ずしもそうとは限りません。text は、street やcity などのアドレス・プロパティから自動的に生成されることもありますが、明示的に割り当てることもできます。詳細はtext を参照のこと。

使用例

以下のコード・スニペットは、Addressオブジェクトの宣言を示しています。

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

これは例えば、ジオコーディングクエリの値として使用することができ、住所の正確な経度と緯度を取得することができます。

QGeoAddressも参照してください。

プロパティのドキュメント

address : QGeoAddress

このプロパティを使った C++ と QML のインターフェースの詳細については、"C++ と QML コードのインターフェース"を参照してください。

city : string

このプロパティは、市区町村をフォーマットされた文字列として保持します。

country : string

このプロパティは、住所の国をフォーマットされた文字列として保持します。

countryCode : string

このプロパティは、単一フォーマットの文字列として、住所の国コードを保持する。

county : string

このプロパティは、単一書式の文字列として、住所の郡を保持する。

district : string

このプロパティは、単一フォーマットの文字列として、住所の地区を保持する。

isTextGenerated : bool

このプロパティは、true の場合、text がアドレス・プロパティから自動的に生成されることを示す boolean を保持します。false の場合は、text が明示的に割り当てられていることを示す。

postalCode : string

このプロパティは、住所の郵便番号を単一のフォーマット文字列として保持します。

state : string

このプロパティは、1 つのフォーマットされた文字列として、住所の州を保持します。

street : string

このプロパティは、住所の通りを保持します。

注意: Qt6 以前では、このプロパティには住戸番号や建物名など、住所と別の住所を区別するために使用される可能性のあるものを含めることもできました。Qt6 以降では、このような情報にはstreetNumber プロパティを使用します。

streetNumber : string [since QtPositioning 6.2]

このプロパティは、住所の番地や建物名など、住所を区別するための情報を保持します。

このプロパティはQtPositioning 6.2で導入されました。

text : string

このプロパティは、住所を1つのフォーマットされた文字列として保持します。これは、ユーザーに住所を表示するために推奨される文字列です。通常、封筒に記載されているような住所の書式をとりますが、必ずしもそうとは限りません。

アドレスtext は自動的に生成されるか、明示的に割り当てられるかのどちらかです。これはisTextGenerated をチェックすることで判断できます。

text に空の文字列が割り当てられている場合、isTextGenerated は真に設定され、text は、countryCode に従って、住所のプロパティに基づいてローカルにフォーマットされた文字列を返します。street やcity などのアドレス・プロパティを変更すると、text の内容が変更される可能性がある。

text に空でない文字列が割り当てられている場合、isTextGenerated はfalseに設定され、text は常に明示的に割り当てられた文字列を返します。アドレス・プロパティを変更しても、text プロパティには影響しません。

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