Address QML Type

QMLの「Address」型は、特定の場所を住所として表します。詳細...

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

プロパティ

• 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

詳細説明

「住所」は、（逆）ジオコーディングや場所検索などのクエリにおけるデータ単位として使用されます。こうした操作の多くは、住所を受け取るか、または住所を返します。

アドレスのすべてのプロパティが、世界中のあらゆる地域やロケールで必ずしも利用可能である、あるいは関連性があるとは限りません。特に、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

このプロパティには、住所の都市名が1つのフォーマット済み文字列として格納されています。

country : string

このプロパティには、住所の国名が1つのフォーマット済み文字列として格納されています。

countryCode : string

このプロパティには、住所の国コードが単一のフォーマット済み文字列として格納されています。

county : string

このプロパティには、住所の郡名が単一のフォーマット済み文字列として格納されています。

district : string

このプロパティには、住所の地区名が単一のフォーマット済み文字列として格納されています。

isTextGenerated : bool

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

postalCode : string

このプロパティには、住所の郵便番号が、フォーマット済みの単一の文字列として格納されています。

state : string

このプロパティは、アドレスの状態を単一のフォーマット済み文字列として保持します。

street : string

このプロパティには、住所の通り名が格納されます。

streetNumber : string [since QtPositioning 6.2]

このプロパティには、住所の番地（住戸番号や建物名など、個々の住所を区別するために使用されるあらゆる情報）が格納されます。

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

text : string

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

text に格納された住所は、自動的に生成されたものか、明示的に割り当てられたもののいずれかです。これは、isTextGenerated を確認することで判別できます。

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

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