Geolocator Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Geolocation

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 l'accesso alla posizione geografica corrente.

public ref class Geolocator sealed

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class Geolocator final

/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class Geolocator

[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

Ereditarietà: Object IInspectable Geolocator

Attributi: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	location ID_CAP_LOCATION [Windows Phone]

Esempio

In questo esempio viene illustrato come usare la classe Geolocator per recuperare la posizione del dispositivo. Per altre info, vedi Ottenere la posizione corrente.

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;
}

Commenti

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	AllowFallbackToConsentlessPositions
1607	14393	DefaultGeoposition
1607	14393	IsDefaultGeopositionRecommended

Costruttori

Geolocator()

Inizializza un nuovo oggetto Geolocator.

Proprietà

DefaultGeoposition	Ottiene la posizione immessa manualmente nel sistema dall'utente, da usare se non esistono opzioni migliori.
DesiredAccuracy	Livello di accuratezza in base al quale fornisce Geolocator gli aggiornamenti della posizione.
DesiredAccuracyInMeters	Ottiene o imposta l'accuratezza desiderata nei contatori per i dati restituiti dal servizio di posizione.
IsDefaultGeopositionRecommended	Indica se all'utente deve essere richiesto di impostare manualmente un percorso predefinito.
LocationStatus	Stato che indica la possibilità di Geolocator fornire gli aggiornamenti della posizione.
MovementThreshold	Distanza di movimento, in metri, rispetto alla coordinata dell'ultimo PositionChanged evento, necessaria per Geolocator generare un PositionChanged evento.
ReportInterval	Intervallo di tempo minimo richiesto tra gli aggiornamenti della posizione, espresso in millisecondi. Se l'applicazione richiede aggiornamenti raramente, impostare questo valore in modo che i servizi di posizione possano risparmiare energia calcolando la posizione solo quando necessario.

Metodi

AllowFallbackToConsentlessPositions()	Imposta l'oggetto Geolocator per usare la posizione grossolana come opzione di fallback (vedere Osservazioni).
GetGeopositionAsync()	Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.
GetGeopositionAsync(TimeSpan, TimeSpan)	Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.
GetGeopositionHistoryAsync(DateTime)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app Windows. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app Windows. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
RequestAccessAsync()	Richiede l'autorizzazione per accedere ai dati della posizione.

Eventi

PositionChanged	Generato quando viene aggiornata la posizione.
StatusChanged	Generato quando la possibilità di Geolocator fornire modifiche alla posizione aggiornate.

Si applica a