O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Permissões de localização de três estados

As permissões de localização de três estados no Android 10 fornecem aos usuários mais controle sobre como os aplicativos acessam a localização dos seus dispositivos.

No Android 9 e anterior, os usuários faziam escolhas persistentes ao conceder acesso de localização aos aplicativos. Eles podiam negar ou permitir , o último dos quais dava acesso aos aplicativos o tempo todo (primeiro e segundo plano). As permissões de localização de três estados no Android 10 fornecem aos usuários três opções para permitir que um aplicativo acesse a localização de um dispositivo. Os usuários são solicitados a conceder ou negar o nível de permissão quando um aplicativo o solicita.

Um usuário normalmente vê as três opções apresentadas na Figura 1. No entanto, há casos de uso em que apenas duas dessas opções são necessárias e, nesses casos, apenas essas duas são mostradas.

Tristate location permissions screen
Figura 1. Tela de notificações Tristate

Estas são as três opções:

  • Permitir o tempo todo : a localização do dispositivo é conhecida pelo aplicativo mesmo quando o aplicativo não está em uso (sendo executado em segundo plano). Isso é equivalente a permitir permissão no Android 9 e inferior.
  • Permitir apenas enquanto o aplicativo está em uso : (apenas em primeiro plano) a localização do dispositivo só é visível para o aplicativo quando está em execução.
  • Negar : a localização do dispositivo nunca é visível para o aplicativo. Isso é o mesmo que negar permissão no Android 9 e inferior.

Os usuários são solicitados a conceder permissão de acesso à localização quando os aplicativos solicitam a permissão.

Depois que um usuário concede permissão de acesso para Permitir apenas enquanto o aplicativo está em uso , um aplicativo pode solicitar um aumento incremental no acesso para Permitir o tempo todo . O usuário vê uma caixa de diálogo de solicitação (mostrada na Figura 2 ). Se o usuário selecionar Manter o acesso durante o uso , quando o aplicativo acessar a localização do dispositivo no próximo uso, a caixa de diálogo oferece a opção Manter e não perguntar novamente .

A caixa de diálogo aparece sob estas condições para aplicativos destinados ao Android 10:

  • Após pelo menos 24 horas da concessão da permissão.
  • Somente se o aplicativo estiver recebendo locais em segundo plano.
  • Quando a tela está ligada e o usuário não está utilizando outro aplicativo.
Incremental permissions
Figura 2. Permissões incrementais

Para saber mais sobre como solicitar permissões, consulte Acesso do aplicativo à localização do dispositivo . Para obter detalhes se seu aplicativo for direcionado ao Android 9 e inferior, consulte Continuação da ação iniciada pelo usuário .

Impacto

O recurso de permissões de localização tristate afeta qualquer aplicativo que precise de acesso à localização do dispositivo durante a execução em segundo plano e é necessário no Android 10.

Você pode alterar seu código, mas não pode alterar ou personalizar o comportamento relacionado à permissão na estrutura.

Implementação

As permissões de localização de três estados são aplicadas a aplicativos no Android 10, independentemente do SDK de destino de um aplicativo.

Para obter informações sobre como implementar os casos de uso do seu aplicativo (em atualizações), consulte a seção Projetar para cenários de atualização de dispositivo na documentação do desenvolvedor.

Para ver como habilitar o acesso para diferentes casos de uso (como exigir acesso ao local em segundo plano para aplicativos como Google Maps ou Google Play Services), visualize estes tópicos na página Acesso do aplicativo ao local do dispositivo :

Acesso à localização no aplicativo

Os usuários podem alterar as permissões de acesso do seu aplicativo para Negar ou Permitir apenas durante o uso do aplicativo, se desejarem. Para permissão de acesso à localização no aplicativo e para todos os aplicativos próprios e de terceiros, forneça os níveis de controle do usuário fornecidos na tabela a seguir.

O aplicativo de tipo de permissão precisa solicitar Opções do usuário para fornecer
O aplicativo solicita permissões de primeiro plano apenas Permitir apenas durante o uso do aplicativo
Negar
O aplicativo sempre solicita permissão (primeiro e segundo plano) Permitir o tempo todo
Permitir apenas durante o uso do aplicativo
Negar
Todos os aplicativos com solicitações de acesso à localização Permitir apenas durante o uso do aplicativo

Essas permissões se aplicam a todas as solicitações de localização. Aplicativos com Permitir apenas ao usar as permissões de aplicativo não têm permissão para verificações de Wi-Fi, celular ou Bluetooth em segundo plano.

Atualizações de sistema operacional

Em uma atualização do sistema operacional para o Android 10, as permissões de localização do aplicativo são traduzidas de acordo com o seguinte:

  • Ligado torna - se Permitir apenas durante o uso .
  • Desligado permanece desligado ( Negar ).
  • O acesso à localização pré-concedida torna-se Permitir apenas durante a pré-concessão de uso.