Geolocator クラス

定義

名前空間:

Windows.Devices.Geolocation

現在の地理的な場所へのアクセスを提供します。

public ref class Geolocator sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Geolocator final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Geolocator

function Geolocator()

Public NotInheritable Class Geolocator

継承

Object Platform::Object IInspectable Geolocator

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能	location ID_CAP_LOCATION [Windows Phone]

例

この例では、Geolocator クラスを使用してデバイスの場所を取得する方法を示します。 詳しくは、「現在の位置情報の取得」をご覧ください。

using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();
switch (accessStatus)
{
    case GeolocationAccessStatus.Allowed:
        // notify user: Waiting for update

        // If DesiredAccuracy or DesiredAccuracyInMeters are not set (or value is 0), DesiredAccuracy.Default is used.
        Geolocator geolocator = new Geolocator { DesiredAccuracyInMeters = _desireAccuracyInMetersValue };

        // Subscribe to StatusChanged event to get updates of location status changes
        _geolocator.StatusChanged += OnStatusChanged;

        // Carry out the operation
        Geoposition pos = await geolocator.GetGeopositionAsync();

        UpdateLocationData(pos);
        // notify user: Location updated
        break;

    case GeolocationAccessStatus.Denied:
        // notify user: Access to location is denied

        break;

    case GeolocationAccessStatus.Unspecified:
        // notify user: Unspecified error
        break;
}

注釈

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	AllowFallbackToConsentlessPositions
1607	14393	DefaultGeoposition
1607	14393	IsDefaultGeopositionRecommended

コンストラクター

Geolocator()

新しい Geolocator オブジェクトを初期化します。

プロパティ

DefaultGeoposition	ユーザーがシステムに手動で入力した場所を取得し、より優れたオプションが存在しない場合に使用します。
DesiredAccuracy	Geolocator が場所の更新を提供する精度レベル。
DesiredAccuracyInMeters	位置情報サービスから返されるデータの必要な精度をメートル単位で取得または設定します。
IsDefaultGeopositionRecommended	既定の場所を手動で設定するようにユーザーに求めるメッセージを表示するかどうかを示します。
LocationStatus	位置情報の更新を提供する Geolocator の機能を示す状態。
MovementThreshold	Geolocator が PositionChanged イベントを発生させるために必要な、最後の PositionChanged イベントからの座標に対する移動距離 (メートル単位)。
ReportInterval	場所の更新の間に要求された最小時間間隔 (ミリ秒単位)。 アプリケーションで更新が必要な頻度が低い場合は、位置情報サービスが必要な場合にのみ場所を計算することで電力を節約できるように、この値を設定します。

メソッド

AllowFallbackToConsentlessPositions()	フォールバック オプションとして粗い場所を使用するように Geolocator を設定します (「解説」を参照)。
GetGeopositionAsync()	デバイスの現在の場所を取得する非同期操作を開始します。
GetGeopositionAsync(TimeSpan, TimeSpan)	デバイスの現在の場所を取得する非同期操作を開始します。
GetGeopositionHistoryAsync(DateTime, TimeSpan)	デバイスの場所履歴を取得する非同期操作を開始します。 注意 この API は、すべての Windows アプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
GetGeopositionHistoryAsync(DateTime)	デバイスの場所履歴を取得する非同期操作を開始します。 注意 この API は、すべての Windows アプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。
RequestAccessAsync()	注意 一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。 重要 この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。 位置情報データにアクセスするためのアクセス許可を要求します。

イベント

PositionChanged	場所が更新されたときに発生します。
StatusChanged	Geolocator が更新された場所を提供する機能が変更されたときに発生します。

こちらもご覧ください

• 現在の位置情報の取得
• 位置情報サンプル
• geotag サンプル (Windows 10)