LocationManager.java revision d5759437eeb3137e4a05471ff0f4681c0254e81a
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 class="note">Unless noted, all Location API methods require 504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the {@link android.Manifest.permission#ACCESS_COARSE_LOCATION} or 514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permissions. 522291ca47c763d9c292865ada1450d3a094918882Victoria Lease * If your application only has the coarse permission then it will not have 532291ca47c763d9c292865ada1450d3a094918882Victoria Lease * access to the GPS or passive location providers. Other providers will still 542291ca47c763d9c292865ada1450d3a094918882Victoria Lease * return location results, but the update rate will be throttled and the exact 552291ca47c763d9c292865ada1450d3a094918882Victoria Lease * location will be obfuscated to a coarse level of accuracy. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class LocationManager { 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "LocationManager"; 59e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly 60e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly private final Context mContext; 61e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly private final ILocationManager mService; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final HashMap<GpsStatus.Listener, GpsStatusListenerTransport> mGpsStatusListeners = 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new HashMap<GpsStatus.Listener, GpsStatusListenerTransport>(); 64b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private final HashMap<GpsStatus.NmeaListener, GpsStatusListenerTransport> mNmeaListeners = 65b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood new HashMap<GpsStatus.NmeaListener, GpsStatusListenerTransport>(); 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final GpsStatus mGpsStatus = new GpsStatus(); 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the network location provider. 704e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider determines location based on 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * availability of cell tower and WiFi access points. Results are retrieved 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by means of a network lookup. 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_PROVIDER = "network"; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the GPS location provider. 784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider determines location using 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * satellites. Depending on conditions, this provider may take a while to return 812291ca47c763d9c292865ada1450d3a094918882Victoria Lease * a location fix. Requires the permission 822291ca47c763d9c292865ada1450d3a094918882Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> The extras Bundle for the GPS location provider can contain the 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * following key/value pairs: 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> satellites - the number of satellites used to derive the fix 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String GPS_PROVIDER = "gps"; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 93a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * A special location provider for receiving locations without actually initiating 944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a location fix. 954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider can be used to passively receive location updates 97a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * when other applications or services request them without actually requesting 98a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * the locations yourself. This provider will return locations generated by other 99a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood * providers. You can query the {@link Location#getProvider()} method to determine 1002291ca47c763d9c292865ada1450d3a094918882Victoria Lease * the origin of the location update. Requires the permission 1012291ca47c763d9c292865ada1450d3a094918882Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}, although if the GPS is 1022291ca47c763d9c292865ada1450d3a094918882Victoria Lease * not enabled this provider might only return coarse fixes. 103a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood */ 104a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood public static final String PASSIVE_PROVIDER = "passive"; 105a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood 106a4903f254b4711c8fc0ac5f7e3d605f4dce34f35Mike Lockwood /** 1074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Name of the Fused location provider. 1084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 1094e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This provider combines inputs for all possible location sources 1104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to provide the best possible Location fix. It is implicitly 1114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * used for all API's that involve the {@link LocationRequest} 1124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * object. 1136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly * 1146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly * @hide 1156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly */ 1166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public static final String FUSED_PROVIDER = "fused"; 1176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 1186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly /** 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for the Bundle extra holding a boolean indicating whether 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a proximity alert is entering (true) or exiting (false).. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_PROXIMITY_ENTERING = "entering"; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding an Integer status value 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a status change is broadcast using a PendingIntent. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_STATUS_CHANGED = "status"; 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding an Boolean status value 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a provider enabled/disabled event is broadcast using a PendingIntent. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_PROVIDER_ENABLED = "providerEnabled"; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Key used for a Bundle extra holding a Location value 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when a location change is broadcast using a PendingIntent. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String KEY_LOCATION_CHANGED = "location"; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 14300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * Broadcast intent action indicating that the GPS has either been 14400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * enabled or disabled. An intent extra provides this state as a boolean, 14500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * where {@code true} means enabled. 14600b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * @see #EXTRA_GPS_ENABLED 14700b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 1484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 14900b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 15000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String GPS_ENABLED_CHANGE_ACTION = 15100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood "android.location.GPS_ENABLED_CHANGE"; 15200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 15300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 1540c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick * Broadcast intent action when the configured location providers 155d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * change. For use with {@link #isProviderEnabled(String)}. If you're interacting with the 156d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * {@link android.provider.Settings.Secure#LOCATION_MODE} API, use {@link #MODE_CHANGED_ACTION} 157d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * instead. 1580c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick */ 1590c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick public static final String PROVIDERS_CHANGED_ACTION = 1600c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick "android.location.PROVIDERS_CHANGED"; 1610c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick 1620c5a04014d3833c9a82772a832d3bc6410fc52acBrad Fitzpatrick /** 16340a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill * Broadcast intent action when {@link android.provider.Settings.Secure#LOCATION_MODE} changes. 164d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * For use with the {@link android.provider.Settings.Secure#LOCATION_MODE} API. 165d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * If you're interacting with {@link #isProviderEnabled(String)}, use 166d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * {@link #PROVIDERS_CHANGED_ACTION} instead. 16740a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill * 16840a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill * In the future, there may be mode changes that do not result in 16940a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill * {@link #PROVIDERS_CHANGED_ACTION} broadcasts. 17040a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill */ 17140a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill public static final String MODE_CHANGED_ACTION = "android.location.MODE_CHANGED"; 17240a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill 17340a86c24d2601df4966c57573a5bf58b30a41990Tom O'Neill /** 17400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * Broadcast intent action indicating that the GPS has either started or 17500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * stopped receiving GPS fixes. An intent extra provides this state as a 17600b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * boolean, where {@code true} means that the GPS is actively receiving fixes. 17700b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * @see #EXTRA_GPS_ENABLED 17800b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 1794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 18000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 18100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String GPS_FIX_CHANGE_ACTION = 18200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood "android.location.GPS_FIX_CHANGE"; 18300b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 18400b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood /** 18500b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * The lookup key for a boolean that indicates whether GPS is enabled or 18600b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * disabled. {@code true} means GPS is enabled. Retrieve it with 18700b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * {@link android.content.Intent#getBooleanExtra(String,boolean)}. 18800b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood * 1894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 19000b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood */ 19100b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood public static final String EXTRA_GPS_ENABLED = "enabled"; 19200b74270c9f136a8727c5f6cda0997a3a905f385Mike Lockwood 193c750c1fb83fbdec895e236dda7207db4da14ec49David Christie /** 194c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * Broadcast intent action indicating that a high power location requests 195c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * has either started or stopped being active. The current state of 196c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * active location requests should be read from AppOpsManager using 197c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * {@code OP_MONITOR_HIGH_POWER_LOCATION}. 198c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * 199c750c1fb83fbdec895e236dda7207db4da14ec49David Christie * @hide 200c750c1fb83fbdec895e236dda7207db4da14ec49David Christie */ 201c750c1fb83fbdec895e236dda7207db4da14ec49David Christie public static final String HIGH_POWER_REQUEST_CHANGE_ACTION = 202c750c1fb83fbdec895e236dda7207db4da14ec49David Christie "android.location.HIGH_POWER_REQUEST_CHANGE"; 203c750c1fb83fbdec895e236dda7207db4da14ec49David Christie 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Map from LocationListeners to their associated ListenerTransport objects 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private HashMap<LocationListener,ListenerTransport> mListeners = 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new HashMap<LocationListener,ListenerTransport>(); 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class ListenerTransport extends ILocationListener.Stub { 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_LOCATION_CHANGED = 1; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_STATUS_CHANGED = 2; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_PROVIDER_ENABLED = 3; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int TYPE_PROVIDER_DISABLED = 4; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private LocationListener mListener; 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mListenerHandler; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ListenerTransport(LocationListener listener, Looper looper) { 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener = listener; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (looper == null) { 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler = new Handler() { 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project _handleMessage(msg); 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler = new Handler(looper) { 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project _handleMessage(msg); 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 237e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onLocationChanged(Location location) { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_LOCATION_CHANGED; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = location; 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 245e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onStatusChanged(String provider, int status, Bundle extras) { 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_STATUS_CHANGED; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle b = new Bundle(); 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putString("provider", provider); 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putInt("status", status); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extras != null) { 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project b.putBundle("extras", extras); 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = b; 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onProviderEnabled(String provider) { 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_PROVIDER_ENABLED; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = provider; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 267e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onProviderDisabled(String provider) { 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message msg = Message.obtain(); 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.what = TYPE_PROVIDER_DISABLED; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project msg.obj = provider; 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListenerHandler.sendMessage(msg); 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void _handleMessage(Message msg) { 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_LOCATION_CHANGED: 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Location location = new Location((Location) msg.obj); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onLocationChanged(location); 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_STATUS_CHANGED: 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle b = (Bundle) msg.obj; 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String provider = b.getString("provider"); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int status = b.getInt("status"); 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle extras = b.getBundle("extras"); 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onStatusChanged(provider, status, extras); 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_PROVIDER_ENABLED: 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onProviderEnabled((String) msg.obj); 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case TYPE_PROVIDER_DISABLED: 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener.onProviderDisabled((String) msg.obj); 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 29548f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood try { 29648f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood mService.locationCallbackFinished(this); 29748f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood } catch (RemoteException e) { 29848f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood Log.e(TAG, "locationCallbackFinished: RemoteException", e); 29948f17518223a2917fd82195004fbb206cb9a05a3Mike Lockwood } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this constructor because it has a parameter 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of type ILocationManager, which is a system private class. The 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * right way to create an instance of this class is using the 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * factory Context.getSystemService. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 309e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly public LocationManager(Context context, ILocationManager service) { 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 311e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly mContext = context; 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private LocationProvider createProvider(String name, ProviderProperties properties) { 3156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return new LocationProvider(name, properties); 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3194e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns a list of the names of all known location providers. 3204e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>All providers are returned, including ones that are not permitted to 3214e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be accessed by the calling activity or are currently disabled. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3234e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @return list of Strings containing names of the provider 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getAllProviders() { 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getAllProviders(); 3286fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3296fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3354e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns a list of the names of location providers. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only the providers which are currently 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabled are returned. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return list of Strings containing names of the providers 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getProviders(boolean enabledOnly) { 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 34303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getProviders(null, enabledOnly); 3446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the information associated with the location provider of the 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given name, or null if no provider exists by that name. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the provider name 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a LocationProvider, or null 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if name is null or does not exist 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the caller is not permitted to access the 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given provider. 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public LocationProvider getProvider(String name) { 3626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(name); 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3646fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ProviderProperties properties = mService.getProviderProperties(name); 3656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (properties == null) { 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3686fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return createProvider(name, properties); 3696fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3706fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a list of the names of LocationProviders that satisfy the given 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * criteria, or null if none do. Only providers that are permitted to be 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * accessed by the calling activity will be returned. 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param criteria the criteria that the returned providers must match 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only the providers which are currently 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabled are returned. 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return list of Strings containing names of the providers 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<String> getProviders(Criteria criteria, boolean enabledOnly) { 3866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 38703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood try { 38803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getProviders(criteria, enabledOnly); 3896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 3906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 39203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return null; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the name of the provider that best meets the given criteria. Only providers 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that are permitted to be accessed by the calling activity will be 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned. If several providers meet the criteria, the one with the best 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * accuracy is returned. If no provider meets the criteria, 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the criteria are loosened in the following sequence: 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> power requirement 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> accuracy 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> bearing 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> speed 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> altitude 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Note that the requirement on monetary cost is not removed 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in this process. 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param criteria the criteria that need to be matched 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabledOnly if true then only a provider that is currently enabled is returned 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return name of the provider that best matches the requirements 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getBestProvider(Criteria criteria, boolean enabledOnly) { 4186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 41903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood try { 42003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood return mService.getBestProvider(criteria, enabledOnly); 4216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 4226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a 4294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent. 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4314e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 4327ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 433f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 435f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 436f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 43773577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link LocationListener#onLocationChanged} method will be called for 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * each location update 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 441f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if provider is null or doesn't exist 442f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * on this device 443f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if listener is null 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException if the calling thread has no Looper 4454e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 4486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener) { 4496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 4506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 4516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 4526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 4536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 4546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, null, null); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a callback on 4594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the specified looper thread. 460f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 4627ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 463f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 465f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 466f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 46773577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link LocationListener#onLocationChanged} method will be called for 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * each location update 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param looper a Looper object whose message queue will be used to 4714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 4724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if listener is null 4764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4786fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 4796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener, Looper looper) { 4806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 4816fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 4826fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 4836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 4846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 4856fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 48603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 48703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 48803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 4894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using a Criteria, and a callback 4904e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * on the specified looper thread. 491f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 4924e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 4937ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 494f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 495f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 496f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 49703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 49803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 49973577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 50003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * {@link LocationListener#onLocationChanged} method will be called for 50103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * each location update 50203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 5034e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 5044e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 50503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 50603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if criteria is null 50703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 5084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 50903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 5106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(long minTime, float minDistance, Criteria criteria, 5116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationListener listener, Looper looper) { 5126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 5136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 5166fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, minTime, minDistance, false); 5176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5214e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using the named provider, and a 5224e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent. 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 5257ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider with which to register 528f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 529f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 53073577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for each location update 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 533f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * on this device 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if intent is null 5354e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(String provider, long minTime, float minDistance, 5386fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly PendingIntent intent) { 5396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 5406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 5416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 5426fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 5436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, minTime, minDistance, false); 5446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 54703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 5484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for location updates using a Criteria and pending intent. 54903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 5504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>The <code>requestLocationUpdates()</code> and 5517ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * <code>requestSingleUpdate()</code> register the current activity to be 5527ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * updated periodically by the named provider, or by the provider matching 5534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the specified {@link Criteria}, with location and status updates. 55403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 555f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> It may take a while to receive the first location update. If 55603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * an immediate location is required, applications may use the 55703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * {@link #getLastKnownLocation(String)} method. 55803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 5594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> Location updates are received either by {@link LocationListener} 5604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * callbacks, or by broadcast intents to a supplied {@link PendingIntent}. 5614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If the caller supplied a pending intent, then location updates 5634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are sent with a key of {@link #KEY_LOCATION_CHANGED} and a 5644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.location.Location} value. 5654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 5664e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The location update interval can be controlled using the minTime parameter. 567f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * The elapsed time between location updates will never be less than 568f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * minTime, although it can be more depending on the Location Provider 569f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * implementation and the update interval requested by other applications. 570f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 571f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> Choosing a sensible value for minTime is important to conserve 572f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * battery life. Each location update requires power from 573f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * GPS, WIFI, Cell and other radios. Select a minTime value as high as 574f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * possible while still providing a reasonable user experience. 575f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * If your application is not in the foreground and showing 576f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location to the user then your application should avoid using an active 577f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * provider (such as {@link #NETWORK_PROVIDER} or {@link #GPS_PROVIDER}), 578f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * but if you insist then select a minTime of 5 * 60 * 1000 (5 minutes) 579f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * or greater. If your application is in the foreground and showing 580f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location to the user then it is appropriate to select a faster 581f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * update interval. 582f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 583f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p> The minDistance parameter can also be used to control the 584f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * frequency of location updates. If it is greater than 0 then the 585f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * location provider will only send your application an update when 586f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * the location has changed by at least minDistance meters, AND 587f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * at least minTime milliseconds have passed. However it is more 588f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * difficult for location providers to save power using the minDistance 589f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * parameter, so minTime should be the primary tool to conserving battery 590f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * life. 591f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 5924e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If your application wants to passively observe location 5934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * updates triggered by other applications, but not consume 5944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * any additional power otherwise, then use the {@link #PASSIVE_PROVIDER} 5954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * This provider does not actively turn on or modify active location 5964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * providers, so you do not need to be as careful about minTime and 5974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * minDistance. However if your application performs heavy work 5984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * on a location update (such as network activity) then you should 5994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * select non-zero values for minTime and/or minDistance to rate-limit 6004e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * your update frequency in the case another application enables a 6014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location provider with extremely fast updates. 602f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 6034e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>In case the provider is disabled by the user, updates will stop, 6044e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * and a provider availability update will be sent. 6054e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * As soon as the provider is enabled again, 6064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location updates will immediately resume and a provider availability 6074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * update sent. Providers can also send status updates, at any time, 6084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * with extra's specific to the provider. If a callback was supplied 6094e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then status and availability updates are via 6104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderDisabled}, 6114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderEnabled} or 6124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onStatusChanged}. Alternately, if a 6134e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent was supplied then status and availability updates 6144e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are broadcast intents with extra keys of 6154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROVIDER_ENABLED} or {@link #KEY_STATUS_CHANGED}. 6164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 6174e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If a {@link LocationListener} is used but with no Looper specified 6184e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then the calling thread must already 6194e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be a {@link android.os.Looper} thread such as the main thread of the 6204e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * calling Activity. If a Looper is specified with a {@link LocationListener} 6214e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then callbacks are made on the supplied Looper thread. 622f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 623f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * <p class="note"> Prior to Jellybean, the minTime parameter was 624f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * only a hint, and some location provider implementations ignored it. 625f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * From Jellybean and onwards it is mandatory for Android compatible 626f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * devices to observe both the minTime and minDistance parameters. 627f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * 628f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minTime minimum time interval between location updates, in milliseconds 629f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @param minDistance minimum distance between location updates, in meters 63003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 63103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 63273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for each location update 63303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 634f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly * @throws IllegalArgumentException if criteria is null 63503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 6364e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 63703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 638f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly public void requestLocationUpdates(long minTime, float minDistance, Criteria criteria, 639f1be6861daea57ba0a1595739a899d05229d6d15Nick Pelly PendingIntent intent) { 6406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 6416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 6446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, minTime, minDistance, false); 6456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using the named provider and 6504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a callback. 65103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 6524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 6537ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 65403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 65503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param provider the name of the provider with which to register 65673577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 657e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * {@link LocationListener#onLocationChanged} method will be called when 658e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * the location update is available 65903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 6604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 6614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 66203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 66303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 66403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 6654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 66603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 66703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(String provider, LocationListener listener, Looper looper) { 6686fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 6696fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 6706fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 6716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 6726fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 6736fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 67403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 67503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 67603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 6774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a Criteria and 6784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a callback. 67903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 6804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 6817ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 68203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 68303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 68403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 68573577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 686e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * {@link LocationListener#onLocationChanged} method will be called when 687e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * the location update is available 68803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param looper a Looper object whose message queue will be used to 6894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 6904e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 69103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 69203ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if criteria is null 69303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if listener is null 6944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 69503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 69603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(Criteria criteria, LocationListener listener, Looper looper) { 6976fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 6986fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 6996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7006fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 7016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, 0, 0, true); 7026fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 70303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 70403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 70503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 7064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a named provider and pending intent. 70703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7097ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 710e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * 71103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param provider the name of the provider with which to register 71273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 71303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 71403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 71503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 7164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 71703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 71803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(String provider, PendingIntent intent) { 7196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 7206fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 7216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 7236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 7246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 72503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 72603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 72703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 7284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for a single location update using a Criteria and pending intent. 72903ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 7304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} 7317ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * for more detail on how to use this method. 732e23fc8ee13605dace4a7abcdf85caec639407786Amith Yamasani * 73303ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @param criteria contains parameters for the location manager to choose the 73403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * appropriate provider and parameters to compute the location 73573577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 73603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * 73703ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if provider is null or doesn't exist 73803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood * @throws IllegalArgumentException if intent is null 7394e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 74003ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood */ 74103ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood public void requestSingleUpdate(Criteria criteria, PendingIntent intent) { 7426fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkCriteria(criteria); 7436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 7446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedCriteria( 7466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly criteria, 0, 0, true); 7476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 7486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 7496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 7504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 7514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for fused location updates using a LocationRequest and callback. 7524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7538761e143c987fc48d854818988cde44700c9f602Scott Main * <p>Upon a location update, the system delivers the new {@link Location} to the 7548761e143c987fc48d854818988cde44700c9f602Scott Main * provided {@link LocationListener}, by calling its {@link 7558761e143c987fc48d854818988cde44700c9f602Scott Main * LocationListener#onLocationChanged} method.</p> 7568761e143c987fc48d854818988cde44700c9f602Scott Main * 7574e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>The system will automatically select and enable the best providers 7584e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to compute a location for your application. It may use only passive 7594e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * locations, or just a single location source, or it may fuse together 7604e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * multiple location sources in order to produce the best possible 7614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * result, depending on the quality of service requested in the 7624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest}. 7634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7644e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>LocationRequest can be null, in which case the system will choose 7654e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * default, low power parameters for location updates. You will occasionally 7664e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * receive location updates as available, without a major power impact on the 7674e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * system. If your application just needs an occasional location update 7684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * without any strict demands, then pass a null LocationRequest. 7694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7704e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Only one LocationRequest can be registered for each unique callback 7714e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * or pending intent. So a subsequent request with the same callback or 7724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * pending intent will over-write the previous LocationRequest. 7734e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> If a pending intent is supplied then location updates 7754e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * are sent with a key of {@link #KEY_LOCATION_CHANGED} and a 7764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link android.location.Location} value. If a callback is supplied 7774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * then location updates are made using the 7784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onLocationChanged} callback, on the specified 7794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Looper thread. If a {@link LocationListener} is used 7804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * but with a null Looper then the calling thread must already 7814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be a {@link android.os.Looper} thread (such as the main thread) and 7824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * callbacks will occur on this thread. 7834e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 7844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> Provider status updates and availability updates are deprecated 7854e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * because the system is performing provider fusion on the applications 7864e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * behalf. So {@link LocationListener#onProviderDisabled}, 7874e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onProviderEnabled}, {@link LocationListener#onStatusChanged} 7884e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * will not be called, and intents with extra keys of 7894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROVIDER_ENABLED} or {@link #KEY_STATUS_CHANGED} will not 7904e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * be received. 7914e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 79273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * <p> To unregister for Location updates, use: {@link #removeUpdates(LocationListener)}. 79373577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * 7944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 79573577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link LocationListener} whose 7964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationListener#onLocationChanged} method will be called when 7974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * the location update is available 7984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param looper a Looper object whose message queue will be used to 7994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * implement the callback mechanism, or null to make callbacks on the calling 8004e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * thread 8014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if listener is null 8034e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 8047ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 8057ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 8064e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 8076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(LocationRequest request, LocationListener listener, 8086fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Looper looper) { 8096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 8106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, listener, looper, null); 8116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8126fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8134e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 8144e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 8154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Register for fused location updates using a LocationRequest and a pending intent. 8164e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8178761e143c987fc48d854818988cde44700c9f602Scott Main * <p>Upon a location update, the system delivers the new {@link Location} with your provided 8188761e143c987fc48d854818988cde44700c9f602Scott Main * {@link PendingIntent}, as the value for {@link LocationManager#KEY_LOCATION_CHANGED} 8198761e143c987fc48d854818988cde44700c9f602Scott Main * in the intent's extras.</p> 8208761e143c987fc48d854818988cde44700c9f602Scott Main * 82173577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * <p> To unregister for Location updates, use: {@link #removeUpdates(PendingIntent)}. 82273577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * 8234e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> See {@link #requestLocationUpdates(LocationRequest, LocationListener, Looper)} 8244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * for more detail. 8254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 82773577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param intent a {@link PendingIntent} to be sent for the location update 8284e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 8304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 8317ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 8327ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 8334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 8346fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void requestLocationUpdates(LocationRequest request, PendingIntent intent) { 8356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 8366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requestLocationUpdates(request, null, null, intent); 8376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8386fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private ListenerTransport wrapListener(LocationListener listener, Looper looper) { 8406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (listener == null) return null; 8416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly synchronized (mListeners) { 8426fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport = mListeners.get(listener); 8436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (transport == null) { 8446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly transport = new ListenerTransport(listener, looper); 8456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mListeners.put(listener, transport); 8476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return transport; 84803ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 8496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 8506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private void requestLocationUpdates(LocationRequest request, LocationListener listener, 8526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Looper looper, PendingIntent intent) { 8536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 8556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // wrap the listener class 8576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport = wrapListener(listener, looper); 8586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8596fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 8606fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestLocationUpdates(request, transport, intent, packageName); 8616fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 8626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 8636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 86403ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood } 86503ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood 86603ca216ac19ea4e7afcb183c20c7c780f0d97756Mike Lockwood /** 8674e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Removes all location updates for the specified LocationListener. 8684e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8694e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Following this call, updates will no longer 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * occur for this listener. 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param listener listener object that no longer needs location updates 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if listener is null 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeUpdates(LocationListener listener) { 8766fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkListener(listener); 8776fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 8786fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ListenerTransport transport; 8806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly synchronized (mListeners) { 8816fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly transport = mListeners.remove(listener); 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8836fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (transport == null) return; 8846fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeUpdates(transport, null, packageName); 8876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 8886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Removes all location updates for the specified pending intent. 8944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 8954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Following this call, updates will no longer for this pending intent. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent pending intent object that no longer needs location updates 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if intent is null 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeUpdates(PendingIntent intent) { 9016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 9026fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 9036fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeUpdates(null, intent, packageName); 9066fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 9076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9124e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Set a proximity alert for the location given by the position 9134e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * (latitude, longitude) and the given radius. 9144e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9154e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> When the device 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * detects that it has entered or exited the area surrounding the 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * location, the given PendingIntent will be used to create an Intent 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to be fired. 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> The fired Intent will have a boolean extra added with key 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #KEY_PROXIMITY_ENTERING}. If the value is true, the device is 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * entering the proximity region; if false, it is exiting. 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Due to the approximate nature of position estimation, if the 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device passes through the given area briefly, it is possible 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that no Intent will be fired. Similarly, an Intent could be 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fired if the device passes very close to the given area but 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not actually enter it. 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> After the number of milliseconds given by the expiration 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameter, the location manager will delete this proximity 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert and no longer monitor it. A value of -1 indicates that 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there should be no expiration time. 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> Internally, this method uses both {@link #NETWORK_PROVIDER} 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link #GPS_PROVIDER}. 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9384fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * <p>Before API version 17, this method could be used with 9394fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or 9404fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. 9414fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * From API version 17 and onwards, this method requires 9424fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission. 9434fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param latitude the latitude of the central point of the 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param longitude the longitude of the central point of the 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius the radius of the central point of the 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * alert region, in meters 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param expiration time for this proximity alert, in milliseconds, 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 to indicate no expiration 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent a PendingIntent that will be used to generate an Intent to 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fire when entry to or exit from the alert region is detected 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9554fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 9564fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void addProximityAlert(double latitude, double longitude, float radius, long expiration, 9596fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly PendingIntent intent) { 9606fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 9616fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (expiration < 0) expiration = Long.MAX_VALUE; 9626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Geofence fence = Geofence.createCircle(latitude, longitude, radius); 9646fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = new LocationRequest().setExpireIn(expiration); 9656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 9666fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestGeofence(request, fence, intent, mContext.getPackageName()); 9676fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 9686fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9706fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 9716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 9724e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 9734e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Add a geofence with the specified LocationRequest quality of service. 9744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9754e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> When the device 9764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * detects that it has entered or exited the area surrounding the 9774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location, the given PendingIntent will be used to create an Intent 9784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to be fired. 9794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The fired Intent will have a boolean extra added with key 9814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link #KEY_PROXIMITY_ENTERING}. If the value is true, the device is 9824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * entering the proximity region; if false, it is exiting. 9834e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The geofence engine fuses results from all location providers to 9854e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * provide the best balance between accuracy and power. Applications 9864e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * can choose the quality of service required using the 9874e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * {@link LocationRequest} object. If it is null then a default, 9884e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * low power geo-fencing implementation is used. It is possible to cross 9894e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * a geo-fence without notification, but the system will do its best 9904e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * to detect, using {@link LocationRequest} as a hint to trade-off 9914e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * accuracy and power. 9924e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9934e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> The power required by the geofence engine can depend on many factors, 9944e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * such as quality and interval requested in {@link LocationRequest}, 9954e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * distance to nearest geofence and current device velocity. 9964e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 9974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param request quality of service required, null for default low power 9984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param fence a geographical description of the geofence area 9994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent pending intent to receive geofence updates 10004e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10014e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if fence is null 10024e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10034fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10044fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10057ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 10067ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 10074e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 10084e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly public void addGeofence(LocationRequest request, Geofence fence, PendingIntent intent) { 10096fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10106fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkGeofence(fence); 10116fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10136fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.requestGeofence(request, fence, intent, mContext.getPackageName()); 10146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes the proximity alert with the given PendingIntent. 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10224fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * <p>Before API version 17, this method could be used with 10234fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or 10244fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. 10254fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * From API version 17 and onwards, this method requires 10264fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * {@link android.Manifest.permission#ACCESS_FINE_LOCATION} permission. 10274fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent the PendingIntent that no longer needs to be notified of 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proximity alerts 10304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10314e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10324fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10334fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeProximityAlert(PendingIntent intent) { 10366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 10386fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 10406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(null, intent, packageName); 10416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10426fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 10456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10464e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 10474e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Remove a single geofence. 10484e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10494e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This removes only the specified geofence associated with the 10504e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * specified pending intent. All other geofences remain unchanged. 10514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param fence a geofence previously passed to {@link #addGeofence} 10534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent a pending intent previously passed to {@link #addGeofence} 10544e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10554e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if fence is null 10564e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10574fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10584fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10597ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 10607ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 10614e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 10626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void removeGeofence(Geofence fence, PendingIntent intent) { 10636fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10646fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkGeofence(fence); 10656fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 10666fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10686fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(fence, intent, packageName); 10696fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10706fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 10726fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 10736fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10744e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 10754e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Remove all geofences registered to the specified pending intent. 10764e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10774e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @param intent a pending intent previously passed to {@link #addGeofence} 10784e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10794e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws IllegalArgumentException if intent is null 10804fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * @throws SecurityException if {@link android.Manifest.permission#ACCESS_FINE_LOCATION} 10814fab68b5324e1f9b6765cdc33e66d1f074623dc2Victoria Lease * permission is not present 10827ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 10837ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 10844e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 10856fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly public void removeAllGeofences(PendingIntent intent) { 10866fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkPendingIntent(intent); 10876fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly String packageName = mContext.getPackageName(); 10886fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 10896fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 10906fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.removeGeofence(null, intent, packageName); 10916fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 10926fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10974e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Returns the current enabled/disabled status of the given provider. 10984e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 10994e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>If the user has enabled this provider in the Settings menu, true 11004e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * is returned otherwise false is returned 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1102d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * <p>Callers should instead use 1103d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * {@link android.provider.Settings.Secure#LOCATION_MODE} 1104d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * unless they depend on provider-specific APIs such as 1105d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * {@link #requestLocationUpdates(String, long, float, LocationListener)}. 1106d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider 1108d5759437eeb3137e4a05471ff0f4681c0254e81aTom O'Neill * @return true if the provider exists and is enabled 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1110f4d207b1c2212d6e9adc3e7954a8d14c6b9abc51Mike Lockwood * @throws IllegalArgumentException if provider is null 11114e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isProviderEnabled(String provider) { 11146fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 11156fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isProviderEnabled(provider); 11186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11196fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11244e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly /** 11254e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * Get the last known location. 11264e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11274e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>This location could be very old so use 11284118012da9a22694b3353040a485f8cdc27e2f17Philip Milne * {@link Location#getElapsedRealtimeNanos} to calculate its age. It can 11294e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * also return null if no previous location is available. 11304e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11314e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p>Always returns immediately. 11324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11334e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @return The last known location, or null if not available 11344e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 11357ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * 11367ab7f538924371a9dd4be7a27a6ae3b4c04b301cLaurent Tu * @hide 11374e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly */ 11384e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly public Location getLastLocation() { 11394035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly String packageName = mContext.getPackageName(); 11404035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly 11416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 11424035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly return mService.getLastLocation(null, packageName); 11436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return null; 11466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a Location indicating the data from the last known 11514e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * location fix obtained from the given provider. 11524e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * 11534e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * <p> This can be done 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without starting the provider. Note that this location could 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be out-of-date, for example if the device was turned off and 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * moved to another location. 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> If the provider is currently disabled, null is returned. 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the name of the provider 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the last known location for the provider, or null 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11634e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @throws SecurityException if no suitable permission is present 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if provider is null or doesn't exist 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Location getLastKnownLocation(String provider) { 11676fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly checkProvider(provider); 11684035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly String packageName = mContext.getPackageName(); 11696fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly LocationRequest request = LocationRequest.createFromDeprecatedProvider( 11706fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly provider, 0, 0, true); 11716fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11726fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly try { 11734035f5a7c191a68bc9a5912ce44c43c82e9e5dbfNick Pelly return mService.getLastLocation(request, packageName); 11746fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 11756fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 11766fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly return null; 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11786fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 11796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 11804e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // --- Mock provider support --- 11814e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // TODO: It would be fantastic to deprecate mock providers entirely, and replace 11824e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // with something closer to LocationProviderBase.java 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a mock location provider and adds it to the set of active providers. 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the provider name 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION} system setting is not enabled 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if a provider with the given name already exists 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addTestProvider(String name, boolean requiresNetwork, boolean requiresSatellite, 11956fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly boolean requiresCell, boolean hasMonetaryCost, boolean supportsAltitude, 11966fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly boolean supportsSpeed, boolean supportsBearing, int powerRequirement, int accuracy) { 11976fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly ProviderProperties properties = new ProviderProperties(requiresNetwork, 11986fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly requiresSatellite, requiresCell, hasMonetaryCost, supportsAltitude, supportsSpeed, 11996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly supportsBearing, powerRequirement, accuracy); 12006fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (name.matches(LocationProvider.BAD_CHARS_REGEX)) { 12016fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("provider name contains illegal character: " + name); 12026fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 12036fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12056fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly mService.addTestProvider(name, properties); 12066fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12076fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes the mock location provider with the given name. 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeTestProvider(String provider) { 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.removeTestProvider(provider); 12246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12302eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * Sets a mock location for the given provider. 12312eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * <p>This location will be used in place of any actual location from the provider. 12322eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * The location object must have a minimum number of fields set to be 12332eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * considered a valid LocationProvider Location, as per documentation 12342eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * on {@link Location} class. 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param loc the mock location 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12432eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly * @throws IllegalArgumentException if the location is incomplete 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderLocation(String provider, Location loc) { 12462eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly if (!loc.isComplete()) { 12476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly IllegalArgumentException e = new IllegalArgumentException( 12486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly "Incomplete location object, missing timestamp or accuracy? " + loc); 12492eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly if (mContext.getApplicationInfo().targetSdkVersion <= Build.VERSION_CODES.JELLY_BEAN) { 12506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // just log on old platform (for backwards compatibility) 12516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.w(TAG, e); 12522eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly loc.makeComplete(); 12532eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } else { 12546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly // really throw it! 12556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw e; 12562eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } 12572eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly } 12582eeeec248a38ff33999c83f4b8d5bab7d50e79d2Nick Pelly 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderLocation(provider, loc); 12616fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12626fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any mock location associated with the given provider. 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderLocation(String provider) { 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderLocation(provider); 12796fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 12806fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets a mock enabled value for the given provider. This value will be used in place 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of any actual value from the provider. 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled the mock enabled value 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderEnabled(String provider, boolean enabled) { 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderEnabled(provider, enabled); 12996fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13006fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes any mock enabled value associated with the given provider. 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderEnabled(String provider) { 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderEnabled(provider); 13176fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13186fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets mock status values for the given provider. These values will be used in place 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of any actual values from the provider. 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param status the mock status 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extras a Bundle containing mock extras 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param updateTime the mock update time 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setTestProviderStatus(String provider, int status, Bundle extras, long updateTime) { 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setTestProviderStatus(provider, status, extras, updateTime); 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 * Removes any mock status values associated with the given provider. 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider the provider name 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_MOCK_LOCATION permission is not present 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or the {@link android.provider.Settings.Secure#ALLOW_MOCK_LOCATION 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Settings.Secure.ALLOW_MOCK_LOCATION}} system setting is not enabled 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if no provider with the given name exists 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearTestProviderStatus(String provider) { 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.clearTestProviderStatus(provider); 13576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } catch (RemoteException e) { 13586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.e(TAG, "RemoteException", e); 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13624e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly // --- GPS-specific support --- 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // This class is used to send GPS status events to the client's main thread. 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class GpsStatusListenerTransport extends IGpsStatusListener.Stub { 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final GpsStatus.Listener mListener; 1368b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private final GpsStatus.NmeaListener mNmeaListener; 1369b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1370b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // This must not equal any of the GpsStatus event IDs 1371b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private static final int NMEA_RECEIVED = 1000; 1372b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1373b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private class Nmea { 1374b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood long mTimestamp; 1375b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood String mNmea; 1376b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1377b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Nmea(long timestamp, String nmea) { 1378b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mTimestamp = timestamp; 1379b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmea = nmea; 1380b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1381b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1382b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood private ArrayList<Nmea> mNmeaBuffer; 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport(GpsStatus.Listener listener) { 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mListener = listener; 1386b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener = null; 1387b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1388b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1389b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport(GpsStatus.NmeaListener listener) { 1390b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener = listener; 1391b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mListener = null; 1392b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer = new ArrayList<Nmea>(); 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1395e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onGpsStarted() { 1397b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1398b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1399b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_STARTED; 1400b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1401b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1404e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onGpsStopped() { 1406b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1407b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1408b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_STOPPED; 1409b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1410b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1413e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onFirstFix(int ttff) { 1415b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1416b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsStatus.setTimeToFirstFix(ttff); 1417b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1418b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_FIRST_FIX; 1419b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1420b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1423e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onSvStatusChanged(int svCount, int[] prns, float[] snrs, 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] elevations, float[] azimuths, int ephemerisMask, 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int almanacMask, int usedInFixMask) { 1427b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mListener != null) { 1428b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsStatus.setStatus(svCount, prns, snrs, elevations, azimuths, 1429b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood ephemerisMask, almanacMask, usedInFixMask); 1430b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1431b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1432b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = GpsStatus.GPS_EVENT_SATELLITE_STATUS; 1433b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // remove any SV status messages already in the queue 1434b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.removeMessages(GpsStatus.GPS_EVENT_SATELLITE_STATUS); 1435b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1436b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1437b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1439e0fd693c6098f59004f9e96ad75c058e26c337b0Nick Pelly @Override 1440b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public void onNmeaReceived(long timestamp, String nmea) { 1441b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mNmeaListener != null) { 1442b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized (mNmeaBuffer) { 1443b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer.add(new Nmea(timestamp, nmea)); 1444b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1445b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Message msg = Message.obtain(); 1446b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood msg.what = NMEA_RECEIVED; 1447b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // remove any NMEA_RECEIVED messages already in the queue 1448b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.removeMessages(NMEA_RECEIVED); 1449b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mGpsHandler.sendMessage(msg); 1450b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mGpsHandler = new Handler() { 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 1456b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (msg.what == NMEA_RECEIVED) { 1457b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized (mNmeaBuffer) { 1458b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood int length = mNmeaBuffer.size(); 1459b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood for (int i = 0; i < length; i++) { 1460b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Nmea nmea = mNmeaBuffer.get(i); 1461b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListener.onNmeaReceived(nmea.mTimestamp, nmea.mNmea); 1462b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1463b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaBuffer.clear(); 1464b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1465b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } else { 1466b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // synchronize on mGpsStatus to ensure the data is copied atomically. 1467b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood synchronized(mGpsStatus) { 1468b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mListener.onGpsStatusChanged(msg.what); 1469b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds a GPS status listener. 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener GPS status listener object to register 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the listener was successfully added 1481a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa * 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException if the ACCESS_FINE_LOCATION permission is not present 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean addGpsStatusListener(GpsStatus.Listener listener) { 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean result; 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mGpsStatusListeners.get(listener) != null) { 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // listener is already registered 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport transport = new GpsStatusListenerTransport(listener); 1493a06de0f29b58df9246779cc4bfd8f06f7205ddb6Dianne Hackborn result = mService.addGpsStatusListener(transport, mContext.getPackageName()); 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (result) { 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGpsStatusListeners.put(listener, transport); 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in registerGpsStatusListener: ", e); 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project result = false; 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return result; 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Removes a GPS status listener. 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param listener GPS status listener object to remove 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeGpsStatusListener(GpsStatus.Listener listener) { 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GpsStatusListenerTransport transport = mGpsStatusListeners.remove(listener); 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (transport != null) { 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.removeGpsStatusListener(transport); 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in unregisterGpsStatusListener: ", e); 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1521b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood /** 1522b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * Adds an NMEA listener. 1523b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 152473577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link GpsStatus.NmeaListener} object to register 1525b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 1526b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * @return true if the listener was successfully added 1527b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 1528b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * @throws SecurityException if the ACCESS_FINE_LOCATION permission is not present 1529b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood */ 1530b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public boolean addNmeaListener(GpsStatus.NmeaListener listener) { 1531b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood boolean result; 1532b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1533b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (mNmeaListeners.get(listener) != null) { 1534b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood // listener is already registered 1535b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood return true; 1536b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1537b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood try { 1538b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport transport = new GpsStatusListenerTransport(listener); 1539a06de0f29b58df9246779cc4bfd8f06f7205ddb6Dianne Hackborn result = mService.addGpsStatusListener(transport, mContext.getPackageName()); 1540b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (result) { 1541b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mNmeaListeners.put(listener, transport); 1542b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1543b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } catch (RemoteException e) { 1544b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Log.e(TAG, "RemoteException in registerGpsStatusListener: ", e); 1545b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood result = false; 1546b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1547b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1548b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood return result; 1549b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1550b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 1551b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood /** 1552b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * Removes an NMEA listener. 1553b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood * 155473577888ec48bcb1eb5053f8dc3ba4eb33eb6f1aPhilip Milne * @param listener a {@link GpsStatus.NmeaListener} object to remove 1555b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood */ 1556b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood public void removeNmeaListener(GpsStatus.NmeaListener listener) { 1557b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood try { 1558b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood GpsStatusListenerTransport transport = mNmeaListeners.remove(listener); 1559b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood if (transport != null) { 1560b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood mService.removeGpsStatusListener(transport); 1561b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1562b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } catch (RemoteException e) { 1563b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood Log.e(TAG, "RemoteException in unregisterGpsStatusListener: ", e); 1564b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1565b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood } 1566b16e7800be4f879135f239f1f8f586f3712df01eMike Lockwood 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves information about the current status of the GPS engine. 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This should only be called from the {@link GpsStatus.Listener#onGpsStatusChanged} 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * callback to ensure that the data is copied atomically. 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The caller may either pass in a {@link GpsStatus} object to set with the latest 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * status information, or pass null to create a new {@link GpsStatus} object. 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param status object containing GPS status details, or null. 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return status object containing updated GPS status. 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GpsStatus getGpsStatus(GpsStatus status) { 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (status == null) { 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project status = new GpsStatus(); 158154ca7aef2e12b240caa6fb1a1e65abd234bea337Victoria Lease } 158254ca7aef2e12b240caa6fb1a1e65abd234bea337Victoria Lease status.setStatus(mGpsStatus); 158354ca7aef2e12b240caa6fb1a1e65abd234bea337Victoria Lease return status; 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends additional commands to a location provider. 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be used to support provider specific extensions to the Location Manager API 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param provider name of the location provider. 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param command name of the command to send to the provider. 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extras optional arguments for the command (or null). 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The provider may optionally fill the extras Bundle with results from the command. 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the command succeeds. 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean sendExtraCommand(String provider, String command, Bundle extras) { 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.sendExtraCommand(provider, command, extras); 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "RemoteException in sendExtraCommand: ", e); 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1605a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa 160622d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie /** 160722d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * Used by NetInitiatedActivity to report user response 160822d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * for network initiated GPS fix requests. 160922d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie * 16104e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly * @hide 161122d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie */ 161222d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie public boolean sendNiResponse(int notifId, int userResponse) { 161322d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie try { 161422d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie return mService.sendNiResponse(notifId, userResponse); 161522d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } catch (RemoteException e) { 161622d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie Log.e(TAG, "RemoteException in sendNiResponse: ", e); 161722d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie return false; 161822d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } 161922d1f9fb23015471de6af1a70e40fb5c82ecb665Danke Xie } 1620a550bdc84af70babb48091197bfb1b93d3671664Daisuke Miyakawa 16216fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkProvider(String provider) { 16226fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (provider == null) { 16236fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid provider: " + provider); 16246fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16256fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16266fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 16276fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkCriteria(Criteria criteria) { 16286fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (criteria == null) { 16296fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid criteria: " + criteria); 16306fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16316fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16324e31c4fffbc42b4c2b5dca6431cfeef9e078f5b4Nick Pelly 16336fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkListener(LocationListener listener) { 16346fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (listener == null) { 16356fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid listener: " + listener); 16366fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16376fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16386fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 16396fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private void checkPendingIntent(PendingIntent intent) { 16406fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (intent == null) { 16416fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid pending intent: " + intent); 16426fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16436fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (!intent.isTargetedToPackage()) { 16446fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly IllegalArgumentException e = new IllegalArgumentException( 16456fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly "pending intent msut be targeted to package"); 16466fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (mContext.getApplicationInfo().targetSdkVersion > Build.VERSION_CODES.JELLY_BEAN) { 16476fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw e; 16486fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } else { 16496fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly Log.w(TAG, e); 16506fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16516fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16526fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16536fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly 16546fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly private static void checkGeofence(Geofence fence) { 16556fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly if (fence == null) { 16566fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly throw new IllegalArgumentException("invalid geofence: " + fence); 16576fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16586fa9ad4afcd762aea519ff61811386c23d18ddb2Nick Pelly } 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1660