בקשה לעדכוני מיקום

שימוש נכון בפרטי המיקום יכול להועיל למשתמשים באפליקציה. לדוגמה, אם האפליקציה עוזרת למשתמש למצוא את הדרך בזמן הליכה או נסיעה, או אם האפליקציה עוקבת אחרי מיקום הנכסים, היא צריכה לקבל את המיקום של המכשיר במרווחי זמן קבועים. בנוסף למיקום הגיאוגרפי (קו הרוחב ואורך הגלובוס), כדאי לספק למשתמש מידע נוסף, כמו כיוון (הכיוון האופקי של הנסיעה), גובה או מהירות המכשיר. המידע הזה ועוד מידע זמין באובייקט Location, שהאפליקציה יכולה לאחזר מספק המיקום המשולב. בתגובה, ממשק ה-API מעדכן את האפליקציה מדי פעם במיקום הזמין הטוב ביותר, על סמך ספקי המיקום הזמינים כרגע, כמו Wi-Fi ו-GPS (מערכת מיקום גלובלית). הדיוק של המיקום נקבע על סמך הספקים, הרשאות המיקום שביקשת והאפשרויות שהגדרת בבקשת המיקום.

במדריך הזה תלמדו איך לבקש עדכונים סדירים לגבי המיקום של מכשיר באמצעות השיטה requestLocationUpdates() בספק המיקום המאוחד.

אחזור המיקום הידוע האחרון

המיקום הידוע האחרון של המכשיר הוא בסיס נוח להתחלה, ומבטיח לאפליקציה מיקום ידוע לפני שהיא מתחילה לשלוח עדכוני מיקום תקופתיים. במדריך קבלת המיקום הידוע האחרון מוסבר איך לקבל את המיקום הידוע האחרון באמצעות קריאה ל-getLastLocation(). בקטעי הקוד שבקטעים הבאים, ההנחה היא שהאפליקציה כבר אחזרה את המיקום הידוע האחרון ושמרה אותו כאובייקט Location במשתנה הגלובלי mCurrentLocation.

שליחת בקשת מיקום

לפני ששולחים בקשה לעדכוני מיקום, האפליקציה צריכה להתחבר לשירותי המיקום ולשלוח בקשה לקבלת מיקום. במדריך בנושא שינוי הגדרות המיקום מוסבר איך לעשות את זה. אחרי שמגדירים בקשה לקבלת מיקום, אפשר להתחיל את העדכונים הרגילים על ידי שליחת הודעה למספר requestLocationUpdates().

בהתאם לפורמט הבקשה, ספק המיקום הממוזג קורא לשיטת ה-callback‏ LocationCallback.onLocationResult() ומעביר לה רשימה של אובייקטים מסוג Location, או שהוא מנפיק אירוע PendingIntent שמכיל את המיקום בנתונים המורחבים שלו. הדיוק והתדירות של העדכונים מושפעים מהרשאות המיקום שביקשת והאפשרויות שהגדרת באובייקט של בקשת המיקום.

במדריך הזה נסביר איך לקבל את העדכון באמצעות LocationCallback callback. קוראים ל-requestLocationUpdates(), מעבירים לה את המכונה של האובייקט LocationRequest ואת LocationCallback. מגדירים את השיטה startLocationUpdates() כמו בדוגמת הקוד הבאה:

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

private fun startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper())
}

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

private void startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper());
}

שימו לב שקטע הקוד שלמעלה מתייחס לדגל בוליאני, requestingLocationUpdates, שמשמשים למעקב אחרי הסטטוס של עדכוני המיקום שהמשתמש הפעיל או השבית. אם המשתמשים השביתו את עדכוני המיקום, תוכלו להודיע להם על הדרישה של האפליקציה לגבי מיקום. למידע נוסף על שמירת הערך של הדגל הבוליאני במופעים שונים של הפעילות, ראו שמירה של מצב הפעילות.

הגדרת קריאה חוזרת (callback) לעדכון המיקום

ספק המיקום המשולב מפעיל את שיטת הקריאה החוזרת LocationCallback.onLocationResult(). הארגומנט הנכנס מכיל אובייקט רשימה Location שמכיל את קו הרוחב וקו האורך של המיקום. קטע הקוד הבא מראה איך מטמיעים את הממשק LocationCallback, מגדירים את השיטה, מקבלים את חותמת הזמן של עדכון המיקום ומציגים את קו הרוחב, קו האורך וחותמת הזמן בממשק המשתמש של האפליקציה:

private lateinit var locationCallback: LocationCallback

// ...

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    locationCallback = object : LocationCallback() {
        override fun onLocationResult(locationResult: LocationResult?) {
            locationResult ?: return
            for (location in locationResult.locations){
                // Update UI with location data
                // ...
            }
        }
    }
}

private LocationCallback locationCallback;

// ...

@Override
protected void onCreate(Bundle savedInstanceState) {
    // ...

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // Update UI with location data
                // ...
            }
        }
    };
}

הפסקת עדכוני המיקום

כדאי לשקול אם להפסיק את עדכוני המיקום כשהפעילות כבר לא במוקד, למשל כשהמשתמש עובר לאפליקציה אחרת או לפעילות אחרת באותה אפליקציה. הפעולה הזו יכולה לעזור לצמצם את צריכת החשמל, בתנאי שהאפליקציה לא צריכה לאסוף מידע גם כשהיא פועלת ברקע. בקטע הזה נסביר איך אפשר להפסיק את העדכונים ב-method‏ onPause() של הפעילות.

כדי להפסיק את עדכוני המיקום, צריך לבצע קריאה ל-removeLocationUpdates() ולהעביר לה את הערך LocationCallback, כפי שמתואר בקטע הקוד הבא:

override fun onPause() {
    super.onPause()
    stopLocationUpdates()
}

private fun stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback)
}

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

משתמשים במשתנה בוליאני, requestingLocationUpdates, כדי לעקוב אחרי מצב עדכוני המיקום. בשיטה onResume() של הפעילות, בודקים אם עדכוני המיקום פעילים כרגע ומפעילים אותם אם לא:

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

שמירת המצב של הפעילות

שינוי בהגדרות המכשיר, כמו שינוי כיוון המסך או השפה, עלול לגרום להשמדת הפעילות הנוכחית. לכן, האפליקציה צריכה לאחסן את כל המידע הדרוש לה כדי ליצור מחדש את הפעילות. אחת הדרכים לעשות זאת היא באמצעות מצב המכונה שמאוחסן באובייקט Bundle.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-callbak של הפעילות onSaveInstanceState() כדי לשמור את מצב המכונה:

override fun onSaveInstanceState(outState: Bundle?) {
    outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
    super.onSaveInstanceState(outState)
}

@Override
protected void onSaveInstanceState(Bundle outState) {
    outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
            requestingLocationUpdates);
    // ...
    super.onSaveInstanceState(outState);
}

מגדירים את השיטה updateValuesFromBundle() כדי לשחזר את הערכים השמורים מהמופע הקודם של הפעילות, אם הם זמינים. קוראים ל-method מה-method‏ onCreate() של הפעילות, כפי שמתואר בדוגמת הקוד הבאה:

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
    updateValuesFromBundle(savedInstanceState)
}

private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
    savedInstanceState ?: return

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY)
    }

    // ...

    // Update UI to match restored state
    updateUI()
}

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    updateValuesFromBundle(savedInstanceState);
}

private void updateValuesFromBundle(Bundle savedInstanceState) {
    if (savedInstanceState == null) {
        return;
    }

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY);
    }

    // ...

    // Update UI to match restored state
    updateUI();
}

מידע נוסף על שמירת מצב המכונה זמין במאמר העזרה בנושא הכיתה Android Activity.

הערה: כדי לשמור את ההעדפות של המשתמש באופן עקבי יותר, אפשר לאחסן אותן ב-SharedPreferences של האפליקציה. מגדירים את ההעדפה המשותפת ב-method‏ onPause() של הפעילות, ומאחזרים את ההעדפה ב-onResume(). למידע נוסף על שמירת ההעדפות, קראו את המאמר שמירת קבוצות של מפתחות-ערכים.

מקורות מידע נוספים

מידע נוסף זמין במשאבים הבאים:

דוגמיות

• אפליקציה לדוגמה שממחישה את קבלת עדכוני המיקום ב-Android.