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