Otimizar o uso de local para cenários reais

Esta seção descreve alguns cenários de coleta de localização típicos e recomendações para otimizar o uso das APIs do provedor de localização misto e da fronteira geográfica virtual.

Atualizações visíveis ao usuário ou em primeiro plano

Exemplo: um app de mapeamento que precisa de atualizações frequentes e precisas com latência muito baixa. Todas as atualizações acontecem em primeiro plano: o usuário inicia uma atividade, consome os dados de local e, após um curto período, interrompe a atividade.

Use o método setPriority() com um valor de PRIORITY_HIGH_ACCURACY ou PRIORITY_BALANCED_POWER_ACCURACY.

O intervalo especificado no método setIntervalMillis() depende do caso de uso: para cenários em tempo real, defina o valor como alguns segundos. Caso contrário, limite a alguns minutos (recomenda-se aproximadamente dois minutos ou mais para minimizar o uso da bateria).

Saber a localização do dispositivo

Exemplo: um app de clima quer saber a localização do dispositivo.

Use o método getLastLocation(), que retorna o local disponível mais recente (que, em casos raros, pode ser nulo). Esse método oferece uma maneira simples de acessar o local e não gera custos associados à solicitação ativa de atualizações do local. Use em conjunto com o método isLocationAvailable(), que retorna true quando o local retornado por getLastLocation() está razoavelmente atualizado.

Iniciar atualizações quando um usuário está em uma localização específica

Exemplo: solicitar atualizações quando um usuário estiver a uma determinada distância do trabalho, de casa ou de outro local.

Use fronteiras geográficas virtuais em conjunto com as atualizações do provedor de localização combinada. Solicite atualizações quando o app receber um acionador de entrada em uma fronteira geográfica virtual e remova as atualizações quando o app receber um acionador de saída. Isso garante que o app receba atualizações do local mais granulares somente quando o usuário entrar em uma área definida.

O fluxo de trabalho típico para esse cenário pode envolver o surgimento de uma notificação na transição de entrada da fronteira geográfica virtual e o início de uma atividade que contém código para solicitar atualizações quando o usuário tocar na notificação.

Iniciar atualizações com base no estado da atividade do usuário

Exemplo: solicitar atualizações somente quando o usuário estiver dirigindo ou andando de bicicleta.

Use a API de reconhecimento de atividade em conjunto com as atualizações do provedor de localização combinada. Solicite atualizações quando a atividade segmentada for detectada e remova-as quando o usuário parar de realizar essa atividade.

O fluxo de trabalho típico para esse caso de uso pode envolver a exibição de uma notificação para a atividade detectada e o início de uma atividade que contém código para solicitar atualizações quando o usuário toca na notificação.

Atualizações de localização em segundo plano de longa duração vinculadas a áreas geográficas

Exemplo: o usuário quer receber uma notificação quando o dispositivo estiver próximo de uma loja.

Esse é um excelente caso de uso para a fronteira geográfica virtual. Como o caso de uso quase certamente envolve a localização em segundo plano, use o método addGeofences(GeofencingRequest, PendingIntent).

Defina as opções de configuração a seguir:

  • Se você estiver rastreando transições de permanência, use o método setLoiteringDelay() transmitindo um valor de aproximadamente cinco minutos ou menos.

  • Use setNotificationResponsiveness(), transmitindo um valor de aproximadamente cinco minutos. No entanto, considere usar um valor de aproximadamente dez minutos se o app puder gerenciar o atraso extra na capacidade de resposta.

Um app só pode registrar no máximo 100 fronteiras geográficas virtuais. Em um caso de uso em que um app quer rastrear um grande número de opções de varejistas, ele pode registrar uma fronteira geográfica virtual grande (no nível da cidade) e registrar dinamicamente fronteiras geográficas virtuais menores (para locais dentro da cidade) para lojas dentro da fronteira geográfica virtual maior. Quando um usuário entrar em uma fronteira geográfica virtual grande, adicione fronteiras menores. Quando o usuário sair da fronteira maior, remova as menores e registre novamente as fronteiras para uma nova área.

Atualizações de localização em segundo plano de longa duração sem um componente do app visível

Exemplo: um app que rastreia passivamente a localização

Use o método setPriority() com a opção PRIORITY_PASSIVE, se possível, porque ele quase não consome bateria. Se não for possível usar PRIORITY_PASSIVE, use PRIORITY_BALANCED_POWER_ACCURACY ou PRIORITY_LOW_POWER, mas evite usar PRIORITY_HIGH_ACCURACY para trabalhos em segundo plano prolongados, porque essa opção consome muita bateria.

Se você precisar de mais dados de local, use a localização passiva chamando o método setMinUpdateIntervalMillis() e transmitindo um valor menor do que o transmitido para setIntervalMillis(). Quando combinada com a opção PRIORITY_PASSIVE, a localização passiva pode fornecer de forma oportuna a localização calculada por outros apps sem custo financeiro adicional.

Modere a frequência adicionando alguma latência, usando o método setMaxUpdateDelayMillis(). Por exemplo, se você usar o método setIntervalMillis() com um valor de aproximadamente 10 minutos, considere chamar setMaxUpdateDelayMillis() com um valor entre 30 e 60 minutos. Com essas opções, o local é calculado para o app aproximadamente a cada 10 minutos, mas o app só é ativado a cada 30 a 60 minutos com alguns dados de local disponíveis como uma atualização em lote. Essa abordagem troca a latência por mais dados disponíveis e melhor desempenho da bateria.

Atualizações frequentes de alta precisão enquanto o usuário interage com outros apps

Exemplo: um app de navegação ou fitness que continua funcionando quando o usuário desliga a tela ou abre outro app.

Use um serviço em primeiro plano. Se o app puder realizar um trabalho caro em nome do usuário, é recomendável que o usuário seja informado sobre isso. Um serviço em primeiro plano requer uma notificação persistente. Para mais informações, consulte Visão geral das notificações.