Address QML Type

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

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

プロパティ

• 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

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

country : string

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

countryCode : string

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

county : string

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

district : string

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

isTextGenerated : bool

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

postalCode : string

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

state : string

このプロパティは、アドレスの状態を1つのフォーマットされた文字列として保持する。

street : string

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

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 プロパティには影響しません。