Geolocator Clase

Definición

Espacio de nombres:

Windows.Devices.Geolocation

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

public ref class Geolocator sealed

/// [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.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

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)	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, 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.
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.

Consulte también

• Obtener la ubicación actual
• ejemplo de geolocalización
• Ejemplo de Geotag (Windows 10)