Windows.Devices.Geolocation 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の場所を 取得 したり、時間の経過と同時にデバイスの場所を追跡したりするための API を提供します。 位置情報は、Wi-Fiアクセス ポイントやセル タワーなどのビーコンから、デバイスの IP アドレスから位置を推定することや、GNSS や GPS デバイスなどの他のソースから取得される場合があります。 Windows.Devices.Geolocation API は、使用可能なすべてのソースから最も適切な位置情報データを提供します。
位置情報の精度はソースによって異なります。 緯度と経度は、次の範囲内で異なる場合があります。
- GPS: 約 10 メートル以内
- Wi-Fi: 約 30 メートルから 500 メートルの間
- セルタワー: 約300メートルから3,000メートルの間
- IP アドレス: 約 1,000 メートルから 5,000 メートルの間
GPS では、緯度と経度に加えて、見出し、速度、高度に関する情報も提供されます。 位置情報が他のソースから取得される場合、この追加情報は省略可能です。
ユーザーが設定アプリの位置情報に関するプライバシー設定で位置情報に関するプライバシーを設定します。 次の場合にのみ、アプリでユーザーの位置情報にアクセスできます。
- このデバイスの場所...がオンになっている (Windows 10 Mobileには適用されません)
- 位置情報サービス設定の [位置情報] が オン になっている
- [位置情報を使うことができるアプリを選ぶ] で、アプリが オン になっている
場所のプライバシーの詳細については、「 Windows プライバシーに関する声明」を参照してください。
重要
Windows 10以降では、ユーザーの場所にアクセスする前に RequestAccessAsync を呼び出します。 このときに、アプリをフォアグラウンドで実行し、RequestAccessAsync を UI スレッドから呼び出す必要があります。 位置情報に対するアクセス許可をユーザーがアプリに与えるまで、アプリは位置情報にアクセスできません。
位置情報サービスのアーキテクチャ
Location Services アーキテクチャの最初のレイヤーは、デバイス内のハードウェアで構成されます。 これには、GPS 受信機、Wi-Fi、携帯ラジオが含まれます。 これらはすべて、精度と消費電力のレベルが異なる場所データのプロバイダーとして機能します。 ハードウェアの上には、ネイティブ コード レイヤーが配置されます。 このレイヤーは、使用可能な場所データのソースと直接通信し、データの可用性とアプリケーションで指定されたパフォーマンス要件に基づいて、デバイスの場所を決定するために使用するソースを決定します。 ネイティブ コード レイヤーは、Microsoft ホスト型 Web サービスとインターネット経由で通信して、データベースから場所に関連する情報を検索します。 ロケーション サービスの最上位レイヤーは、Windows SDK に含まれる DLL を介して公開されるマネージド インターフェイスです。 アプリでは、このインターフェイスを使用して、場所要求を開始および停止し、アプリに必要な精度のレベルを設定し、ネイティブ コード レイヤーから使用可能になったときに場所データを受信します。
クラス
| CivicAddress |
サポートされていない API。 |
| GeoboundingBox |
地理的領域を定義する四角形を表します。 |
| Geocircle |
中心点と半径を持つ地理的な円について説明します。 |
| Geocoordinate |
地理的な場所を識別するための情報が含まれます。 |
| GeocoordinateSatelliteData |
ジオ座標に関する追加情報を提供します。 この情報は、衛星信号を使用して取得した位置推定にのみ適用されます。 |
| Geolocator |
現在の地理的な場所へのアクセスを提供します。 |
| Geopath |
順序付けられた一連の地理的ポイントを表します。 |
| Geopoint |
地理的なポイントについて説明します。 |
| Geoposition |
緯度と経度のデータまたは会場データを含む可能性のある場所を表します。 |
| Geovisit |
Visit 関連の状態変更を表します。 この機能 の使用方法については、「訪問の追跡を使用するためのガイドライン 」を参照してください。 |
| GeovisitMonitor |
アプリが (バックグラウンドではなく) 使用中のユーザーの訪問の監視を処理します。 |
| GeovisitStateChangedEventArgs |
VisitStateChanged イベントに関する情報が含まれています。 |
| GeovisitTriggerDetails |
訪問関連のバックグラウンド タスクのトリガーの詳細を管理します。 |
| PositionChangedEventArgs |
PositionChanged イベントのデータを提供します。 |
| StatusChangedEventArgs |
StatusChanged イベントの情報を提供します。 |
| VenueData |
地理的な場所に関連付けられている会場を表します。 |
構造体
| BasicGeoposition |
地理的位置を表す基本情報。 |
インターフェイス
| IGeoshape |
地理的図形を定義するためのインターフェイス。 |
列挙型
| AltitudeReferenceSystem |
地理的図形の定義に使用する高度参照システムを示します。 |
| GeolocationAccessStatus |
アプリに位置情報データにアクセスするアクセス許可があるかどうかを示します。 |
| GeoshapeType |
地理的リージョンの形状を示します。 |
| PositionAccuracy |
アプリケーションが使用する場所データに対して要求された精度レベルを示します。 |
| PositionSource |
ジオ座標の取得に使用されるソースを示します。 |
| PositionStatus |
位置情報データを提供する Geolocator オブジェクトの機能を示します。 |
| VisitMonitoringScope |
訪問機能で使用する場所監視の対象範囲を表す値が含まれます。 |
| VisitStateChange |
Visit 関連の状態変更を記述する値が含まれます。 |
例
この名前空間のクラスを使用するサンプル アプリケーションには、 Geolocation サンプル と Geotag サンプルが含まれます。