Freigeben über


Windows.Devices.Geolocation Namespace

Stellt APIs bereit, um den aktuellen Standort zu erhalten oder den Standort des Geräts im Laufe der Zeit nachzuverfolgen. Standortinformationen können aus der Schätzung einer Position von Beacons wie Wi-Fi Zugriffspunkten und Mobilfunkmasten, von der IP-Adresse des Geräts stammen oder aus anderen Quellen wie einem GNSS- oder GPS-Gerät stammen. Die Windows.Devices.Geolocation-API stellt die am besten geeigneten Geolocationdaten aus allen verfügbaren Quellen bereit.

Die Genauigkeit der Standortinformationen hängt von der Quelle ab. Der Breiten- und Längengrad kann innerhalb der folgenden Bereiche variieren:

  • GPS : innerhalb von ca. 10 Metern
  • WLAN: zwischen ca. 30 Metern und 500 Metern
  • Zelltürme: zwischen ca. 300 Metern und 3.000 Metern
  • IP-Adresse: zwischen ca. 1.000 Metern und 5.000 Metern

Zusätzlich zum Breiten- und Längengrad bietet GPS auch Informationen zur Richtung, Geschwindigkeit und Höhe. Diese zusätzlichen Informationen sind optional, wenn die Standortinformationen aus anderen Quellen stammen.

Der Benutzer legt den Schutz seiner Positionsdaten über Datenschutzeinstellungen für den Standort in der App Einstellungen fest. Die App kann nur unter folgenden Voraussetzungen auf die Position des Benutzers zugreifen:

  • Standort für dieses Gerät... ist aktiviert (gilt nicht für Windows 10 Mobile)
  • Die Einstellung Position der Positionsdienste ist aktiviert.
  • Ihre App hat unter Wählen Sie Apps aus, die Ihre Position verwenden dürfen die Einstellung Ein.

Weitere Informationen zum Datenschutz an Speicherorten finden Sie in der Windows-Datenschutzerklärung.

Wichtig

Rufen Sie ab Windows 10 requestAccessAsync auf, bevor Sie auf den Standort des Benutzers zugreifen. Zu diesem Zeitpunkt muss sich Ihre App im Vordergrund befinden, und RequestAccessAsync muss vom UI-Thread aufgerufen werden. Solange der Benutzer Ihrer App keinen Zugriff auf seine Position gewährt hat, kann Ihre App nicht auf Positionsdaten zugreifen.

Architektur von Standortdiensten

Die erste Ebene der Standortdienstarchitektur besteht aus Hardware im Gerät. Dazu gehören der GPS-Empfänger, wlan und der Mobilfunk. Diese können alle als Anbieter von Standortdaten mit unterschiedlichen Genauigkeits- und Stromverbrauchswerten fungieren. Auf der Hardware befindet sich die native Codeebene. Diese Ebene kommuniziert direkt mit den verfügbaren Quellen von Standortdaten und entscheidet, welche Quellen verwendet werden sollen, um den Standort des Geräts basierend auf der Verfügbarkeit der Daten und den von der Anwendung angegebenen Leistungsanforderungen zu bestimmen. Die native Codeebene kommuniziert auch über das Internet mit einem von Microsoft gehosteten Webdienst, um standortbezogene Informationen aus einer Datenbank nachzuschlagen. Die oberste Ebene des Standortdiensts ist die verwaltete Schnittstelle, die über eine DLL verfügbar gemacht wird, die im Windows SDK enthalten ist. Eine App verwendet diese Schnittstelle, um Standortanforderungen zu starten und zu beenden, die für die App erforderliche Genauigkeit festzulegen und Standortdaten von der nativen Codeebene zu empfangen, sobald sie verfügbar wird.

Klassen

CivicAddress

Nicht unterstützte API.

GeoboundingBox

Stellt ein Rechteck dar, das einen geografischen Bereich definiert.

Geocircle

Beschreibt einen geografischen Kreis mit einem Mittelpunkt und einem Radius.

Geocoordinate

Enthält die Informationen zum Identifizieren eines geografischen Standorts.

GeocoordinateSatelliteData

Stellt zusätzliche Informationen zu einer Geokoordinate bereit. Diese Informationen gelten nur für Positionsschätzungen, die mithilfe von Satellitensignalen ermittelt werden.

Geolocator

Ermöglicht den Zugriff auf den aktuellen geografischen Standort.

Geopath

Stellt eine geordnete Reihe von geografischen Punkten dar.

Geopoint

Beschreibt einen geografischen Punkt.

Geoposition

Stellt einen Standort dar, der Breiten- und Längengraddaten oder Veranstaltungsortdaten enthalten kann.

Geovisit

Stellt eine Zustandsänderung im Zusammenhang mit Dem Besuch dar. Informationen zur Verwendung dieses Features finden Sie unter Richtlinien für die Verwendung der Besuchsnachverfolgung .

GeovisitMonitor

Übernimmt die Überwachung der Besuche eines Benutzers, wenn die App verwendet wird (nicht im Hintergrund).

GeovisitStateChangedEventArgs

Enthält Informationen zu einem VisitStateChanged-Ereignis .

GeovisitTriggerDetails

Verwaltet die Details eines Triggers für eine Hintergrundaufgabe im Zusammenhang mit Visits.

PositionChangedEventArgs

Stellt Daten für das PositionChanged-Ereignis bereit .

StatusChangedEventArgs

Stellt Informationen zum StatusChanged-Ereignis bereit.

VenueData

Stellt den Ort dar, der einem geografischen Standort zugeordnet ist.

Strukturen

BasicGeoposition

Die grundlegenden Informationen zur Beschreibung einer geografischen Position.

Schnittstellen

IGeoshape

Schnittstelle zum Definieren einer geografischen Form.

Enumerationen

AltitudeReferenceSystem

Gibt das Höhenreferenzsystem an, das zum Definieren einer geografischen Form verwendet werden soll.

GeolocationAccessStatus

Gibt an, ob Ihre App über die Berechtigung zum Zugriff auf Standortdaten verfügt.

GeoshapeType

Gibt die Form einer geografischen Region an.

PositionAccuracy

Gibt die angeforderte Genauigkeitsstufe für die Standortdaten an, die die Anwendung verwendet.

PositionSource

Gibt die Quelle an, die zum Abrufen einer Geokoordinate verwendet wird.

PositionStatus

Gibt die Fähigkeit des Geolocator-Objekts an, Standortdaten bereitzustellen.

VisitMonitoringScope

Enthält Werte, die den beabsichtigten Bereich der Standortüberwachung für die Verwendung mit dem Visits-Feature beschreiben.

VisitStateChange

Enthält Werte, die eine Zustandsänderung im Zusammenhang mit Dem Besuch beschreiben.

Beispiele

Beispielanwendungen, die Klassen aus diesem Namespace verwenden, umfassen das Geolocation-Beispiel und das Geotag-Beispiel.

Weitere Informationen