Windows.Devices.Geolocation Spazio dei nomi
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.
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.