Windows.Devices.Geolocation Spazio dei nomi

Riferimento

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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.