C

PositionSource QML Type

PositionSource 型は、デバイスの現在位置を提供します。詳細...

Import Statement:	`import QtPositioning`
Since:	Qt Quick Ultralite 2.11

継承されたメンバーを含む全メンバーのリスト

列挙

SourceError

プロパティ

active : bool
position : Position
sourceError : SourceError
updateInterval : int
valid : bool

詳細説明

PositionSource 型は、ユーザーデバイスの現在位置に関する情報を提供する。位置は、Position 型として提供されます。この型には、経度、緯度、方位など、GPS やその他の類似システムで一般的に使用される標準的なパラメータが含まれています。

updateInterval active プロパティを使用して、PositionSource の動作を制御することができます。

PositionSource がアクティブな場合、position プロパティをバインディングで使用するか（他のアイテムのプロパティの値として）、onPositionChanged シグナルハンドラの実装を提供することによって、位置の更新を取得することができます。

使用例

次の例は、1秒ごとに更新を受信し、経度と緯度をコンソールに出力するために使用される単純なPositionSourceを示しています。

PositionSource {
    id: src
    updateInterval: 1000
    active: true

    onPositionChanged: {
        var coord = src.position.coordinate;
        console.log("Coordinate:", coord.longitude, coord.latitude);
    }
}

列挙ドキュメント

SourceError

位置ソースのエラーを処理するためのエラーコードのリストを提供します。

定数	説明
`PositionSource.AccessError`	アプリケーションに必要な権限がないため、リモート測位バックエンドへの接続セットアップに失敗しました。
`PositionSource.ClosedError`	測位バックエンドは接続を閉じました。これは、ユーザが位置情報サービスをオフにしたときに発生します。位置情報サービスが有効になると、すぐに通常の更新が再開されます。
`PositionSource.NoError`	エラーは発生していません。
`PositionSource.UnknownSourceError`	不明なエラーが発生しました。
`PositionSource.UpdateTimeoutError`	指定されたタイムアウト内に現在位置を取得できなかったか、このPositionSource 、これ以上の定期更新を提供できないと判断した。

プロパティ説明

active : bool

このプロパティは、位置情報ソースがアクティブであるかどうかを示す。

position : Position [read-only]

このプロパティは、最後の既知の位置データを保持する。

Position 型にはさまざまな位置メンバ変数があり、その有効性は適切な有効性関数で確認できる。

sourceError : SourceError [read-only]

このプロパティは、PositionSource で最後に発生したエラーを保持する。

updateInterval : int

このプロパティは、望ましい更新間隔（ミリ秒）を保持する。

valid : bool [read-only]

このプロパティは、PositionSource オブジェクトがデータを提供する有効なQul::GeoPositionSource を取得している場合、true となる。false の場合、PositionSource の他のメソッドは何の効果もありません。

Qul::GeoPositionSource は、アプリケーション・ルート項目の初期化前に登録する必要があります。詳細については、Qul::GeoPositionSource を参照してください。

アプリケーションは、このプロパティをチェックして、位置決めがランタイムプラットフォームで利用可能かどうかを判断し、それに応じて対応する必要があります。

特定の Qt ライセンスの下で利用可能です。
詳細を確認してください。