Geolocator.GetGeopositionAsync Método

  • Referência

Definição

Namespace:
Windows.Devices.Geolocation

Sobrecargas

GetGeopositionAsync()

Inicia uma operação assíncrona para recuperar o local atual do dispositivo.
GetGeopositionAsync(TimeSpan, TimeSpan)

Inicia uma operação assíncrona para recuperar o local atual do dispositivo.

GetGeopositionAsync()

Editar

Inicia uma operação assíncrona para recuperar o local atual do 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)

Retornos

IAsyncOperation<Geoposition>

Uma operação assíncrona que, após a conclusão, retorna uma Geoposição marcando o local encontrado.

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo
location ID_CAP_LOCATION [Windows Phone]

Comentários

Esse método gerará uma exceção se o aplicativo não tiver permissões de localização ou se atingir o tempo limite sem dados de localização recuperados. Portanto, o método deve ser chamado dentro de uma instrução try/catch para que esses casos comuns de exceção possam ser tratados.

Esse método atinge o tempo limite após 60 segundos, exceto quando em Espera Conectada. Durante o Modo de Espera Conectado, os objetos Geolocator podem ser instanciados, mas o objeto Geolocator não encontrará sensores para agregação e as chamadas para GetGeopositionAsync atingirão o tempo limite após 7 segundos. Após o tempo limite, os ouvintes de eventos StatusChanged serão chamados uma vez com o status NoData e os ouvintes de eventos PositionChanged nunca serão chamados.

O usuário define a privacidade de seus dados de localização com as configurações de privacidade de localização no aplicativo Configurações. Seu aplicativo só pode acessar a localização do usuário quando:

  • Local para este dispositivo... está ativado (não aplicável a Windows 10 Mobile)
  • A configuração de serviços de localização, Localização, está ativada
  • Em Escolher aplicativos que podem usar sua localização, seu aplicativo está definido como ativado

Importante

A partir do Windows 10, chame o método RequestAccessAsync antes de acessar a localização do usuário. Nesse momento, seu aplicativo deve estar em primeiro plano e RequestAccessAsync deve ser chamado do thread da interface do usuário. Em seguida, seu aplicativo pode lidar com o caso sem permissões sem gerar uma exceção.

Confira também

Aplica-se a

GetGeopositionAsync(TimeSpan, TimeSpan)

Editar

Inicia uma operação assíncrona para recuperar o local atual do 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

A idade máxima aceitável dos dados de localização armazenados em cache. Um TimeSpan é um período expresso em unidades de 100 nanossegundos.

timeout
TimeSpan TimeSpan

O tempo limite. Um TimeSpan é um período expresso em unidades de 100 nanossegundos.

Retornos

IAsyncOperation<Geoposition>

Uma operação assíncrona que, após a conclusão, retorna uma Geoposição marcando o local encontrado.

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo
location ID_CAP_LOCATION [Windows Phone]

Comentários

Um local será retornado imediatamente se o local mais recente estiver dentro de uma idade aceitável. Caso contrário, um local não será retornado até a próxima alteração. Em alguns casos, seu aplicativo pode receber dados de localização mais antigos do que o valor maximumAge especificado. Isso ocorre porque um valor de idade adicional será calculado com base na configuração de precisão desejada e seu aplicativo usará qualquer uma das duas idades maior. Por exemplo, digamos que uma precisão padrão de 500 metros corresponda a uma idade máxima de 30 segundos. Nesse caso, seu aplicativo pode receber 20 segundos de dados antigos, mesmo se você definir maximumAge como 10 segundos.

Confira também

Aplica-se a