Condividi tramite


Windows.Devices.Geolocation Spazio dei nomi

Fornisce API per ottenere la posizione corrente o tenere traccia della posizione del dispositivo nel tempo. Le informazioni sulla posizione possono derivare dalla stima di una posizione da beacon come Wi-Fi punti di accesso e torri di cella, dall'indirizzo IP del dispositivo o provenienti da altre origini, ad esempio un dispositivo GNSS o GPS. L'API Windows.Devices.Geolocation fornisce i dati di georilevazione più appropriati da tutte le origini disponibili.

L'accuratezza delle informazioni sulla posizione dipende dall'origine. La latitudine e longitudine possono variare all'interno degli intervalli seguenti:

  • GPS : entro circa 10 metri
  • Wi-Fi : tra circa 30 metri e 500 metri
  • Torri cellulari : tra circa 300 metri e 3.000 metri
  • Indirizzo IP: tra circa 1.000 metri e 5.000 metri

Oltre alla latitudine e alla longitudine, GPS fornisce anche informazioni su intestazione, velocità e altitudine. Queste informazioni aggiuntive sono facoltative quando le informazioni sulla posizione provengono da altre origini.

L'utente imposta la privacy dei dati relativi alla posizione tramite le impostazioni di privacy per la posizione nell'app Impostazioni. La tua app può accedere alla posizione dell'utente solo quando:

  • Posizione per questo dispositivo... è attivato (non applicabile a Windows 10 Mobile)
  • L’impostazione dei servizi di posizione, Posizione, è attivata
  • In Scegli le app che possono usare la tua posizione, la tua app è attivata

Per altre informazioni sulla privacy della posizione, vedere l'Informativa sulla privacy di Windows.

Importante

A partire da Windows 10, chiamare RequestAccessAsync prima di accedere alla posizione dell'utente. A questo punto, l’app deve essere in primo piano e RequestAccessAsync deve essere chiamato dal thread dell’interfaccia utente. L'app può accedere ai dati sulla posizione solo dopo che l'utente ha concesso all'app l'autorizzazione per la propria posizione.

Architettura dei servizi di posizione

Il primo livello dell'architettura dei servizi di posizione è costituito dall'hardware nel dispositivo. Questo include il ricevitore GPS, Wi-Fi e la radio cellulare. Questi possono funzionare tutti come provider di dati di posizione con diversi livelli di accuratezza e consumo energetico. Sopra l'hardware si trova il livello di codice nativo. Questo livello comunica direttamente con le origini disponibili dei dati di posizione e decide quali origini usare per determinare la posizione del dispositivo in base alla disponibilità dei dati e ai requisiti di prestazioni specificati dall'applicazione. Il livello di codice nativo comunica anche tramite Internet con un servizio Web ospitato da Microsoft per cercare informazioni correlate alla posizione da un database. Il livello superiore del servizio di posizione è l'interfaccia gestita, esposta tramite una DLL inclusa in Windows SDK. Un'app usa questa interfaccia per avviare e arrestare le richieste di posizione, per impostare il livello di accuratezza richiesto dall'app e per ricevere i dati sulla posizione dal livello di codice nativo non appena diventa disponibile.

Classi

CivicAddress

API non supportata.

GeoboundingBox

Rappresenta un rettangolo che definisce un'area geografica.

Geocircle

Descrive un cerchio geografico con un punto centrale e un raggio.

Geocoordinate

Contiene le informazioni per identificare una posizione geografica.

GeocoordinateSatelliteData

Fornisce informazioni aggiuntive su un geocoordinato. Queste informazioni sono applicabili solo alle stime della posizione ottenute usando i segnali satellite.

Geolocator

Fornisce l'accesso alla posizione geografica corrente.

Geopath

Rappresenta una serie ordinata di punti geografici.

Geopoint

Descrive un punto geografico.

Geoposition

Rappresenta una posizione che può contenere dati di latitudine e longitudine o dati della sede.

Geovisit

Rappresenta una modifica dello stato correlata a Visit. Per informazioni su come usare questa funzionalità, vedere Linee guida per l'uso di Visite.

GeovisitMonitor

Gestisce il monitoraggio delle visite di un utente quando l'app è in uso (non in background).

GeovisitStateChangedEventArgs

Contiene informazioni su un evento VisitStateChanged .

GeovisitTriggerDetails

Gestisce i dettagli di un trigger per un'attività in background relativa alle visite.

PositionChangedEventArgs

Fornisce i dati per l'evento PositionChanged .

StatusChangedEventArgs

Fornisce informazioni per l'evento StatusChanged .

VenueData

Rappresenta la sede associata a una posizione geografica.

Struct

BasicGeoposition

Informazioni di base per descrivere una posizione geografica.

Interfacce

IGeoshape

Interfaccia per definire una forma geografica.

Enumerazioni

AltitudeReferenceSystem

Indica il sistema di riferimento per l'altitudine da usare per definire una forma geografica.

GeolocationAccessStatus

Indica se l'app dispone dell'autorizzazione per accedere ai dati di posizione.

GeoshapeType

Indica la forma di un'area geografica.

PositionAccuracy

Indica il livello di accuratezza richiesto per i dati di posizione usati dall'applicazione.

PositionSource

Indica l'origine usata per ottenere un geocoordinato.

PositionStatus

Indica la possibilità dell'oggetto Geolocator di fornire i dati di posizione.

VisitMonitoringScope

Contiene valori che descrivono l'ambito previsto del monitoraggio della posizione da usare con la funzionalità Visite.

VisitStateChange

Contiene valori che descrivono una modifica dello stato correlata a Visit.

Esempio

Le applicazioni di esempio che usano classi di questo spazio dei nomi includono l'esempio geolocation e l'esempio Geotag.

Vedi anche