このページでは

Location QML Type

「Location」タイプには位置情報が格納されます。詳細...

Import Statement: import QtPositioning

プロパティ

詳細説明

ロケーションタイプは、人間的な意味での地理的な「場所」を表します。これは、特定のcoordinate 、address 、およびbounding shape から構成されます。bounding shape は、この場所を表示する際に推奨される地域を表します。

Location タイプは、GeocodeModel などの検索モデルの内容として最もよく見られます。GeocodeModel が特定のクエリに対して見つかったロケーションのリストを返す場合、それらを Location オブジェクトとして表します。

使用例

以下の例は、単純な Location オブジェクトの宣言を示しています:

Location {
    coordinate {
        latitude: -27.3
        longitude: 153.1
    }
    address: Address {
        ...
    }
}

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

address : Address

このプロパティには、その場所の住所が格納されており、これを使用してその場所の住所の詳細を取得することができます。

boundingShape : geoShape [since QtPositioning 6.2]

このプロパティには、位置情報を表示する際に使用すべき推奨領域が格納されます。たとえば、建物の位置情報には、その建物を中心とする領域が指定される場合がありますが、その領域は、建物のすぐ周辺の地理的状況も表示できるほど十分に広くなっています。

注:この プロパティは、boundingBoxプロパティに代わってQt6で導入されました。geoRectangle ではなく、geoShape を返します。図形のバウンディングgeoRectangle を取得するには、QGeoShape::boundingGeoRectangle()を使用してください。

返されたシェイプを特定の型に変換する必要がある場合は、geoShape のtype プロパティと、QtPositioning のQtPositioning.shapeToRectangle()などの便利メソッドを組み合わせて使用してください。

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

coordinate : coordinate

このプロパティには、その場所の正確な地理座標が格納されており、これを使用してその場所の緯度、経度、高度を取得することができます。

extendedAttributes : VariantMap

このプロパティには、このロケーションの拡張属性が格納されています。拡張属性はバックエンドに依存し、ロケーションに依存する場合もあります。

location : QGeoLocation

このプロパティを使用して C++ と QML を連携させる方法の詳細については、「C++ と QML コード間のインターフェース」を参照してください。

注:この プロパティは 地理位置情報全体を更新するため、これを使用すると、他のすべてのプロパティに対するバインディングがすべて破棄されます。

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