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 Platform::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 a cui il Geolocator fornisce gli aggiornamenti della posizione.
DesiredAccuracyInMeters	Ottiene o imposta l'accuratezza desiderata nei contatori per i dati restituiti dal servizio di posizione.
IsDefaultGeopositionRecommended	Indica se l'utente deve essere richiesto di impostare manualmente una posizione predefinita.
LocationStatus	Stato che indica la possibilità di Geolocator di fornire gli aggiornamenti della posizione.
MovementThreshold	Distanza di movimento, in metri, rispetto alla coordinata dell'ultimo evento PositionChanged , necessaria per il Geolocator per generare un evento PositionChanged .
ReportInterval	Intervallo di tempo minimo richiesto tra gli aggiornamenti del percorso, in millisecondi. Se l'applicazione richiede gli aggiornamenti raramente, impostare questo valore in modo che i servizi di posizione possano risparmiare energia calcolando la posizione solo quando necessario.

Metodi

AllowFallbackToConsentlessPositions()	Imposta il geolocatore 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, TimeSpan)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app di 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)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app di 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.
RequestAccessAsync()	Nota Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite. Importante Questa API sarà influenzata dalle modifiche imminenti al comportamento del sistema operativo, pianificato per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi accesso e posizione. Richiede l'autorizzazione per accedere ai dati di posizione.

Eventi

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

Si applica a

Condividi tramite