From 01ac80b715881db22bde8b31633dd8a4dc375389 Mon Sep 17 00:00:00 2001
From: Mark Vandevoorde <mtv@google.com>
Date: Fri, 21 May 2010 15:43:26 -0700
Subject: [PATCH] Add Geocorder.isImplemented()

The Geocorder interface is not part of the Android core.  It
requires a backend service which may or may not be available
on a device.  The new isImplemented static method allows
apps to discover whether the Geocorder is in fact available
on the device.

Change-Id: I2b5cf7bcc9cce4766bcbb156e91edf34b01f9296
---
 api/current.xml                               | 11 ++++++++++
 location/java/android/location/Geocoder.java  | 21 ++++++++++++++++++-
 .../android/location/ILocationManager.aidl    |  1 +
 .../server/LocationManagerService.java        |  4 ++++
 4 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/api/current.xml b/api/current.xml
index 3e3703564a8a4..923a7b6b3c189 100644
--- a/api/current.xml
+++ b/api/current.xml
@@ -82140,6 +82140,17 @@
 <exception name="IOException" type="java.io.IOException">
 </exception>
 </method>
+<method name="isImplemented"
+ return="java.lang.Boolean"
+ abstract="false"
+ native="false"
+ synchronized="false"
+ static="true"
+ final="false"
+ deprecated="not deprecated"
+ visibility="public"
+>
+</method>
 </class>
 <class name="GeocoderParams"
  extends="java.lang.Object"
diff --git a/location/java/android/location/Geocoder.java b/location/java/android/location/Geocoder.java
index c325b1b0c3c8c..546bb9d84c738 100644
--- a/location/java/android/location/Geocoder.java
+++ b/location/java/android/location/Geocoder.java
@@ -40,7 +40,9 @@ import java.util.List;
  *
  * The Geocoder class requires a backend service that is not included in
  * the core android framework.  The Geocoder query methods will return an
- * empty list if there no backend service in the platform.
+ * empty list if there no backend service in the platform.  Use the
+ * isImplemented() method to determine whether a Geocoder implementation
+ * exists.
  */
 public final class Geocoder {
     private static final String TAG = "Geocoder";
@@ -48,6 +50,23 @@ public final class Geocoder {
     private GeocoderParams mParams;
     private ILocationManager mService;
 
+    /**
+     * Returns true if the Geocoder methods getFromLocation and
+     * getFromLocationName are implemented.  Lack of network
+     * connectivity may still cause these methods to return null or
+     * empty lists.
+     */
+    public static Boolean isImplemented() {
+        IBinder b = ServiceManager.getService(Context.LOCATION_SERVICE);
+        ILocationManager lm = ILocationManager.Stub.asInterface(b);
+        try {
+            return lm.geocoderIsImplemented();
+        } catch (RemoteException e) {
+            Log.e(TAG, "isImplemented: got RemoteException", e);
+            return false;
+        }
+    }
+
     /**
      * Constructs a Geocoder whose responses will be localized for the
      * given Locale.
diff --git a/location/java/android/location/ILocationManager.aidl b/location/java/android/location/ILocationManager.aidl
index a86f329852b14..32d4b274f00ca 100644
--- a/location/java/android/location/ILocationManager.aidl
+++ b/location/java/android/location/ILocationManager.aidl
@@ -67,6 +67,7 @@ interface ILocationManager
     // it need not be shared with other providers.
     void reportLocation(in Location location, boolean passive);
 
+    boolean geocoderIsImplemented();
     String getFromLocation(double latitude, double longitude, int maxResults,
         in GeocoderParams params, out List<Address> addrs);
     String getFromLocationName(String locationName,
diff --git a/services/java/com/android/server/LocationManagerService.java b/services/java/com/android/server/LocationManagerService.java
index 74249f3951f5c..14d5995de9d9e 100644
--- a/services/java/com/android/server/LocationManagerService.java
+++ b/services/java/com/android/server/LocationManagerService.java
@@ -1940,6 +1940,10 @@ public class LocationManagerService extends ILocationManager.Stub implements Run
 
     // Geocoder
 
+    public Boolean geocoderIsImplemented() {
+        return mGeocodeProvider != null;
+    }
+
     public String getFromLocation(double latitude, double longitude, int maxResults,
             GeocoderParams params, List<Address> addrs) {
         if (mGeocodeProvider != null) {