Freigeben über


Geolocator Klasse

Definition

Bietet Zugriff auf den aktuellen geografischen Standort.

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
Vererbung
Object Platform::Object IInspectable Geolocator
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen
location ID_CAP_LOCATION [Windows Phone]

Beispiele

In diesem Beispiel wird gezeigt, wie Sie die Geolocator-Klasse verwenden, um den Standort des Geräts abzurufen. Weitere Informationen finden Sie unter Abrufen des aktuellen Standorts.

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;
}

Hinweise

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1607 14393 AllowFallbackToConsentlessPositions
1607 14393 DefaultGeoposition
1607 14393 IsDefaultGeopositionRecommended

Konstruktoren

Geolocator()

Initialisiert ein neues Geolocator-Objekt .

Eigenschaften

DefaultGeoposition

Ruft den Vom Benutzer manuell in das System eingegebenen Speicherort ab, der verwendet werden soll, wenn keine besseren Optionen vorhanden sind.

DesiredAccuracy

Die Genauigkeitsstufe, mit der der Geolocator Standortupdates bereitstellt.

DesiredAccuracyInMeters

Ruft die gewünschte Genauigkeit in Metern für daten ab, die vom Standortdienst zurückgegeben werden, oder legt diese fest.

IsDefaultGeopositionRecommended

Gibt an, ob der Benutzer aufgefordert werden soll, einen Standardspeicherort manuell festzulegen.

LocationStatus

Die status, die die Fähigkeit des Geolocators angibt, Standortupdates bereitzustellen.

MovementThreshold

Der Abstand der Bewegung in Metern relativ zur Koordinate vom letzten PositionChanged-Ereignis , der erforderlich ist, damit der Geolocator ein PositionChanged-Ereignis auslösen kann.

ReportInterval

Das angeforderte mindeste Zeitintervall zwischen Standortupdates in Millisekunden. Wenn Ihre Anwendung selten Updates erfordert, legen Sie diesen Wert fest, damit Standortdienste Strom sparen können, indem sie den Standort nur bei Bedarf berechnen.

Methoden

AllowFallbackToConsentlessPositions()

Legt den Geolocator so fest, dass die grobe Position als Fallbackoption verwendet wird (siehe Hinweise).

GetGeopositionAsync()

Startet einen asynchronen Vorgang, um den aktuellen Standort des Geräts abzurufen.

GetGeopositionAsync(TimeSpan, TimeSpan)

Startet einen asynchronen Vorgang, um den aktuellen Standort des Geräts abzurufen.

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen.

Hinweis

Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

GetGeopositionHistoryAsync(DateTime)

Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen.

Hinweis

Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

RequestAccessAsync()

Hinweis

Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wichtig

Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort.

Fordert die Berechtigung für den Zugriff auf Standortdaten an.

Ereignisse

PositionChanged

Wird ausgelöst, wenn der Speicherort aktualisiert wird.

StatusChanged

Wird ausgelöst, wenn die Möglichkeit des Geolocators , aktualisierte Speicherorte bereitzustellen, geändert wird.

Gilt für:

Weitere Informationen