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 ライセンスの下で利用可能です。
詳細を確認してください。

C