Compartir a través de


Geolocator.GetGeopositionAsync Método

Definición

Sobrecargas

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.

GetGeopositionAsync()

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync() = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync();
[Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync();
function getGeopositionAsync()
Public Function GetGeopositionAsync () As IAsyncOperation(Of Geoposition)

Devoluciones

Una operación asincrónica que, al finalizar, devuelve una geoposición que marca la ubicación encontrada.

Atributos

Requisitos de Windows

Características de aplicaciones
location ID_CAP_LOCATION [Windows Phone]

Comentarios

Este método produce una excepción si la aplicación no tiene permisos de ubicación o si agota el tiempo de espera sin recuperar datos de ubicación. Por lo tanto, se debe llamar al método dentro de una instrucción try/catch para que se puedan controlar estos casos de excepción comunes.

Este método agota el tiempo de espera después de 60 segundos, excepto cuando se encuentra en modo de espera conectado. Durante la espera conectada, se pueden crear instancias de objetos Geolocator , pero el objeto Geolocator no encontrará ningún sensor para agregar y las llamadas a GetGeopositionAsync agotarán el tiempo de espera después de 7 segundos. Cuando se agote el tiempo de espera, se llamará a los agentes de escucha de eventos StatusChanged una vez con el estado NoData y nunca se llamará a los agentes de escucha de eventos PositionChanged .

El usuario establece la privacidad de sus datos de ubicación con la configuración de privacidad de ubicación en la aplicación Configuración. La aplicación puede acceder a la ubicación del usuario solo cuando:

  • Ubicación para este dispositivo... está activado (no aplicable a Windows 10 Mobile)
  • La configuración de servicios de ubicación, "Ubicación", está activada
  • En Elegir las aplicaciones que pueden usar tu ubicación, la aplicación está establecida en el valor activado

Importante

A partir de Windows 10, llame al método RequestAccessAsync antes de acceder a la ubicación del usuario. En ese momento, la aplicación debe estar en primer plano y se debe llamar a RequestAccessAsync desde el subproceso de la interfaz de usuario. Después, la aplicación puede controlar el caso sin permisos sin iniciar una excepción.

Consulte también

Se aplica a

GetGeopositionAsync(TimeSpan, TimeSpan)

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync(TimeSpan maximumAge, TimeSpan timeout) = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync(TimeSpan const& maximumAge, TimeSpan const& timeout);
[Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync(System.TimeSpan maximumAge, System.TimeSpan timeout);
function getGeopositionAsync(maximumAge, timeout)
Public Function GetGeopositionAsync (maximumAge As TimeSpan, timeout As TimeSpan) As IAsyncOperation(Of Geoposition)

Parámetros

maximumAge
TimeSpan TimeSpan

Antigüedad máxima aceptable de los datos de ubicación almacenados en caché. TimeSpan es un período de tiempo expresado en unidades de 100 nanosegundos.

timeout
TimeSpan TimeSpan

Tiempo de espera. TimeSpan es un período de tiempo expresado en unidades de 100 nanosegundos.

Devoluciones

Una operación asincrónica que, al finalizar, devuelve una geoposición que marca la ubicación encontrada.

Atributos

Requisitos de Windows

Características de aplicaciones
location ID_CAP_LOCATION [Windows Phone]

Comentarios

Una ubicación se devolverá inmediatamente si la ubicación más reciente tiene una antigüedad aceptable. De lo contrario, no se devolverá una ubicación hasta el siguiente cambio. En algunos casos, la aplicación puede recibir datos de ubicación anteriores al valor maximumAge especificado. Esto se debe a que se calculará un valor de antigüedad adicional en función de la configuración de precisión deseada y la aplicación usará cualquier edad que sea mayor. Por ejemplo, supongamos que una precisión predeterminada de 500 metros corresponde a una antigüedad máxima de 30 segundos. En ese caso, la aplicación podría recibir 20 segundos de datos antiguos aunque establezca maximumAge en 10 segundos.

Consulte también

Se aplica a