Obter a localização do usuário
Observação
MapControl e os serviços de mapa exigem uma chave de autenticação de mapas chamada MapServiceToken. Para saber mais sobre como obter e definir uma chave de autenticação de mapas, consulte Solicitar uma chave de autenticação de mapas.
Encontre a localização do usuário e responda a alterações na localização. O acesso à localização do usuário é gerenciado por configurações de privacidade no aplicativo Configurações. Este tópico também mostra como verificar se o aplicativo tem permissão para acessar a localização do usuário.
Dica Para saber mais sobre como acessar a localização do usuário em seu aplicativo, baixe a seguinte amostra do repositório Windows-universal-samples no GitHub.
Habilitar a funcionalidade de localização
- No Gerenciador de Soluções, clique duas vezes sobre package.appxmanifest e selecione a guia Funcionalidades.
- Na lista Recursos, marque a caixa de Local. Isso adiciona a funcionalidade
location
do dispositivo ao arquivo de manifesto do pacote.
<Capabilities>
<!-- DeviceCapability elements must follow Capability elements (if present) -->
<DeviceCapability Name="location"/>
</Capabilities>
Obter a localização atual
Esta seção descreve como detectar a localização geográfica do usuário usando APIs no namespace Windows.Devices.Geolocation.
Etapa 1: Solicitar acesso ao local do usuário
A menos que seu aplicativo tenha a funcionalidade de localização grosseira (veja a observação), você deve solicitar acesso à localização do usuário usando o método RequestAccessAsync antes de tentar acessar o local. É necessário chamar o método RequestAccessAsync no thread da interface do usuário e o aplicativo deve estar em segundo plano. Seu aplicativo não poderá acessar as informações de localização do usuário até que o usuário conceda permissão ao seu aplicativo.*
using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();
O método RequestAccessAsync solicita ao usuário permissão para acessar o local. O usuário é solicitado apenas uma vez (por aplicativo). Após a primeira vez em que a permissão é concedida ou negada, esse método deixa de solicitar a permissão ao usuário. Para ajudar o usuário a alterar as permissões de localização depois que elas tiverem sido solicitadas, é recomendável fornecer um link para as configurações de localização, conforme demonstrado mais adiante neste tópico.
Observação: o recurso de localização grosseira permite que seu aplicativo obtenha um local intencionalmente ofuscado (impreciso) sem obter a permissão explícita do usuário (a opção de localização em todo o sistema ainda deve estar ativada). Para saber como utilizar a localização grosseira em seu aplicativo, consulte o método AllowFallbackToConsentlessPositions na classe Geolocator .
Etapa 2: obtenha a localização do usuário e registre as alterações nas permissões de localização
O método GetGeopositionAsync realiza uma leitura única da localização atual. Aqui, uma instrução switch é usada com accessStatus (do exemplo anterior) para atuar somente quando o acesso à localização do usuário é permitido. Se o acesso à localização do usuário for permitido, o código cria um objeto Geolocator, registra as alterações nas permissões de localização e solicita a localização do usuário.
switch (accessStatus)
{
case GeolocationAccessStatus.Allowed:
_rootPage.NotifyUser("Waiting for update...", NotifyType.StatusMessage);
// If DesiredAccuracy or DesiredAccuracyInMeters are not set (or value is 0), DesiredAccuracy.Default is used.
Geolocator geolocator = new Geolocator { DesiredAccuracyInMeters = _desireAccuracyInMetersValue };
// Subscribe to the StatusChanged event to get updates of location status changes.
_geolocator.StatusChanged += OnStatusChanged;
// Carry out the operation.
Geoposition pos = await geolocator.GetGeopositionAsync();
UpdateLocationData(pos);
_rootPage.NotifyUser("Location updated.", NotifyType.StatusMessage);
break;
case GeolocationAccessStatus.Denied:
_rootPage.NotifyUser("Access to location is denied.", NotifyType.ErrorMessage);
LocationDisabledMessage.Visibility = Visibility.Visible;
UpdateLocationData(null);
break;
case GeolocationAccessStatus.Unspecified:
_rootPage.NotifyUser("Unspecified error.", NotifyType.ErrorMessage);
UpdateLocationData(null);
break;
}
Etapa 3: lide com as alterações nas permissões de localização
O objeto Geolocator aciona o evento StatusChanged para indicar que as configurações de localização do usuário foram alteradas. Esse evento transmite o status correspondente por meio da propriedade Status do argumento (do tipo PositionStatus). Observe que esse método não é chamado a partir do thread de interface do usuário, e que o objeto Dispatcher invoca as alterações na interface do usuário.
using Windows.UI.Core;
...
async private void OnStatusChanged(Geolocator sender, StatusChangedEventArgs e)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
// Show the location setting message only if status is disabled.
LocationDisabledMessage.Visibility = Visibility.Collapsed;
switch (e.Status)
{
case PositionStatus.Ready:
// Location platform is providing valid data.
ScenarioOutput_Status.Text = "Ready";
_rootPage.NotifyUser("Location platform is ready.", NotifyType.StatusMessage);
break;
case PositionStatus.Initializing:
// Location platform is attempting to acquire a fix.
ScenarioOutput_Status.Text = "Initializing";
_rootPage.NotifyUser("Location platform is attempting to obtain a position.", NotifyType.StatusMessage);
break;
case PositionStatus.NoData:
// Location platform could not obtain location data.
ScenarioOutput_Status.Text = "No data";
_rootPage.NotifyUser("Not able to determine the location.", NotifyType.ErrorMessage);
break;
case PositionStatus.Disabled:
// The permission to access location data is denied by the user or other policies.
ScenarioOutput_Status.Text = "Disabled";
_rootPage.NotifyUser("Access to location is denied.", NotifyType.ErrorMessage);
// Show message to the user to go to location settings.
LocationDisabledMessage.Visibility = Visibility.Visible;
// Clear any cached location data.
UpdateLocationData(null);
break;
case PositionStatus.NotInitialized:
// The location platform is not initialized. This indicates that the application
// has not made a request for location data.
ScenarioOutput_Status.Text = "Not initialized";
_rootPage.NotifyUser("No request for location is made yet.", NotifyType.StatusMessage);
break;
case PositionStatus.NotAvailable:
// The location platform is not available on this version of the OS.
ScenarioOutput_Status.Text = "Not available";
_rootPage.NotifyUser("Location is not available on this version of the OS.", NotifyType.ErrorMessage);
break;
default:
ScenarioOutput_Status.Text = "Unknown";
_rootPage.NotifyUser(string.Empty, NotifyType.StatusMessage);
break;
}
});
}
Responder a atualizações de localização
Esta seção descreve como usar o evento PositionChanged para receber atualizações sobre a localização do usuário durante um intervalo de tempo. Como o usuário pode revogar o acesso a localização a qualquer momento, é importante chamar RequestAccessAsync e usar o evento StatusChanged como mostrados na seção anterior.
Esta seção presume que você já habilitou os recursos de localização e chamou RequestAccessAsync a partir do thread de interface do usuário em seu aplicativo em segundo plano.
Etapa 1: defina o intervalo de relatório e registre as atualizações de localização
Neste exemplo, uma instrução switch é usada com accessStatus (do exemplo anterior) para atuar somente quando o acesso à localização do usuário é permitido. Se o acesso à localização do usuário for permitido, o código cria um objeto Geolocator, especifica o tipo de rastreamento e registra as atualizações de localização.
O objeto Geolocator pode acionar o evento PositionChanged com base em uma alteração na posição (rastreamento com base em distância) ou uma alteração em um período (rastreamento periódico).
- Para o rastreamento com base em distância, configure a propriedade MovementThreshold.
- Para o rastreamento periódico, configure a propriedade ReportInterval.
Se nenhuma das propriedades for definida, será retornada uma posição a cada segundo (equivalente a ReportInterval = 1000
). Aqui, é usado um intervalo de relatório de dois segundos (ReportInterval = 2000
).
using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();
switch (accessStatus)
{
case GeolocationAccessStatus.Allowed:
// Create Geolocator and define perodic-based tracking (2 second interval).
_geolocator = new Geolocator { ReportInterval = 2000 };
// Subscribe to the PositionChanged event to get location updates.
_geolocator.PositionChanged += OnPositionChanged;
// Subscribe to StatusChanged event to get updates of location status changes.
_geolocator.StatusChanged += OnStatusChanged;
_rootPage.NotifyUser("Waiting for update...", NotifyType.StatusMessage);
LocationDisabledMessage.Visibility = Visibility.Collapsed;
StartTrackingButton.IsEnabled = false;
StopTrackingButton.IsEnabled = true;
break;
case GeolocationAccessStatus.Denied:
_rootPage.NotifyUser("Access to location is denied.", NotifyType.ErrorMessage);
LocationDisabledMessage.Visibility = Visibility.Visible;
break;
case GeolocationAccessStatus.Unspecified:
_rootPage.NotifyUser("Unspecificed error!", NotifyType.ErrorMessage);
LocationDisabledMessage.Visibility = Visibility.Collapsed;
break;
}
Etapa 2: lide com as atualizações de localização
O objeto Geolocator aciona o evento PositionChanged para indicar que a localização do usuário mudou ou que o tempo passou, dependendo de como você o configurou. Esse evento transmite a localização correspondente por meio da propriedade Position do argumento (do tipo Geoposition). Neste exemplo, o método não é chamado a partir do thread de interface do usuário, e que o objeto Dispatcher invoca as alterações na interface do usuário.
using Windows.UI.Core;
...
async private void OnPositionChanged(Geolocator sender, PositionChangedEventArgs e)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
_rootPage.NotifyUser("Location updated.", NotifyType.StatusMessage);
UpdateLocationData(e.Position);
});
}
Altere configurações de privacidade de localização
Se as configurações de privacidade de localização não permitirem que seu aplicativo acesse a localização do usuário, recomendamos que você forneça um link para as configurações de privacidade de localização no aplicativo Configurações. Neste exemplo, um controle Hyperlink é usado navegar até o URI ms-settings:privacy-location
.
<!--Set Visibility to Visible when access to location is denied -->
<TextBlock x:Name="LocationDisabledMessage" FontStyle="Italic"
Visibility="Collapsed" Margin="0,15,0,0" TextWrapping="Wrap" >
<Run Text="This app is not able to access Location. Go to " />
<Hyperlink NavigateUri="ms-settings:privacy-location">
<Run Text="Settings" />
</Hyperlink>
<Run Text=" to check the location privacy settings."/>
</TextBlock>
Como alternativa, seu aplicativo pode chamar o método LaunchUriAsync para iniciar o aplicativo Configurações do código. Para obter mais informações, consulte Iniciar o aplicativo Configurações do Windows.
using Windows.System;
...
bool result = await Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-location"));
Solucionar problemas do aplicativo
Para que o aplicativo possa acessar a localização do usuário, Localização deve estar habilitado no dispositivo. No aplicativo Configurações, verifique se as seguintes configurações de privacidade de localização estão ativadas:
- Localização deste dispositivo... está ativada (não se aplica ao 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
Tópicos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de