הגדרת ממשק למתן נתוני מיקום, בדרך כלל לאובייקט GoogleMap.
לאובייקט GoogleMap יש ספק מיקום מובנה לשכבת 'המיקום שלי', אבל הוא יכול להיות
replaced עם אובייקט אחר שמטמיע את הממשק הזה.
אובייקט GoogleMap מפעיל את ספק המיקום שלו באמצעות activate(OnLocationChangedListener). בזמן ששירות המיקום פעיל (בין activate(OnLocationChangedListener) ל-deactivate()), ספק שירותי מיקום צריך לשלוח עדכוני מיקום תקופתיים למאזין שרשום ב-activate(OnLocationChangedListener). הספק אחראי להשתמש בצורה חכמה בשירותי המיקום בהתאם למצב מחזור החיים של המפה. לדוגמה, המכשיר צריך להשתמש
בשירותים חסכוניים מהסוללה (כמו GPS) רק מדי פעם, או רק כשפעילות מסוימת בחזית.
סיכום של הכיתה המוצבת
| משופר | LocationSource.OnLocationChangedListener | מטפל בעדכון מיקום. | |
סיכום אמצעי תשלום ציבורי
| מופשט וריק | |
| מופשט וריק |
deactivate()
השבתה של הספק הזה.
|
שיטות ציבוריות
מופשט ציבורי ריק הפעלה (LocationSource.OnLocationChangedListener listener)
הפעלת הספק הזה. הספק הזה יעדכן מדי פעם את המאזין, עד
להתקשרות אל deactivate(). ההתראות ישודרו ב-thread הראשי.
פרמטרים
| listener | מתבצעת הקראה של מיקום חדש כאשר מיקום חדש זמין |
|---|
קליעות
| IllegalStateException | אם הספק הזה כבר פעיל |
|---|---|
| IllegalArgumentException | אם listener הוא null
|
ציבורי מופשט ריק השבתה ()
השבתה של הספק הזה. לא יישלחו הודעות על עדכונים נוספים לגבי הקריאה החוזרת (callback) שנרשמת אליה.
קליעות
| IllegalStateException | אם הספק הזה כבר לא פעיל |
|---|