Nesta página, explicamos as práticas recomendadas para solicitar e gerenciar permissões de uso da localização em segundo plano.
Solicitar permissões de localização "Permitir o tempo todo"
A partir do Android 14, os apps precisam ter a permissão
ACCESS_BACKGROUND_LOCATION para acessar a localização do usuário.
O SDK de navegação inclui essa permissão no arquivo de manifesto. Portanto, não é
necessário solicitá-la explicitamente (se não for necessária para outras finalidades), já que a
combinação de manifestos do Gradle garante que ela seja combinada com o manifesto do app.
No entanto, ter a permissão ACCESS_BACKGROUND_LOCATION não é suficiente para
acessar a localização em segundo plano. Recomendamos que você solicite aos usuários a permissão de localização "Permitir o tempo todo". Isso garante que o app possa ser executado em
segundo plano e mostrar notificações, o que maximiza a Precisão de Local durante
a navegação.
A solicitação precisa explicar aos usuários como a concessão da permissão vai melhorar a precisão de local e a experiência de navegação quando o app estiver em execução em segundo plano.
Para mais informações sobre como solicitar acesso à localização aos usuários, consulte Solicitar permissões de localização | Sensores e localização | Desenvolvedores Android na documentação para desenvolvedores Android.
Garantir a limpeza adequada das notificações de navegação
Para garantir que o app não mantenha as notificações ativas depois que elas não forem mais necessárias, siga estas etapas de limpeza:
- Depois de invocar
startGuidance(), invoquestopGuidance()ouclearDestination(). - Depois de registrar
ArrivalListener, cancele o registro. - Depois de registrar
RoadSnappedLocationProvider, cancele o registro.
Concluir essas etapas garante que as notificações não sejam mantidas ativas quando não forem mais necessárias, o que pode levar ao consumo de bateria e possíveis vazamentos de memória.
Ao invocar novamente os métodos NavigationApi#initForegroundServiceManager, invoque NavigationApi#clearForegroundServiceManager primeiro.
Se o app estiver usando o ForegroundServiceManager, invoque
NavigationApi#clearForegroundServiceManager antes de invocar
NavigationApi#initForegroundServiceManagerProvider. Se você já tiver
inicializado o ForegroundServiceManager, invoque
NavigationApi#initForegroundServiceManagerMessageAndIntent. Isso pode ser feito para
atualizar o ID ou o conteúdo da notificação depois de
inicializar o gerenciador de serviços em primeiro plano.
Sobre as novas restrições introduzidas no Android 14
O Android 14 (Android U) introduziu novas restrições para apps que acessam a localização do usuário em segundo plano. Para ajudar a mitigar essas mudanças, o SDK do Navigation foi atualizado na versão 5.4.0 para gerenciar melhor o acesso à localização em segundo plano. Também recomendamos que você atualize sua implementação para garantir que o app continue tendo acesso aos dados de local mais precisos.
Como as mudanças no Android 14 afetam o SDK do Navigation
Quando você invoca
startGuidance()
no app, o serviço em primeiro plano começa a mostrar notificações ao usuário para
a navegação guiada. A navegação guiada depende do acesso à localização do usuário para atualizar o trajeto e mostrar as orientações visuais e de áudio corretas. A partir do Android 14, o acesso à localização precisa do usuário em segundo plano requer permissão do usuário. Por padrão, se um
app não tiver a permissão do usuário para acessar a localização em segundo plano e
tentar iniciar um serviço em primeiro plano para atualizações de local, o sistema vai gerar uma
SecurityException, causando uma falha no app.
Como o SDK do Navigation reduz esse problema
A partir da versão 5.4.0, o SDK de navegação processa esse SecurityException
sem afetar o app, permitindo que a navegação continue em execução em
segundo plano. Além disso, o SDK do Navigation inclui a permissão ACCESS_BACKGROUND_LOCATION no AndroidManifest. Dessa forma, o
app não precisa declarar a permissão, já que a mesclagem do Gradle vai cuidar
disso. No entanto, se uma notificação não for mostrada ao usuário antes que o app entre
em segundo plano, o SDK do Navigation vai depender do sistema para fornecer
atualizações de local. Essas atualizações do sistema podem não ser frequentes ou precisas e resultar
em uma experiência de navegação abaixo do ideal. Por esse motivo, recomendamos que você também
solicite aos usuários o acesso à localização em segundo plano.
O que os desenvolvedores de apps podem fazer para melhorar a precisão de local para navegação
Para melhorar a precisão do sinal de localização usado pelo SDK de navegação, atualize seu app para solicitar que os usuários permitam o acesso à localização em segundo plano. Para mais informações, consulte Solicitar permissões de localização "Permitir o tempo todo".