Определяет интерфейс для предоставления данных о местоположении, обычно для объекта GoogleMap .
Объект GoogleMap имеет встроенный поставщик местоположения для своего уровня моего местоположения, но его можно replaced другим, реализующим этот интерфейс.
Объект GoogleMap активирует своего поставщика местоположения с помощью activate(OnLocationChangedListener) . Пока он активен (между activate(OnLocationChangedListener) и deactivate() ), поставщик местоположения должен периодически отправлять обновления местоположения прослушивателю, зарегистрированному в activate(OnLocationChangedListener) . Ответственность за разумное использование служб определения местоположения в соответствии с состоянием жизненного цикла карты лежит на провайдере. Например, ему следует использовать службы, потребляющие много энергии (например, GPS), только изредка или только тогда, когда какое-либо действие находится на переднем плане.
Сводка вложенных классов
| интерфейс | LocationSource.OnLocationChangedListener | Обрабатывает обновление местоположения. | |
Краткое описание общедоступного метода
| абстрактная пустота | активировать (прослушиватель LocationSource.OnLocationChangedListener ) Активирует этого провайдера. |
| абстрактная пустота | деактивировать () Деактивирует этого провайдера. |
Публичные методы
публичная абстрактная недействительная активация (прослушиватель LocationSource.OnLocationChangedListener )
Активирует этого провайдера. Этот поставщик будет периодически уведомлять предоставленный прослушиватель, пока вы не вызовете deactivate() . Уведомления будут транслироваться в основной теме.
Параметры
| слушатель | прослушиватель, который вызывается, когда доступно новое местоположение |
|---|
Броски
| IllegalStateException | если этот провайдер уже активен |
|---|---|
| IllegalArgumentException | если listener равен null |
публичная абстрактная недействительность деактивировать ()
Деактивирует этого провайдера. Ранее зарегистрированный обратный вызов не уведомляется о каких-либо дальнейших обновлениях.
Броски
| IllegalStateException | если этот провайдер уже неактивен |
|---|