LocationManager.java revision 2291ca47c763d9c292865ada1450d3a094918882
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.location; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.PendingIntent; 20e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pellyimport android.content.Context; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 222eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pellyimport android.os.Build; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Looper; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3079762a3ee34eb8be5549bcb183af844b6f19c266Mike Lockwood 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pellyimport com.android.internal.location.ProviderProperties; 366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides access to the system location services. These 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * services allow applications to obtain periodic updates of the 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device's geographical location, or to fire an application-specified 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent} when the device enters the proximity of a given 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * geographical location. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>You do not 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instantiate this class directly; instead, retrieve it through 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.getSystemService(Context.LOCATION_SERVICE)}. 483aef8e1d1b2f0b87d470bcccf37ba4ebb6560c45Joe Fernandez * 494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>At API version 17 the Location API's were simplified. 504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Previously applications would need to explicitly enumerate, select, and 514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * track Location Providers (such as GPS or Network). 524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * This has been replaced by the concept of 534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <em>Fused Location</em>. Now applications just specify the quality of service 544e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * required for location updates (using the new {@link LocationRequest} class), 554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * and the system will fuse results from individual location providers 564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * as necessary before returning the result to the application. 574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>As a result of this change, the {@link LocationProvider} and 594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link Criteria} classes have been deprecated, in favor of 604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest}. Furthermore, all Location Manager 614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * methods involving Criteria or explicitly named Providers have 624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * been deprecated, in favor of new variants that use 634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest}. 644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>A single {@link LocationRequest} object can trigger the use 664e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * of all providers (including GPS, Network, and the passive) provider 674e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * as necessary. This should result in a lot less work for your application. You 684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * no longer need to track the status and availability of each 694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location provider. Just set the quality of locations required 704e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * in {@link LocationRequest}, and let the system manage the rest. 714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p class="note">Unless noted, all Location API methods require 734e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the {@link android.Manifest.permission#ACCESS_COARSE_LOCATION} or 744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permissions. 752291ca47c763d9c292865ada1450d3a094918882Victoria Lease * If your application only has the coarse permission then it will not have 762291ca47c763d9c292865ada1450d3a094918882Victoria Lease * access to the GPS or passive location providers. Other providers will still 772291ca47c763d9c292865ada1450d3a094918882Victoria Lease * return location results, but the update rate will be throttled and the exact 782291ca47c763d9c292865ada1450d3a094918882Victoria Lease * location will be obfuscated to a coarse level of accuracy. 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class LocationManager { 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "LocationManager"; 82e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly 83e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly private final Context mContext; 84e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly private final ILocationManager mService; 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final HashMap<GpsStatus.Listener, GpsStatusListenerTransport> mGpsStatusListeners = 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new HashMap<GpsStatus.Listener, GpsStatusListenerTransport>(); 87b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private final HashMap<GpsStatus.NmeaListener, GpsStatusListenerTransport> mNmeaListeners = 88b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood new HashMap<GpsStatus.NmeaListener, GpsStatusListenerTransport>(); 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final GpsStatus mGpsStatus = new GpsStatus(); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 924e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the network location provider. 934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider determines location based on 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * availability of cell tower and WiFi access points. Results are retrieved 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by means of a network lookup. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_PROVIDER = "network"; 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1034e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the GPS location provider. 1044e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1054e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider determines location using 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * satellites. Depending on conditions, this provider may take a while to return 1072291ca47c763d9c292865ada1450d3a094918882Victoria Lease * a location fix. Requires the permission 1082291ca47c763d9c292865ada1450d3a094918882Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> The extras Bundle for the GPS location provider can contain the 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * following key/value pairs: 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> satellites - the number of satellites used to derive the fix 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 1154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String GPS_PROVIDER = "gps"; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 122a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * A special location provider for receiving locations without actually initiating 1234e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a location fix. 1244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider can be used to passively receive location updates 126a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * when other applications or services request them without actually requesting 127a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * the locations yourself. This provider will return locations generated by other 128a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * providers. You can query the {@link Location#getProvider()} method to determine 1292291ca47c763d9c292865ada1450d3a094918882Victoria Lease * the origin of the location update. Requires the permission 1302291ca47c763d9c292865ada1450d3a094918882Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}, although if the GPS is 1312291ca47c763d9c292865ada1450d3a094918882Victoria Lease * not enabled this provider might only return coarse fixes. 1324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 134a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood */ 1356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 136a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood public static final String PASSIVE_PROVIDER = "passive"; 137a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood 138a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood /** 1394e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the Fused location provider. 1404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider combines inputs for all possible location sources 1424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to provide the best possible Location fix. It is implicitly 1434e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * used for all API's that involve the {@link LocationRequest} 1444e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * object. 1456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly * 1466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly * @hide 1476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly */ 1486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public static final String FUSED_PROVIDER = "fused"; 1496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 1506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly /** 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for the Bundle extra holding a boolean indicating whether 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a proximity alert is entering (true) or exiting (false).. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_PROXIMITY_ENTERING = "entering"; 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding an Integer status value 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a status change is broadcast using a PendingIntent. 1594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_STATUS_CHANGED = "status"; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding an Boolean status value 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a provider enabled/disabled event is broadcast using a PendingIntent. 1684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_PROVIDER_ENABLED = "providerEnabled"; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding a Location value 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a location change is broadcast using a PendingIntent. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_LOCATION_CHANGED = "location"; 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 18100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * Broadcast intent action indicating that the GPS has either been 18200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * enabled or disabled. An intent extra provides this state as a boolean, 18300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * where {@code true} means enabled. 18400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * @see #EXTRA_GPS_ENABLED 18500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 1864e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 18700b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 18800b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String GPS_ENABLED_CHANGE_ACTION = 18900b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood "android.location.GPS_ENABLED_CHANGE"; 19000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 19100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 1920c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick * Broadcast intent action when the configured location providers 1930c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick * change. 1944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 1960c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick */ 1976fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 1980c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick public static final String PROVIDERS_CHANGED_ACTION = 1990c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick "android.location.PROVIDERS_CHANGED"; 2000c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick 2010c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick /** 20200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * Broadcast intent action indicating that the GPS has either started or 20300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * stopped receiving GPS fixes. An intent extra provides this state as a 20400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * boolean, where {@code true} means that the GPS is actively receiving fixes. 20500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * @see #EXTRA_GPS_ENABLED 20600b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 2074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 20800b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 20900b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String GPS_FIX_CHANGE_ACTION = 21000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood "android.location.GPS_FIX_CHANGE"; 21100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 21200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 21300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * The lookup key for a boolean that indicates whether GPS is enabled or 21400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * disabled. {@code true} means GPS is enabled. Retrieve it with 21500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * {@link android.content.Intent#getBooleanExtra(String,boolean)}. 21600b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 2174e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 21800b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 21900b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String EXTRA_GPS_ENABLED = "enabled"; 22000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Map from LocationListeners to their associated ListenerTransport objects 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private HashMap<LocationListener,ListenerTransport> mListeners = 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new HashMap<LocationListener,ListenerTransport>(); 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class ListenerTransport extends ILocationListener.Stub { 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_LOCATION_CHANGED = 1; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_STATUS_CHANGED = 2; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_PROVIDER_ENABLED = 3; 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_PROVIDER_DISABLED = 4; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private LocationListener mListener; 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mListenerHandler; 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ListenerTransport(LocationListener listener, Looper looper) { 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener = listener; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (looper == null) { 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler = new Handler() { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project _handleMessage(msg); 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler = new Handler(looper) { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project _handleMessage(msg); 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 254e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onLocationChanged(Location location) { 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_LOCATION_CHANGED; 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = location; 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 262e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onStatusChanged(String provider, int status, Bundle extras) { 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_STATUS_CHANGED; 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle b = new Bundle(); 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putString("provider", provider); 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putInt("status", status); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extras != null) { 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putBundle("extras", extras); 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = b; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 276e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onProviderEnabled(String provider) { 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_PROVIDER_ENABLED; 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = provider; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 284e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onProviderDisabled(String provider) { 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_PROVIDER_DISABLED; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = provider; 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void _handleMessage(Message msg) { 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_LOCATION_CHANGED: 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Location location = new Location((Location) msg.obj); 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onLocationChanged(location); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_STATUS_CHANGED: 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle b = (Bundle) msg.obj; 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String provider = b.getString("provider"); 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int status = b.getInt("status"); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle extras = b.getBundle("extras"); 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onStatusChanged(provider, status, extras); 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_PROVIDER_ENABLED: 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onProviderEnabled((String) msg.obj); 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_PROVIDER_DISABLED: 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onProviderDisabled((String) msg.obj); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 31248f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood try { 31348f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood mService.locationCallbackFinished(this); 31448f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood } catch (RemoteException e) { 31548f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood Log.e(TAG, "locationCallbackFinished: RemoteException", e); 31648f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3194e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this constructor because it has a parameter 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of type ILocationManager, which is a system private class. The 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * right way to create an instance of this class is using the 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * factory Context.getSystemService. 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 326e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly public LocationManager(Context context, ILocationManager service) { 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 328e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly mContext = context; 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3316fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private LocationProvider createProvider(String name, ProviderProperties properties) { 3326fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return new LocationProvider(name, properties); 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3364e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns a list of the names of all known location providers. 3374e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>All providers are returned, including ones that are not permitted to 3384e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be accessed by the calling activity or are currently disabled. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @return list of Strings containing names of the provider 3414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 3424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getAllProviders() { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getAllProviders(); 3486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns a list of the names of location providers. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only the providers which are currently 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabled are returned. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return list of Strings containing names of the providers 3604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 3614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getProviders(boolean enabledOnly) { 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 36603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getProviders(null, enabledOnly); 3676fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3686fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the information associated with the location provider of the 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given name, or null if no provider exists by that name. 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the provider name 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a LocationProvider, or null 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if name is null or does not exist 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the caller is not permitted to access the 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given provider. 3834e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 3844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LocationProvider getProvider(String name) { 3886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(name); 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ProviderProperties properties = mService.getProviderProperties(name); 3916fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (properties == null) { 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3946fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return createProvider(name, properties); 3956fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3966fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a list of the names of LocationProviders that satisfy the given 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * criteria, or null if none do. Only providers that are permitted to be 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * accessed by the calling activity will be returned. 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param criteria the criteria that the returned providers must match 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only the providers which are currently 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabled are returned. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return list of Strings containing names of the providers 4104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 4114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getProviders(Criteria criteria, boolean enabledOnly) { 4156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 41603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood try { 41703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getProviders(criteria, enabledOnly); 4186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 4196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 42103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return null; 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the name of the provider that best meets the given criteria. Only providers 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that are permitted to be accessed by the calling activity will be 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned. If several providers meet the criteria, the one with the best 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * accuracy is returned. If no provider meets the criteria, 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the criteria are loosened in the following sequence: 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> power requirement 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> accuracy 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> bearing 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> speed 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> altitude 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Note that the requirement on monetary cost is not removed 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in this process. 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param criteria the criteria that need to be matched 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only a provider that is currently enabled is returned 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return name of the provider that best matches the requirements 4454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 4464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getBestProvider(Criteria criteria, boolean enabledOnly) { 4506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 45103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood try { 45203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getBestProvider(criteria, enabledOnly); 4536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 4546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a 4614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent. 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 4644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 465f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 467f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 468f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 46973577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link LocationListener#onLocationChanged} method will be called for 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * each location update 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 473f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if provider is null or doesn't exist 474f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * on this device 475f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if listener is null 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the calling thread has no Looper 4774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 4784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 4816fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 4826fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener) { 4836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 4846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 4856fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 4866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 4876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 4886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, null, null); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4924e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a callback on 4934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the specified looper thread. 494f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 4964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 497f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 499f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 500f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 50173577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link LocationListener#onLocationChanged} method will be called for 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * each location update 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param looper a Looper object whose message queue will be used to 5054e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 5064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if listener is null 5104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 5114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 5156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 5166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener, Looper looper) { 5176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 5186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 5196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 5206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 5216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 5226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 52303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 52403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 52503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 5264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using a Criteria, and a callback 5274e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * on the specified looper thread. 528f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 5294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 5304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 531f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 532f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 533f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 53403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 53503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 53673577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 53703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * {@link LocationListener#onLocationChanged} method will be called for 53803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * each location update 53903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 5404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 5414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 54203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 54303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if criteria is null 54403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 5454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 5464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 54803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 5496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 5506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(long minTime, float minDistance, Criteria criteria, 5516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener, Looper looper) { 5526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 5536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 5566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, minTime, minDistance, false); 5576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a 5624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 5654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 568f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 569f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 57073577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for each location update 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 573f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * on this device 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if intent is null 5754e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 5764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 5806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 5816fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly PendingIntent intent) { 5826fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 5836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 5846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 5856fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 5866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 5876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 59003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 5914e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using a Criteria and pending intent. 59203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 5934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>The <code>requestLocationUpdates()</code> and 5944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <code>requestSingleUpdate()</code> methods involving 5954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * an explicit String provider or {@link Criteria} are deprecated. 5964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>They register the current activity to be updated 5984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * periodically by the named provider, or by the provider matching 5994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the specified {@link Criteria}, with location and status updates. 60003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 601f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> It may take a while to receive the first location update. If 60203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * an immediate location is required, applications may use the 60303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * {@link #getLastKnownLocation(String)} method. 60403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 6054e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> Location updates are received either by {@link LocationListener} 6064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * callbacks, or by broadcast intents to a supplied {@link PendingIntent}. 6074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 6084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If the caller supplied a pending intent, then location updates 6094e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are sent with a key of {@link #KEY_LOCATION_CHANGED} and a 6104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.location.Location} value. 6114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 6124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The location update interval can be controlled using the minTime parameter. 613f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * The elapsed time between location updates will never be less than 614f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * minTime, although it can be more depending on the Location Provider 615f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * implementation and the update interval requested by other applications. 616f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 617f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> Choosing a sensible value for minTime is important to conserve 618f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * battery life. Each location update requires power from 619f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * GPS, WIFI, Cell and other radios. Select a minTime value as high as 620f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * possible while still providing a reasonable user experience. 621f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * If your application is not in the foreground and showing 622f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location to the user then your application should avoid using an active 623f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * provider (such as {@link #NETWORK_PROVIDER} or {@link #GPS_PROVIDER}), 624f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * but if you insist then select a minTime of 5 * 60 * 1000 (5 minutes) 625f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * or greater. If your application is in the foreground and showing 626f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location to the user then it is appropriate to select a faster 627f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * update interval. 628f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 629f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> The minDistance parameter can also be used to control the 630f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * frequency of location updates. If it is greater than 0 then the 631f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location provider will only send your application an update when 632f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * the location has changed by at least minDistance meters, AND 633f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * at least minTime milliseconds have passed. However it is more 634f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * difficult for location providers to save power using the minDistance 635f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * parameter, so minTime should be the primary tool to conserving battery 636f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * life. 637f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 6384e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If your application wants to passively observe location 6394e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * updates triggered by other applications, but not consume 6404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * any additional power otherwise, then use the {@link #PASSIVE_PROVIDER} 6414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * This provider does not actively turn on or modify active location 6424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * providers, so you do not need to be as careful about minTime and 6434e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * minDistance. However if your application performs heavy work 6444e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * on a location update (such as network activity) then you should 6454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * select non-zero values for minTime and/or minDistance to rate-limit 6464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * your update frequency in the case another application enables a 6474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location provider with extremely fast updates. 648f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 6494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>In case the provider is disabled by the user, updates will stop, 6504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * and a provider availability update will be sent. 6514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * As soon as the provider is enabled again, 6524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location updates will immediately resume and a provider availability 6534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * update sent. Providers can also send status updates, at any time, 6544e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * with extra's specific to the provider. If a callback was supplied 6554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then status and availability updates are via 6564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderDisabled}, 6574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderEnabled} or 6584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onStatusChanged}. Alternately, if a 6594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent was supplied then status and availability updates 6604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are broadcast intents with extra keys of 6614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROVIDER_ENABLED} or {@link #KEY_STATUS_CHANGED}. 6624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 6634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If a {@link LocationListener} is used but with no Looper specified 6644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then the calling thread must already 6654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be a {@link android.os.Looper} thread such as the main thread of the 6664e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * calling Activity. If a Looper is specified with a {@link LocationListener} 6674e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then callbacks are made on the supplied Looper thread. 668f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 669f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p class="note"> Prior to Jellybean, the minTime parameter was 670f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * only a hint, and some location provider implementations ignored it. 671f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * From Jellybean and onwards it is mandatory for Android compatible 672f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * devices to observe both the minTime and minDistance parameters. 673f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 674f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 675f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 67603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 67703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 67873577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for each location update 67903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 680f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if criteria is null 68103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 6824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 6834e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 6844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 68503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 6866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 687f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly public void requestLocationUpdates(long minTime, float minDistance, Criteria criteria, 688f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly PendingIntent intent) { 6896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 6906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6926fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 6936fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, minTime, minDistance, false); 6946fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using the named provider and 6994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a callback. 70003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 70303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 70403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param provider the name of the provider with which to register 70573577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 706e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * {@link LocationListener#onLocationChanged} method will be called when 707e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * the location update is available 70803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 7094e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 7104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 71103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 71203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 71303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 7144e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 7154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest#setNumUpdates} instead 71703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 7186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 71903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(String provider, LocationListener listener, Looper looper) { 7206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 7216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 7226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 7246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 7256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 72603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 72703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 72803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 7294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a Criteria and 7304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a callback. 73103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 73403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 73503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 73603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 73773577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 738e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * {@link LocationListener#onLocationChanged} method will be called when 739e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * the location update is available 74003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 7414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 7424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 74303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 74403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if criteria is null 74503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 7464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 7474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest#setNumUpdates} instead 74903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 7506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 75103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(Criteria criteria, LocationListener listener, Looper looper) { 7526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 7536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 7546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 7566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, 0, 0, true); 7576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 75803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 75903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 76003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 7614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a named provider and pending intent. 76203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 765e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * 76603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param provider the name of the provider with which to register 76773577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 76803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 76903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 77003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 7714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 7724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7734e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest#setNumUpdates} instead 77403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 7756fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 77603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(String provider, PendingIntent intent) { 7776fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 7786fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 7796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 7816fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 7826fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 78303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 78403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 78503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 7864e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a Criteria and pending intent. 78703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7884e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail on how to use this (deprecated) method. 790e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * 79103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 79203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 79373577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 79403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 79503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 79603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 7974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 7984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest#setNumUpdates} instead 80003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 8016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 80203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(Criteria criteria, PendingIntent intent) { 8036fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 8046fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 8056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8066fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 8076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, 0, 0, true); 8086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 8096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 8124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for fused location updates using a LocationRequest and callback. 8134e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8144e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>The system will automatically select and enable the best providers 8154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to compute a location for your application. It may use only passive 8164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * locations, or just a single location source, or it may fuse together 8174e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * multiple location sources in order to produce the best possible 8184e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * result, depending on the quality of service requested in the 8194e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest}. 8204e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8214e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>LocationRequest can be null, in which case the system will choose 8224e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * default, low power parameters for location updates. You will occasionally 8234e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * receive location updates as available, without a major power impact on the 8244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * system. If your application just needs an occasional location update 8254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * without any strict demands, then pass a null LocationRequest. 8264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8274e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Only one LocationRequest can be registered for each unique callback 8284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * or pending intent. So a subsequent request with the same callback or 8294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent will over-write the previous LocationRequest. 8304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8314e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If a pending intent is supplied then location updates 8324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are sent with a key of {@link #KEY_LOCATION_CHANGED} and a 8334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.location.Location} value. If a callback is supplied 8344e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then location updates are made using the 8354e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onLocationChanged} callback, on the specified 8364e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Looper thread. If a {@link LocationListener} is used 8374e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * but with a null Looper then the calling thread must already 8384e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be a {@link android.os.Looper} thread (such as the main thread) and 8394e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * callbacks will occur on this thread. 8404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> Provider status updates and availability updates are deprecated 8424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * because the system is performing provider fusion on the applications 8434e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * behalf. So {@link LocationListener#onProviderDisabled}, 8444e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderEnabled}, {@link LocationListener#onStatusChanged} 8454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * will not be called, and intents with extra keys of 8464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROVIDER_ENABLED} or {@link #KEY_STATUS_CHANGED} will not 8474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be received. 8484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 84973577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * <p> To unregister for Location updates, use: {@link #removeUpdates(LocationListener)}. 85073577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * 8514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 85273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 8534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onLocationChanged} method will be called when 8544e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the location update is available 8554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param looper a Looper object whose message queue will be used to 8564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 8574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 8584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if listener is null 8604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 8614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 8626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(LocationRequest request, LocationListener listener, 8636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Looper looper) { 8646fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 8656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 8666fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8676fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 8694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 8704e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for fused location updates using a LocationRequest and a pending intent. 8714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 87273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * <p> To unregister for Location updates, use: {@link #removeUpdates(PendingIntent)}. 87373577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * 8744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> See {@link #requestLocationUpdates(LocationRequest, LocationListener, Looper)} 8754e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail. 8764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 87873577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 8794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 8814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 8824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 8836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(LocationRequest request, PendingIntent intent) { 8846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 8856fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 8866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private ListenerTransport wrapListener(LocationListener listener, Looper looper) { 8896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (listener == null) return null; 8906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly synchronized (mListeners) { 8916fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport = mListeners.get(listener); 8926fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (transport == null) { 8936fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly transport = new ListenerTransport(listener, looper); 8946fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8956fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mListeners.put(listener, transport); 8966fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return transport; 89703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 8986fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9006fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private void requestLocationUpdates(LocationRequest request, LocationListener listener, 9016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Looper looper, PendingIntent intent) { 9026fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9036fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 9046fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // wrap the listener class 9066fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport = wrapListener(listener, looper); 9076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 9096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestLocationUpdates(request, transport, intent, packageName); 9106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 9116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 9126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 91303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 91403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 91503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 9164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Removes all location updates for the specified LocationListener. 9174e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9184e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Following this call, updates will no longer 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * occur for this listener. 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9214e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param listener listener object that no longer needs location updates 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if listener is null 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeUpdates(LocationListener listener) { 9256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 9266fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 9276fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9286fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport; 9296fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly synchronized (mListeners) { 9306fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly transport = mListeners.remove(listener); 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9326fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (transport == null) return; 9336fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeUpdates(transport, null, packageName); 9366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 9376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Removes all location updates for the specified pending intent. 9434e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9444e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Following this call, updates will no longer for this pending intent. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent pending intent object that no longer needs location updates 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if intent is null 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeUpdates(PendingIntent intent) { 9506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 9516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 9526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeUpdates(null, intent, packageName); 9556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 9566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Set a proximity alert for the location given by the position 9624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * (latitude, longitude) and the given radius. 9634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> When the device 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * detects that it has entered or exited the area surrounding the 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * location, the given PendingIntent will be used to create an Intent 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to be fired. 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> The fired Intent will have a boolean extra added with key 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #KEY_PROXIMITY_ENTERING}. If the value is true, the device is 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * entering the proximity region; if false, it is exiting. 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Due to the approximate nature of position estimation, if the 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device passes through the given area briefly, it is possible 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that no Intent will be fired. Similarly, an Intent could be 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fired if the device passes very close to the given area but 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not actually enter it. 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> After the number of milliseconds given by the expiration 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameter, the location manager will delete this proximity 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert and no longer monitor it. A value of -1 indicates that 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there should be no expiration time. 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Internally, this method uses both {@link #NETWORK_PROVIDER} 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link #GPS_PROVIDER}. 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9874fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * <p>Before API version 17, this method could be used with 9884fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or 9894fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. 9904fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * From API version 17 and onwards, this method requires 9914fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission. 9924fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param latitude the latitude of the central point of the 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param longitude the longitude of the central point of the 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius the radius of the central point of the 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region, in meters 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param expiration time for this proximity alert, in milliseconds, 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 to indicate no expiration 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent a PendingIntent that will be used to generate an Intent to 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fire when entry to or exit from the alert region is detected 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10044fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10054fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} and {@link Geofence} instead 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 10106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void addProximityAlert(double latitude, double longitude, float radius, long expiration, 10116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly PendingIntent intent) { 10126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (expiration < 0) expiration = Long.MAX_VALUE; 10146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Geofence fence = Geofence.createCircle(latitude, longitude, radius); 10166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = new LocationRequest().setExpireIn(expiration); 10176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 10186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestGeofence(request, fence, intent, mContext.getPackageName()); 10196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 10236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 10254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Add a geofence with the specified LocationRequest quality of service. 10264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10274e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> When the device 10284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * detects that it has entered or exited the area surrounding the 10294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location, the given PendingIntent will be used to create an Intent 10304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to be fired. 10314e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The fired Intent will have a boolean extra added with key 10334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROXIMITY_ENTERING}. If the value is true, the device is 10344e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * entering the proximity region; if false, it is exiting. 10354e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10364e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The geofence engine fuses results from all location providers to 10374e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * provide the best balance between accuracy and power. Applications 10384e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * can choose the quality of service required using the 10394e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest} object. If it is null then a default, 10404e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * low power geo-fencing implementation is used. It is possible to cross 10414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a geo-fence without notification, but the system will do its best 10424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to detect, using {@link LocationRequest} as a hint to trade-off 10434e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * accuracy and power. 10444e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The power required by the geofence engine can depend on many factors, 10464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * such as quality and interval requested in {@link LocationRequest}, 10474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * distance to nearest geofence and current device velocity. 10484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 10504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param fence a geographical description of the geofence area 10514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent pending intent to receive geofence updates 10524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if fence is null 10544e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10554fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10564fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 10584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly public void addGeofence(LocationRequest request, Geofence fence, PendingIntent intent) { 10596fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10606fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkGeofence(fence); 10616fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestGeofence(request, fence, intent, mContext.getPackageName()); 10646fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes the proximity alert with the given PendingIntent. 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10724fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * <p>Before API version 17, this method could be used with 10734fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or 10744fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. 10754fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * From API version 17 and onwards, this method requires 10764fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission. 10774fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent the PendingIntent that no longer needs to be notified of 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proximity alerts 10804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10824fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10834fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10854e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} and {@link Geofence} instead 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeProximityAlert(PendingIntent intent) { 10896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 10916fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10926fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 10936fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(null, intent, packageName); 10946fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10956fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10976fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 10986fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 11004e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Remove a single geofence. 11014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This removes only the specified geofence associated with the 11034e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * specified pending intent. All other geofences remain unchanged. 11044e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11054e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param fence a geofence previously passed to {@link #addGeofence} 11064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent a pending intent previously passed to {@link #addGeofence} 11074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if fence is null 11094e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 11104fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 11114fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 11124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 11136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void removeGeofence(Geofence fence, PendingIntent intent) { 11146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 11156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkGeofence(fence); 11166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 11176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(fence, intent, packageName); 11206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 11264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Remove all geofences registered to the specified pending intent. 11274e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent a pending intent previously passed to {@link #addGeofence} 11294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 11314fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 11324fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 11334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 11346fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void removeAllGeofences(PendingIntent intent) { 11356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 11366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 11376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11386fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 11396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(null, intent, packageName); 11406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns the current enabled/disabled status of the given provider. 11474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>If the user has enabled this provider in the Settings menu, true 11494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * is returned otherwise false is returned 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the provider is enabled 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1154f4d207b1c2212d6e9adc3e7954a8d14c6b9abc51Mike Lockwood * @throws IllegalArgumentException if provider is null 11554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 11564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11596fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isProviderEnabled(String provider) { 11616fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 11626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isProviderEnabled(provider); 11656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11666fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 11724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Get the last known location. 11734e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This location could be very old so use 11754118012da9a22694b3353040a485f8cdc27e2f17Philip Milne * {@link Location#getElapsedRealtimeNanos} to calculate its age. It can 11764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * also return null if no previous location is available. 11774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Always returns immediately. 11794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @return The last known location, or null if not available 11814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 11824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 11834e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly public Location getLastLocation() { 11844035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly String packageName = mContext.getPackageName(); 11854035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly 11866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 11874035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly return mService.getLastLocation(null, packageName); 11886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return null; 11916fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11926fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11936fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a Location indicating the data from the last known 11964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location fix obtained from the given provider. 11974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> This can be done 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without starting the provider. Note that this location could 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be out-of-date, for example if the device was turned off and 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * moved to another location. 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> If the provider is currently disabled, null is returned. 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the last known location for the provider, or null 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 12104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 12114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link #getLastLocation} instead 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Location getLastKnownLocation(String provider) { 12156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 12164035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly String packageName = mContext.getPackageName(); 12176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 12186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 12196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 12206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 12214035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly return mService.getLastLocation(request, packageName); 12226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return null; 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12266fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 12276fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 12284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // --- Mock provider support --- 12294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // TODO: It would be fantastic to deprecate mock providers entirely, and replace 12304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // with something closer to LocationProviderBase.java 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a mock location provider and adds it to the set of active providers. 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the provider name 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION} system setting is not enabled 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if a provider with the given name already exists 12414e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 12424e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addTestProvider(String name, boolean requiresNetwork, boolean requiresSatellite, 12466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly boolean requiresCell, boolean hasMonetaryCost, boolean supportsAltitude, 12476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly boolean supportsSpeed, boolean supportsBearing, int powerRequirement, int accuracy) { 12486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ProviderProperties properties = new ProviderProperties(requiresNetwork, 12496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requiresSatellite, requiresCell, hasMonetaryCost, supportsAltitude, supportsSpeed, 12506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly supportsBearing, powerRequirement, accuracy); 12516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (name.matches(LocationProvider.BAD_CHARS_REGEX)) { 12526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("provider name contains illegal character: " + name); 12536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 12546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.addTestProvider(name, properties); 12576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes the mock location provider with the given name. 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 12724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12746fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeTestProvider(String provider) { 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.removeTestProvider(provider); 12786fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12842eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * Sets a mock location for the given provider. 12852eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * <p>This location will be used in place of any actual location from the provider. 12862eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * The location object must have a minimum number of fields set to be 12872eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * considered a valid LocationProvider Location, as per documentation 12882eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * on {@link Location} class. 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param loc the mock location 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12972eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * @throws IllegalArgumentException if the location is incomplete 12984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 12994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderLocation(String provider, Location loc) { 13032eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly if (!loc.isComplete()) { 13046fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly IllegalArgumentException e = new IllegalArgumentException( 13056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly "Incomplete location object, missing timestamp or accuracy? " + loc); 13062eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly if (mContext.getApplicationInfo().targetSdkVersion <= Build.VERSION_CODES.JELLY_BEAN) { 13076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // just log on old platform (for backwards compatibility) 13086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.w(TAG, e); 13092eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly loc.makeComplete(); 13102eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } else { 13116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // really throw it! 13126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw e; 13132eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } 13142eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } 13152eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderLocation(provider, loc); 13186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any mock location associated with the given provider. 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 13334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderLocation(String provider) { 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderLocation(provider); 13396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a mock enabled value for the given provider. This value will be used in place 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of any actual value from the provider. 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled the mock enabled value 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 13564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderEnabled(String provider, boolean enabled) { 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderEnabled(provider, enabled); 13626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any mock enabled value associated with the given provider. 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 13774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderEnabled(String provider) { 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderEnabled(provider); 13836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets mock status values for the given provider. These values will be used in place 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of any actual values from the provider. 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param status the mock status 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extras a Bundle containing mock extras 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param updateTime the mock update time 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 14014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 14024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14046fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderStatus(String provider, int status, Bundle extras, long updateTime) { 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderStatus(provider, status, extras, updateTime); 14086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 14096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any mock status values associated with the given provider. 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 14224e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 14234e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated requesting location providers by name is deprecated 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderStatus(String provider) { 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderStatus(provider); 14296fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 14306fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14344e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // --- GPS-specific support --- 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This class is used to send GPS status events to the client's main thread. 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class GpsStatusListenerTransport extends IGpsStatusListener.Stub { 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final GpsStatus.Listener mListener; 1440b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private final GpsStatus.NmeaListener mNmeaListener; 1441b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1442b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // This must not equal any of the GpsStatus event IDs 1443b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private static final int NMEA_RECEIVED = 1000; 1444b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1445b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private class Nmea { 1446b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood long mTimestamp; 1447b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood String mNmea; 1448b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1449b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Nmea(long timestamp, String nmea) { 1450b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mTimestamp = timestamp; 1451b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmea = nmea; 1452b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1453b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1454b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private ArrayList<Nmea> mNmeaBuffer; 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport(GpsStatus.Listener listener) { 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener = listener; 1458b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener = null; 1459b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1460b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1461b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport(GpsStatus.NmeaListener listener) { 1462b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener = listener; 1463b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mListener = null; 1464b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer = new ArrayList<Nmea>(); 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1467e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onGpsStarted() { 1469b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1470b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1471b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_STARTED; 1472b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1473b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1476e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onGpsStopped() { 1478b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1479b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1480b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_STOPPED; 1481b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1482b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1485e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onFirstFix(int ttff) { 1487b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1488b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsStatus.setTimeToFirstFix(ttff); 1489b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1490b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_FIRST_FIX; 1491b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1492b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1495e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onSvStatusChanged(int svCount, int[] prns, float[] snrs, 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] elevations, float[] azimuths, int ephemerisMask, 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int almanacMask, int usedInFixMask) { 1499b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1500b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsStatus.setStatus(svCount, prns, snrs, elevations, azimuths, 1501b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood ephemerisMask, almanacMask, usedInFixMask); 1502b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1503b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1504b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_SATELLITE_STATUS; 1505b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // remove any SV status messages already in the queue 1506b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.removeMessages(GpsStatus.GPS_EVENT_SATELLITE_STATUS); 1507b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1508b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1509b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1511e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 1512b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public void onNmeaReceived(long timestamp, String nmea) { 1513b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mNmeaListener != null) { 1514b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized (mNmeaBuffer) { 1515b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer.add(new Nmea(timestamp, nmea)); 1516b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1517b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1518b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = NMEA_RECEIVED; 1519b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // remove any NMEA_RECEIVED messages already in the queue 1520b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.removeMessages(NMEA_RECEIVED); 1521b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1522b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mGpsHandler = new Handler() { 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 1528b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (msg.what == NMEA_RECEIVED) { 1529b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized (mNmeaBuffer) { 1530b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood int length = mNmeaBuffer.size(); 1531b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood for (int i = 0; i < length; i++) { 1532b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Nmea nmea = mNmeaBuffer.get(i); 1533b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener.onNmeaReceived(nmea.mTimestamp, nmea.mNmea); 1534b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1535b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer.clear(); 1536b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1537b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } else { 1538b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // synchronize on mGpsStatus to ensure the data is copied atomically. 1539b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized(mGpsStatus) { 1540b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mListener.onGpsStatusChanged(msg.what); 1541b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds a GPS status listener. 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener GPS status listener object to register 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the listener was successfully added 1553a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa * 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_FINE_LOCATION permission is not present 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean addGpsStatusListener(GpsStatus.Listener listener) { 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean result; 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mGpsStatusListeners.get(listener) != null) { 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // listener is already registered 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport transport = new GpsStatusListenerTransport(listener); 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = mService.addGpsStatusListener(transport); 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (result) { 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGpsStatusListeners.put(listener, transport); 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in registerGpsStatusListener: ", e); 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = false; 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes a GPS status listener. 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener GPS status listener object to remove 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeGpsStatusListener(GpsStatus.Listener listener) { 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport transport = mGpsStatusListeners.remove(listener); 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (transport != null) { 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.removeGpsStatusListener(transport); 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in unregisterGpsStatusListener: ", e); 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1593b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood /** 1594b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * Adds an NMEA listener. 1595b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 159673577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link GpsStatus.NmeaListener} object to register 1597b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 1598b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * @return true if the listener was successfully added 1599b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 1600b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * @throws SecurityException if the ACCESS_FINE_LOCATION permission is not present 1601b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood */ 1602b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public boolean addNmeaListener(GpsStatus.NmeaListener listener) { 1603b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood boolean result; 1604b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1605b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mNmeaListeners.get(listener) != null) { 1606b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // listener is already registered 1607b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood return true; 1608b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1609b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood try { 1610b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport transport = new GpsStatusListenerTransport(listener); 1611b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood result = mService.addGpsStatusListener(transport); 1612b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (result) { 1613b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListeners.put(listener, transport); 1614b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1615b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } catch (RemoteException e) { 1616b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Log.e(TAG, "RemoteException in registerGpsStatusListener: ", e); 1617b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood result = false; 1618b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1619b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1620b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood return result; 1621b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1622b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1623b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood /** 1624b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * Removes an NMEA listener. 1625b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 162673577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link GpsStatus.NmeaListener} object to remove 1627b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood */ 1628b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public void removeNmeaListener(GpsStatus.NmeaListener listener) { 1629b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood try { 1630b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport transport = mNmeaListeners.remove(listener); 1631b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (transport != null) { 1632b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mService.removeGpsStatusListener(transport); 1633b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1634b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } catch (RemoteException e) { 1635b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Log.e(TAG, "RemoteException in unregisterGpsStatusListener: ", e); 1636b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1637b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1638b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves information about the current status of the GPS engine. 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This should only be called from the {@link GpsStatus.Listener#onGpsStatusChanged} 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback to ensure that the data is copied atomically. 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The caller may either pass in a {@link GpsStatus} object to set with the latest 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * status information, or pass null to create a new {@link GpsStatus} object. 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param status object containing GPS status details, or null. 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return status object containing updated GPS status. 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GpsStatus getGpsStatus(GpsStatus status) { 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (status == null) { 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status = new GpsStatus(); 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status.setStatus(mGpsStatus); 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return status; 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends additional commands to a location provider. 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be used to support provider specific extensions to the Location Manager API 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider name of the location provider. 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param command name of the command to send to the provider. 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extras optional arguments for the command (or null). 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The provider may optionally fill the extras Bundle with results from the command. 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the command succeeds. 16684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 16694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @deprecated Use {@link LocationRequest} instead, see notes on {@link LocationManager} 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly @Deprecated 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean sendExtraCommand(String provider, String command, Bundle extras) { 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.sendExtraCommand(provider, command, extras); 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in sendExtraCommand: ", e); 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1680a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa 168122d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie /** 168222d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * Used by NetInitiatedActivity to report user response 168322d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * for network initiated GPS fix requests. 168422d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * 16854e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 168622d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie */ 168722d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie public boolean sendNiResponse(int notifId, int userResponse) { 168822d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie try { 168922d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie return mService.sendNiResponse(notifId, userResponse); 169022d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } catch (RemoteException e) { 169122d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie Log.e(TAG, "RemoteException in sendNiResponse: ", e); 169222d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie return false; 169322d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } 169422d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } 1695a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa 16966fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkProvider(String provider) { 16976fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (provider == null) { 16986fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid provider: " + provider); 16996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17006fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 17026fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkCriteria(Criteria criteria) { 17036fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (criteria == null) { 17046fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid criteria: " + criteria); 17056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17066fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 17086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkListener(LocationListener listener) { 17096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (listener == null) { 17106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid listener: " + listener); 17116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 17146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private void checkPendingIntent(PendingIntent intent) { 17156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (intent == null) { 17166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid pending intent: " + intent); 17176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (!intent.isTargetedToPackage()) { 17196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly IllegalArgumentException e = new IllegalArgumentException( 17206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly "pending intent msut be targeted to package"); 17216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (mContext.getApplicationInfo().targetSdkVersion > Build.VERSION_CODES.JELLY_BEAN) { 17226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw e; 17236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } else { 17246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.w(TAG, e); 17256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17266fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17276fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17286fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 17296fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkGeofence(Geofence fence) { 17306fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (fence == null) { 17316fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid geofence: " + fence); 17326fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17336fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1735