KappS Base de conhecimento · Blog

Google Play Permissões de localização em 2026

Blog Tutorial

Em 15 de abril de 2026, o Google Play anunciou uma atualização da política de Permissões de localização. A tabela de Prazos de políticas a lista em Permissões e APIs que acessam informações sensíveis, com prazo 2027-01-27 — a mesma data da linha de Contatos. A frase publicada é curta: o Play está introduzindo o botão de localização como escopo mínimo recomendado para localização precisa, em linha com os requisitos de dados do usuário e permissões sensíveis. Se seu app tem como alvo o Android 17 (API 37) ou superior e ainda solicita ACCESS_FINE_LOCATION apenas para buscar locais próximos, compartilhar um pin uma vez, marcar uma foto ou preencher um endereço, esse é o fluxo que o Play agora espera que passe pelo botão. O KappS está escrevendo isto como um guia da política, não como substituto das páginas de Ajuda ao vivo.

O que você resolve hoje: auditar cada uso de localização precisa no binário e nos SDKs mesclados; classificar cada um como transacional (único, iniciado pelo usuário) ou núcleo persistente (navegação, rastreamento em tempo real); migrar os fluxos transacionais para o botão de localização do Android; definir a flag onlyForLocationButton publicada quando o botão for o único caminho de localização precisa; e preparar a declaração no Play Console que toda solicitação de ACCESS_FINE_LOCATION agora exige. Confira a Central de Ajuda atual do Play Console para os rótulos exatos do formulário — este tutorial apenas reitera o que aquelas páginas de Ajuda e o guia do botão de localização do Android publicam.


O que o Play publicou (prazo, Ajuda, Android 17)

As páginas oficiais descrevem o mesmo prazo com extensões diferentes. Baseie-se na tabela e depois no artigo de Ajuda dedicado:

  • A linha de Prazos de Política datada de 2027-01-27: "Para proteger melhor a privacidade dos usuários, estamos atualizando nossa política de Permissões de Localização. Estamos introduzindo o botão de localização como escopo mínimo recomendado para localização precisa, em linha com nossos requisitos de dados do usuário e permissões sensíveis. Anunciado em 2026-04-15."
  • O anúncio de política de 15 de abril de 2026 usa a mesma redação e remete você de volta a Prazos de Política. O Play disse que você teria pelo menos 30 dias a partir dessa data para começar a atualizar — a data de aplicação indicada na tabela continua sendo 27 de janeiro de 2027.
  • Escopo mínimo: acesso à localização em primeiro plano e o botão de localização é o artigo de instruções. Ele repete 27 de janeiro de 2027 como a data em que a conformidade com a política passa a ser obrigatória para todos os apps, com prorrogações automáticas de 30 dias disponíveis no Play Console. A declaração para apps que solicitam ACCESS_FINE_LOCATION fica disponível em novembro de 2026. A aplicação de políticas para apps com nível de API de destino Android 17 ou superior está prevista para o final de janeiro de 2027.
  • Permissões e APIs que acessam informações sensíveis e sua prévia acrescentam a regra do Android 17: se a localização precisa for necessária apenas para ações pontuais iniciadas pelo usuário, você deve implementar o botão de localização e a flag de permissão onlyForLocationButton. Um banner de prévia mais antigo ainda diz "em vigor em 28 de outubro de 2026". O artigo Prazos de políticas e Escopo mínimo agora diz 27 de janeiro de 2027 — use essas datas, não a linha de outubro que sobrou.

A Android linha do tempo das políticas do Play para desenvolvedores lista a mesma frase sobre permissões de localização em 27 de janeiro de 2027.

O acesso em primeiro plano ocorre enquanto o app está aberto e visível. O acesso em segundo plano ocorre quando ele não está. Este tutorial é o caminho do botão de localização em primeiro plano. A localização em segundo plano continua sujeita à revisão separada de localização em segundo plano. O botão de localização não é uma API de segundo plano.


Etapa 1 — Audite cada uso de localização precisa

Não comece no Console. Comece pelo binário e por todas as bibliotecas mescladas. O teste da Ajuda é se o recurso precisa de localização precisa, e, se precisar, se essa necessidade é uma ação pontual do usuário ou um recurso central persistente.

Percorra os artefatos reais, não o texto da ficha do app na loja:

  1. Pesquise no manifesto mesclado e nos manifestos de dependências por ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, ACCESS_BACKGROUND_LOCATION e — se já estiver presente — USE_LOCATION_BUTTON.
  2. Pesquise no código e na documentação dos SDKs por clientes de localização fundida, chamadas de última localização conhecida, geocodificadores, movimentos de câmera do mapa e consultas "perto de mim". Marque cada ponto de chamada com o recurso voltado ao usuário que o aciona.
  3. Pergunte se o recurso ainda funciona se você tiver apenas uma localização aproximada do tamanho de uma cidade. A lista de escopo mínimo traz exemplos suficientemente amplos: notícias e tendências locais, eventos regionais, clima regional, "itens num raio de 8 km", "amigo está na sua cidade", localizadores de lojas que mostram as filiais mais próximas num raio amplo, promoções em nível de cidade, idioma ou moeda de uma região ampla.
  4. Se o usuário recusar a localização precisa, o recurso continua com localização aproximada, um endereço digitado ou um pino de mapa que o usuário posiciona? A política de permissões restritas já espera um caminho razoável quando o usuário recusa.
  5. O recurso é promovido na ficha do app na Play? A permissão persistente ACCESS_FINE_LOCATION precisa ser essencial ao propósito principal ou a um recurso importante do produto, conforme promovido na ficha do app na loja.

Se a resposta honesta é "só precisamos de um ponto preciso para um toque", pare de tratar isso como uma permissão de execução permanente. Esse é um caso para botão de localização.


Etapa 2 — Classifique o núcleo transacional versus persistente

Para apps destinados ao Android 17 (API 37) ou superior, o botão de localização é o escopo mínimo exigido para localização precisa transacional (única). Exemplos comuns da Ajuda:

  • Buscar por perto — lojas, caixas eletrônicos, restaurantes, estacionamentos ou patinetes ao redor do usuário.
  • Compartilhamento único — envie uma localização atual a um amigo ou preencha automaticamente um endereço atual uma vez.
  • Marcação de localização — anexar um lugar a uma foto ou a uma publicação social que o usuário está publicando.
  • Seletores de endereço — ajude o usuário a preencher automaticamente um endereço de entrega.

O botão concede localização precisa para uma única sessão e expira quando a sessão do app é encerrada. É somente em primeiro plano. Não substitui a localização em segundo plano e não é uma concessão permanente que você pode continuar usando depois que o usuário sai da tela.

O local preciso em primeiro plano persistente ainda é permitido quando é essencial e o botão ou a localização aproximada não dão conta. Exemplos desse lado na Ajuda:

  • Navegação — direções passo a passo para dirigir, caminhar ou pedalar.
  • Rastreamento ao vivo — o progresso de um corredor, compartilhamento contínuo com pessoas, medição ou levantamento contínuo enquanto o app está ativo.

O FAQ na mesma página é direto: você ainda pode usar o ACCESS_FINE_LOCATION padrão somente se o app tiver um recurso central e persistente (por exemplo, navegação curva a curva) que não possa ser atendido por um botão de uso único ou por localização aproximada. Você terá que justificar isso na declaração do Play Console.

Duas proibições publicadas se aplicam a toda solicitação de localização precisa, com ou sem botão:

  • Permissões de localização não podem ser solicitadas com a única finalidade de publicidade ou análise.
  • Os dados de localização do dispositivo nunca podem ser vendidos.

Não invente uma terceira categoria. "Gostamos de um cohort de anúncios mais preciso" não é um recurso central persistente. "O usuário toca em Compartilhar localização uma vez" não é navegação.


Etapa 3 — Migre os fluxos transacionais para o Botão de Localização

A Ajuda do Play e o Android guia do botão de localização descrevem o mesmo controle. Use o caminho do Jetpack LocationButton que a página do Android publica. Essa biblioteca está marcada como experimental e sujeita a alterações — registre problemas no rastreador de issues do Android e releia o guia atualizado antes de fixar a versão de uma dependência.

Fatos de integração publicados (não invente APIs extras nem botões do Console):

  1. Se o app tem como alvo o Android 17 (API 37) ou superior e o apenas contém recursos que exigem localização precisa baseada em sessão, a política do Play exige o botão de localização.
  2. Declare as permissões de localização padrão mais a permissão dedicada USE_LOCATION_BUTTON exigida pelo serviço de renderização remota do sistema.
  3. Se a localização precisa for obtida somente pelo botão, adicione o flag publicado onlyForLocationButton em ACCESS_FINE_LOCATION. O exemplo de escopo mínimo da Ajuda do Play o escreve como atributo booleano:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:onlyForLocationButton="true" />

O guia para desenvolvedores do Android escreve a mesma flag como um valor de usesPermissionFlags, junto com USE_LOCATION_BUTTON:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:usesPermissionFlags="onlyForLocationButton" /> <uses-permission android:name="android.permission.USE_LOCATION_BUTTON" />

Esses dois trechos são o que as páginas ativas publicam hoje. Use o formato que corresponde ao artigo da Central de Ajuda e ao Android guia que você está implementando — esta página não escolhe um terceiro nome de atributo. Nota do Android: adicionar a flag restringe o app de obter a permissão mais ampla de localização precisa; os usuários precisam usar o botão para compartilhar um ponto preciso.

Declare também ACCESS_COARSE_LOCATION quando a localização aproximada basta para um recurso, ou quando o exemplo do Jetpack ainda a lista ao lado da precisa. Prefira a aproximada sempre que a precisa não for necessária.

O Jetpack cuida dos dispositivos mais antigos: no Android 16 ou inferior, a biblioteca recorre a um controle renderizado localmente que mantém seu layout e dispara o prompt padrão de permissão de localização. Esse é o caminho de compatibilidade documentado — não uma segunda estratégia de permissões que você inventa para a API 36.

Depois, revise a interface em relação aos limites de design do Android: você pode personalizar cores, contorno, forma e um conjunto predefinido de rótulos ("Usar localização precisa", "Compartilhar localização precisa" e os demais tipos listados). O ícone de localização é obrigatório e não personalizável; o tamanho da fonte é gerenciado pelo sistema para acessibilidade.

Se um SDK de fornecedor ainda solicita ACCESS_FINE_LOCATION permanente para um toque de "buscar por perto" ou check-in, esse é o padrão transacional que o Play está migrando para o botão. Substitua o fluxo do SDK ou substitua o SDK.


Etapa 4 — Prepare a declaração no Play Console

Ajuda sobre escopo mínimo: todos os apps que solicitam localização precisa (ACCESS_FINE_LOCATION) devem preencher uma declaração no Play Console explicando por que precisam dela e por que o botão de localização ou a localização aproximada não é suficiente. A declaração está prevista para aparecer em novembro de 2026. Esta página não inventa um caminho de menu além do nome que o Play publica — use os rótulos da sua conta e o artigo de Ajuda vinculado a esse formulário.

A ajuda informa que o formulário vai pedir:

  1. Quais recursos voltados ao usuário exigem ACCESS_FINE_LOCATION? Escolha na lista publicada: busca por perto; compartilhamento de localização pontual; rastreamento em tempo real; marcação de localização pelo usuário; marcação de localização automatizada; personalização; navegação; ações específicas por área (geofencing); dispositivos por perto (o caso mais antigo de descoberta Bluetooth/Wi-Fi no Android 11 e anteriores); acesso à localização pelo navegador; diagnóstico de rede; ou Outro. Se o uso não for voltado ao usuário ou não estiver na lista, a Ajuda orienta selecionar Outro.
  2. Explique por que ACCESS_COARSE_LOCATION ou LocationButton não são suficientes e por que você precisa de ACCESS_FINE_LOCATION contínuo.

Selecionar "buscar por perto", "compartilhamento de localização único" ou "marcação de localização pelo usuário" em uma build que ainda mantém a permissão de localização precisa em segundo plano é o exemplo da Ajuda de um uso disfarçado de botão. Essas linhas não são uma brecha para pular o botão no Android 17+.

Se o único caminho restante para localização precisa for o botão, a declaração e o manifesto devem coincidir: onlyForLocationButton definido, USE_LOCATION_BUTTON presente e nenhuma biblioteca remanescente que ainda solicite a permissão ampla de localização precisa.

Se você ainda precisa de localização precisa persistente para navegação ou rastreamento em tempo real, escreva o motivo técnico pelo qual o botão ou a localização aproximada não dão conta disso antes de alguém abrir o Console. Item de ação da Ajuda para novembro: consulte a equipe sobre se ACCESS_FINE_LOCATION é necessário para a funcionalidade principal e esteja pronto para explicar por que o caminho de escopo mínimo não é tecnicamente suficiente.

Após 27 de janeiro de 2027, os apps no escopo que não estiverem em conformidade ficam sujeitos à aplicação de políticas. Uma autoextensão de 30 dias no Console é publicada — uma extensão não é uma exceção permanente. Os apps existentes não estão isentos: atualizações que não seguirem a regra do botão de localização 17+ do Android podem ser rejeitadas.


O que deixa de funcionar após 2027-01-27

O Play publica resultados. Não substitua por achismos:

  • Localização precisa transacional sem o botão no Android 17+. Buscar por perto, compartilhamento único, marcação ou seleção de endereço enquanto ainda se obtém ACCESS_FINE_LOCATION é o padrão que o Escopo Mínimo chama de caso do botão obrigatório.
  • Localização precisa quando a aproximada bastaria. A elegibilidade para ACCESS_FINE_LOCATION é apenas para recursos que o botão (Android 17+) ou ACCESS_COARSE_LOCATION (todas as versões) não conseguem atender adequadamente.
  • Nenhuma declaração em uma build com ACCESS_FINE_LOCATION. Após 27 de janeiro de 2027, apps no escopo que não estiverem em conformidade estão sujeitos à aplicação de políticas. O formulário de novembro de 2026 é como você demonstra os usos persistentes restantes.
  • Localização precisa apenas para anúncios ou analytics, ou venda de localização. A Ajuda lista ambos como proibidos, inclusive para apps que de outra forma se qualificariam para acesso persistente.
  • Usar o botão como solução alternativa em segundo plano. O botão é estritamente para primeiro plano e transacional. Necessidades em segundo plano continuam passando pela revisão de localização em segundo plano.
  • Tratar um banner antigo de “28 de outubro de 2026” como o prazo vigente. Os prazos de políticas e a linha do tempo do escopo mínimo agora indicam 2027-01-27. Releia essas duas páginas antes de agendar o lançamento.

Se o Console exibir um novo questionário de localização depois que você ler isto, siga o artigo de Ajuda atualizado vinculado nesse formulário. Esta página não inventa botões extras, nomes de classes de API extras nem datas extras além de 2026-04-15 (anunciada), novembro de 2026 (declaração disponível) e 2027-01-27 (Prazos de política / conformidade obrigatória; aplicação para Android 17+ prevista para o final desse mês).


Um checklist de 10 minutos

  1. Liste todos os recursos que leem a localização do dispositivo. Marque cada um como suficientemente aproximado, preciso transacional (botão) ou essencial persistente (navegação / rastreamento ao vivo).
  2. Se um recurso for suficientemente impreciso, dispense o ACCESS_FINE_LOCATION nesse fluxo e mantenha apenas o ACCESS_COARSE_LOCATION.
  3. Se todo uso preciso remanescente for transacional e você tem como alvo o Android 17+, implemente o Jetpack LocationButton, declare USE_LOCATION_BUTTON e defina o flag publicado onlyForLocationButton em ACCESS_FINE_LOCATION.
  4. Se um recurso realmente precisa de localização precisa permanente, escreva por que o botão e a localização aproximada não dão conta — antes que alguém abra o Console.
  5. Quando a declaração de novembro de 2026 aparecer no Play Console, preencha-a para que os casos de uso selecionados correspondam ao binário publicado.
  6. Confirme que a ficha do app na loja só divulga recursos que correspondem ao acesso que você ainda solicita. Não solicite localização apenas para publicidade ou análise, e não venda dados de localização.
  7. Releia os Prazos de política atuais e o artigo sobre o botão de localização do Escopo Mínimo antes de contar com a autoextensão de 30 dias.

A versão em uma linha

Se o app tem como destino o Android 17+ e só precisa de localização precisa para um toque do usuário, a atualização de Permissões de localização do Play — anunciada em 15 de abril de 2026, com prazo em 2027-01-27 — exige o Android botão de localização (com a flag onlyForLocationButton publicada) em vez da ACCESS_FINE_LOCATION permanente; mantenha a localização precisa persistente apenas quando puder declarar um uso essencial, como navegação ou rastreamento ao vivo, e explicar por que o botão ou a localização aproximada não bastam.


Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar