aboutsummaryrefslogtreecommitdiffstats
path: root/main/src/cgeo/geocaching/sensors/GeoData.java
blob: b8b16fd9882880ab620419ae3a16f7bcd25f54e0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
package cgeo.geocaching.sensors;

import cgeo.geocaching.location.Geopoint;
import cgeo.geocaching.settings.Settings;
import cgeo.geocaching.utils.Log;

import org.apache.commons.lang3.StringUtils;
import org.eclipse.jdt.annotation.NonNull;
import org.eclipse.jdt.annotation.Nullable;

import android.content.Context;
import android.location.Location;
import android.location.LocationManager;

public class GeoData extends Location {

    public static final String INITIAL_PROVIDER = "initial";
    public static final String HOME_PROVIDER = "home";
    public static final String FUSED_PROVIDER = "fused";
    public static final String LOW_POWER_PROVIDER = "low-power";

    // Some devices will not have the last position available (for example the emulator). In this case,
    // rather than waiting forever for a position update which might never come, we emulate it by placing
    // the user arbitrarly at Paris Notre-Dame, one of the most visited free tourist attractions in the world.
    final public static GeoData DUMMY_LOCATION = new GeoData(new Location(INITIAL_PROVIDER));

    static {
        DUMMY_LOCATION.setLatitude(48.85308);
        DUMMY_LOCATION.setLongitude(2.34962);
    }

    public GeoData(final Location location) {
        super(location);
    }

    @Nullable
    static Location best(@Nullable final Location gpsLocation, @Nullable final Location netLocation) {
        if (netLocation == null || (gpsLocation != null && System.currentTimeMillis() <= gpsLocation.getTime() + 30000)) {
            return gpsLocation;
        }
        if (gpsLocation == null) {
            return netLocation;
        }
        return gpsLocation.getTime() >= netLocation.getTime() ? gpsLocation : netLocation;
    }

    public LocationProviderType getLocationProvider() {
        switch (getProvider()) {
            case LocationManager.GPS_PROVIDER:
                return LocationProviderType.GPS;
            case LocationManager.NETWORK_PROVIDER:
                return LocationProviderType.NETWORK;
            case FUSED_PROVIDER:
                // LocationManager.FUSED_PROVIDER constant is not available at API level 9
                return LocationProviderType.FUSED;
            case LOW_POWER_PROVIDER:
                return LocationProviderType.LOW_POWER;
            case HOME_PROVIDER:
                return LocationProviderType.HOME;
            default:
                return LocationProviderType.LAST;
        }
    }

    @NonNull
    public Geopoint getCoords() {
        return new Geopoint(this);
    }

    @Nullable
    public static GeoData getInitialLocation(final Context context) {
        final LocationManager geoManager = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
        if (geoManager != null) {
            try {
                // Try to find a sensible initial location from the last locations known to Android.
                final Location lastGpsLocation = geoManager.getLastKnownLocation(LocationManager.GPS_PROVIDER);
                final Location lastNetworkLocation = geoManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER);
                final Location bestLocation = best(lastGpsLocation, lastNetworkLocation);
                if (bestLocation != null) {
                    bestLocation.setProvider(INITIAL_PROVIDER);
                    return new GeoData(bestLocation);
                }
            } catch (final Exception e) {
                // This error is non-fatal as its only consequence is that we will start with a dummy location
                // instead of a previously known one.
                Log.e("Error when retrieving last known location", e);
            }
        } else {
            Log.w("No LocationManager available");
        }
        final String homeLocationStr = Settings.getHomeLocation();
        if (StringUtils.isNotBlank(homeLocationStr)) {
            try {
                assert homeLocationStr != null;
                final Geopoint homeLocation = new Geopoint(homeLocationStr);
                Log.i("No last known location available, using home location");
                final Location initialLocation = new Location(HOME_PROVIDER);
                initialLocation.setLatitude(homeLocation.getLatitude());
                initialLocation.setLongitude(homeLocation.getLongitude());
                return new GeoData(initialLocation);
            } catch (final Geopoint.ParseException e) {
                Log.w("Unable to parse home location " + homeLocationStr, e);
            }
        }
        Log.i("No last known location nor home location available");
        return null;
    }

}