Geolocator.GetGeopositionAsync Método

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()

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

• Geoposition
• Geocoordinate
• GetGeopositionAsync(TimeSpan, TimeSpan)
• Obter a localização atual
• exemplo de geolocalização

GetGeopositionAsync(TimeSpan, TimeSpan)

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

• Geoposition
• Geocoordinate
• GetGeopositionAsync()
• Obter a localização atual
• Configurar uma cerca geográfica
• exemplo de geolocalização