Compartir a través de


Geolocator Clase

Definición

Proporciona acceso a la ubicación geográfica actual.

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
Herencia
Object Platform::Object IInspectable Geolocator
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones
location ID_CAP_LOCATION [Windows Phone]

Ejemplos

En este ejemplo se muestra cómo usar la clase Geolocator para recuperar la ubicación del dispositivo. Para obtener más información, consulta Obtener la ubicación actual.

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

Comentarios

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 AllowFallbackToConsentlessPositions
1607 14393 DefaultGeoposition
1607 14393 IsDefaultGeopositionRecommended

Constructores

Geolocator()

Inicializa un nuevo objeto Geolocator .

Propiedades

DefaultGeoposition

Obtiene la ubicación especificada manualmente en el sistema por el usuario, que se usará si no existen mejores opciones.

DesiredAccuracy

Nivel de precisión en el que el geolocalización proporciona actualizaciones de ubicación.

DesiredAccuracyInMeters

Obtiene o establece la precisión deseada en medidores para los datos devueltos desde el servicio de ubicación.

IsDefaultGeopositionRecommended

Indica si se debe solicitar al usuario que establezca manualmente una ubicación predeterminada.

LocationStatus

Estado que indica la capacidad del geolocalización para proporcionar actualizaciones de ubicación.

MovementThreshold

Distancia de movimiento, en metros, relativa a la coordenada del último evento PositionChanged , que es necesario para que el Geolocator genere un evento PositionChanged .

ReportInterval

Intervalo de tiempo mínimo solicitado entre las actualizaciones de ubicación, en milisegundos. Si la aplicación requiere actualizaciones con poca frecuencia, establezca este valor para que los servicios de ubicación puedan conservar la energía calculando la ubicación solo cuando sea necesario.

Métodos

AllowFallbackToConsentlessPositions()

Establece el geolocalización para usar la ubicación general como opción de reserva (vea Comentarios).

GetGeopositionAsync()

Inicia una operación asincrónica para recuperar la ubicación actual del dispositivo.

GetGeopositionAsync(TimeSpan, TimeSpan)

Inicia una operación asincrónica para recuperar la ubicación actual del dispositivo.

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

GetGeopositionHistoryAsync(DateTime)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

RequestAccessAsync()

Nota

Parte de la información hace referencia al producto de versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Importante

Esta API se verá afectada por los próximos cambios en el comportamiento del sistema operativo, previsto para la caída de 2024. Para obtener más información, consulte Cambios en el comportamiento de la API para Wi-Fi acceso y ubicación.

Solicita permiso para acceder a los datos de ubicación.

Eventos

PositionChanged

Se genera cuando se actualiza la ubicación.

StatusChanged

Se genera cuando la capacidad del geolocalización para proporcionar cambios de ubicación actualizados.

Se aplica a

Consulte también