واسطی را برای ارائه دادههای مکان تعریف میکند، معمولاً برای یک شیء GoogleMap.
شیء GoogleMap برای لایه مکان من خود ارائهدهنده مکان داخلی دارد، اما میتوان آن را با ارائهدهنده دیگری که این
میانای کاربری را پیادهسازی میکند replaced کرد.
شیء GoogleMap ارائهدهنده مکان خود را بااستفاده از activate(OnLocationChangedListener) فعال میکند. وقتی فعال است (بین activate(OnLocationChangedListener) و deactivate())، ارائهدهنده مکان باید
بهروزرسانیهای مکان دورهای را به شنونده ثبتشده در activate(OnLocationChangedListener) ارسال کند. این مسئولیت ارائهدهنده است که از خدمات مکان
بهطور هوشمندانه و مطابق با وضعیت چرخه حیات نقشه استفاده کند. برای مثال، فقط باید گهگاهی از سرویسهای پرمصرف باتری (مثل GPS) استفاده کند، یا فقط زمانی که فعالیتی در پیشزمینه است.
خلاصه کلاس تودرتو
| میانا | LocationSource.OnLocationChangedListener | بهروزرسانی مکان را مدیریت میکند. | |
خلاصه روش عمومی
| انتزاعی تهی | |
| انتزاعی تهی |
غیرفعال کردن()
این ارائهدهنده را غیرفعال میکند.
|
روشهای عمومی
public abstract void activate (LocationSource.OnLocationChangedListener listener)
این ارائهدهنده را فعال میکند. این ارائهدهنده بهصورت دورهای به شنونده ارائهشده اطلاع میدهد تا زمانی که
با deactivate() تماس بگیرید. اعلانها در رشته اصلی همهفرستی خواهد شد.
پارامترها
| شنونده | شنوندهای که وقتی مکان جدیدی دردسترس قرار میگیرد فراخوانده میشود |
|---|
پرتابها
| IllegalStateException | اگر این ارائهدهنده ازقبل فعال باشد |
|---|---|
| IllegalArgumentException | اگر listener null باشد
|
public abstract void deactivate ()
این ارائهدهنده را غیرفعال میکند. تماس برگشتی که قبلاً ثبت شده است از بهروزرسانیهای بعدی مطلع نمیشود.
پرتابها
| IllegalStateException | اگر این ارائهدهنده ازقبل غیرفعال باشد |
|---|