Define uma interface para fornecer dados de local, normalmente a um objeto GoogleMap
.
Um objeto GoogleMap
tem um provedor de localização integrado para a camada my-location, mas pode ser replaced
com outro que implementa essa interface.
Um objeto GoogleMap
ativa o provedor de localização usando activate(OnLocationChangedListener)
. Enquanto estiver ativo (entre activate(OnLocationChangedListener)
e deactivate()
), um provedor de localização precisará enviar atualizações periódicas de localização ao listener registrado em activate(OnLocationChangedListener)
. É responsabilidade do provedor usar os serviços de localização de forma inteligente, de acordo com o estado do ciclo de vida do mapa. Por exemplo, ele só deve usar
serviços de consumo intensivo da bateria (como GPS) ocasionalmente ou apenas enquanto uma atividade estiver em
primeiro plano.
Resumo de classes aninhadas
Interface | LocationSource.OnLocationChangedListener | Gerencia uma atualização de local. |
Resumo do método público
vazio abstrato | |
vazio abstrato |
deactivate()
Desativa este provedor.
|
Métodos públicos
public abstrato void activate (LocationSource.OnLocationChangedListener listener)
Ativa este provedor. Esse provedor notificará o listener fornecido periodicamente até
você chamar deactivate()
. As notificações serão transmitidas na linha de execução principal.
Parâmetros
listener | listener que é chamado quando uma nova localização está disponível. |
---|
Gera
IllegalStateException | se este provedor já estiver ativo |
---|---|
IllegalArgumentException | se listener for null
|
public abstrato void desativar ()
Desativa este provedor. O callback registrado anteriormente não será notificado sobre outras atualizações.
Gera
IllegalStateException | se este provedor já estiver inativo |
---|