位置指定 (QML)

位置情報

位置データには、緯度・経度の座標によって表される地球表面上の正確に指定された位置に加え、次のような関連データが含まれます：

• 位置情報が報告された日時
• 位置情報を報告したデバイスの速度
• 報告された位置の高度（海抜）
• 真北を基準としたデバイスの方位（度単位）

詳細については、「地理座標」を参照してください。

このデータは、さまざまな方法で抽出することができます。位置測定の最もよく知られた方法の一つは、GPS（全地球測位システム）です。これは、地球を周回する衛星から受信した電波信号を用いて、受信機の正確な位置と時刻を計算する、一般に利用可能なシステムです。 もう 1 つの一般的な方法は「セル識別子による位置特定」で、これは、受信デバイスに現在サービスを提供している基地局のセル識別子を使用して、そのおおよその位置を算出するものです。 これらの位置特定方法やその他の方法はすべて、Location API で使用できます。API 内の位置データソースに対する唯一の要件は、日付/時刻値を含む緯度・経度の座標を提供することであり、上記に挙げたその他の属性を提供することも可能です。

座標

geoCoordinate 型は、地理情報の基本単位である座標を提供します。この型には、latitude 、longitude 、altitude を保持するための属性があります。Location には、物理的な住所や境界ボックスに加え、geoCoordinate が含まれています。関連項目：retrieving a location

位置

オブジェクトの3次元位置を保持するgeoCoordinate に加え、Position 型は、将来の位置を計算するためのspeed およびtimestamp を提供します。Position は、これらのプロパティに対して妥当な値を検証し、それらは以下のプロパティとして公開されます：

• latitudeValid
• longitudeValid
• altitudeValid
• speedValid
• horizontalAccuracyValid
• verticalAccuracyValid

PositionSource 型

Position 型とgeoCoordinate 型がありますが、データはどこから取得されるのでしょうか？代替のソースを指定できることも有用です。たとえば、GPS衛星から直接データを取得する代わりに、データファイルを使用してテストを行うことが望ましい場合もあるでしょう。

PositionSource 型は、プラットフォームが許容する範囲内で、開発者が地理データのソースを制御できるようにします。PositionSource は、NMEAプラグインを含む複数のプラグインをサポートしています。

NMEAは、航行データを指定するための一般的なテキストベースのプロトコルです。PositionSource のNMEAプラグインは、生データファイルやTCPソケットを含む複数のデータソースに対応しています。ソースは、各NMEA文のタイムスタンプに従って更新情報を送信し、記録されたデータの「再生」を実現します。

使用例については、プラグインの説明を参照してください。

衛星情報の例

「Satellite Info」の例では、PositionSource およびSatelliteSource QML タイプを使用して、現在の位置に関連する衛星情報を取得しています。