Geolocator クラス

定義

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

public ref class Geolocator sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class Geolocator final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class Geolocator
[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
属性

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

GeolocatorPositionChanged イベントを発生させるために必要な、最後の PositionChanged イベントからの座標に対する移動距離 (メートル単位)。

ReportInterval

場所の更新の間に要求された最小時間間隔 (ミリ秒単位)。 アプリケーションで更新が必要な頻度が低い場合は、位置情報サービスが必要な場合にのみ場所を計算することで電力を節約できるように、この値を設定します。

メソッド

AllowFallbackToConsentlessPositions()

フォールバック オプションとして粗い場所を使用するように Geolocator を設定します (「解説」を参照)。

GetGeopositionAsync()

デバイスの現在の場所を取得する非同期操作を開始します。

GetGeopositionAsync(TimeSpan, TimeSpan)

デバイスの現在の場所を取得する非同期操作を開始します。

GetGeopositionHistoryAsync(DateTime)

デバイスの場所履歴を取得する非同期操作を開始します。

注意

この API は、すべての Windows アプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

GetGeopositionHistoryAsync(DateTime, TimeSpan)

デバイスの場所履歴を取得する非同期操作を開始します。

注意

この API は、すべての Windows アプリで使用できるわけではありません。 開発者アカウントが Microsoft によって特別にプロビジョニングされていない限り、これらの API の呼び出しは実行時に失敗します。

RequestAccessAsync()

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

位置情報データにアクセスするためのアクセス許可を要求します。

イベント

PositionChanged

場所が更新されたときに発生します。

StatusChanged

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

適用対象

こちらもご覧ください