LocationSource

public interface LocationSource

واسطی را برای ارائه داده‌های مکان تعریف می‌کند، معمولاً برای یک شیء GoogleMap.

شیء GoogleMap برای لایه مکان من خود ارائه‌دهنده مکان داخلی دارد، اما می‌توان آن را با ارائه‌دهنده دیگری که این میانای کاربری را پیاده‌سازی می‌کند replaced کرد.

شیء GoogleMap ارائه‌دهنده مکان خود را بااستفاده از activate(OnLocationChangedListener) فعال می‌کند. وقتی فعال است (بین activate(OnLocationChangedListener) و deactivate())، ارائه‌دهنده مکان باید به‌روزرسانی‌های مکان دوره‌ای را به شنونده ثبت‌شده در activate(OnLocationChangedListener) ارسال کند. این مسئولیت ارائه‌دهنده است که از خدمات مکان به‌طور هوشمندانه و مطابق با وضعیت چرخه حیات نقشه استفاده کند. برای مثال، فقط باید گهگاهی از سرویس‌های پرمصرف باتری (مثل GPS) استفاده کند، یا فقط زمانی که فعالیتی در پیش‌زمینه است.

خلاصه کلاس تودرتو

میانا LocationSource.OnLocationChangedListener به‌روزرسانی مکان را مدیریت می‌کند. 

خلاصه روش عمومی

انتزاعی تهی
فعال کردن(LocationSource.OnLocationChangedListener شنونده)
این ارائه‌دهنده را فعال می‌کند.
انتزاعی تهی
غیرفعال کردن()
این ارائه‌دهنده را غیرفعال می‌کند.

روش‌های عمومی

public abstract void activate (LocationSource.OnLocationChangedListener listener)

این ارائه‌دهنده را فعال می‌کند. این ارائه‌دهنده به‌صورت دوره‌ای به شنونده ارائه‌شده اطلاع می‌دهد تا زمانی که با deactivate() تماس بگیرید. اعلان‌ها در رشته اصلی همه‌فرستی خواهد شد.

پارامترها
شنونده شنونده‌ای که وقتی مکان جدیدی دردسترس قرار می‌گیرد فراخوانده می‌شود
پرتاب‌ها
IllegalStateException اگر این ارائه‌دهنده ازقبل فعال باشد
IllegalArgumentException اگر listener‏ null باشد

public abstract void deactivate ()

این ارائه‌دهنده را غیرفعال می‌کند. تماس برگشتی که قبلاً ثبت شده است از به‌روزرسانی‌های بعدی مطلع نمی‌شود.

پرتاب‌ها
IllegalStateException اگر این ارائه‌دهنده ازقبل غیرفعال باشد