Geolocator Klasse

Definition

Namespace:

Windows.Devices.Geolocation

Bietet Zugriff auf den aktuellen geografischen Standort.

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

Vererbung

Object Platform::Object IInspectable Geolocator

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)	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, 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.
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.

Weitere Informationen

• Abrufen der aktuellen Position
• Beispiel für Geolocation
• Geotag-Beispiel (Windows 10)