/**@class android.location.Geocoder
@extends java.lang.Object

 A class for handling geocoding and reverse geocoding.  Geocoding is
 the process of transforming a street address or other description
 of a location into a (latitude, longitude) coordinate.  Reverse
 geocoding is the process of transforming a (latitude, longitude)
 coordinate into a (partial) address.  The amount of detail in a
 reverse geocoded location description may vary, for example one
 might contain the full street address of the closest building, while
 another might contain only a city name and postal code.

 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.  Use the
 isPresent() method to determine whether a Geocoder implementation
 exists.
*/
var Geocoder = {

/**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.
*/
isPresent : function(  ) {},

/**Returns an array of Addresses that are known to describe the
 area immediately surrounding the given latitude and longitude.
 The returned addresses will be localized for the locale
 provided to this class's constructor.

 <p> The returned values may be obtained by means of a network lookup.
 The results are a best guess and are not guaranteed to be meaningful or
 correct. It may be useful to call this method from a thread separate from your
 primary UI thread.
@param {Number} latitude the latitude a point for the search
@param {Number} longitude the longitude a point for the search
@param {Number} maxResults max number of addresses to return. Smaller numbers (1 to 5) are recommended
@return {Object {java.util.List}} a list of Address objects. Returns null or empty list if no matches were
 found or there is no backend service available.
@throws IllegalArgumentException if latitude is
 less than -90 or greater than 90
@throws IllegalArgumentException if longitude is
 less than -180 or greater than 180
@throws IOException if the network is unavailable or any other
 I/O problem occurs
*/
getFromLocation : function(  ) {},

/**Returns an array of Addresses that are known to describe the
 named location, which may be a place name such as "Dalvik,
 Iceland", an address such as "1600 Amphitheatre Parkway,
 Mountain View, CA", an airport code such as "SFO", etc..  The
 returned addresses will be localized for the locale provided to
 this class's constructor.

 <p> The query will block and returned values will be obtained by means of a network lookup.
 The results are a best guess and are not guaranteed to be meaningful or
 correct. It may be useful to call this method from a thread separate from your
 primary UI thread.
@param {String} locationName a user-supplied description of a location
@param {Number} maxResults max number of results to return. Smaller numbers (1 to 5) are recommended
@return {Object {java.util.List}} a list of Address objects. Returns null or empty list if no matches were
 found or there is no backend service available.
@throws IllegalArgumentException if locationName is null
@throws IOException if the network is unavailable or any other
 I/O problem occurs
*/
getFromLocationName : function(  ) {},

/**Returns an array of Addresses that are known to describe the
 named location, which may be a place name such as "Dalvik,
 Iceland", an address such as "1600 Amphitheatre Parkway,
 Mountain View, CA", an airport code such as "SFO", etc..  The
 returned addresses will be localized for the locale provided to
 this class's constructor.

 <p> You may specify a bounding box for the search results by including
 the Latitude and Longitude of the Lower Left point and Upper Right
 point of the box.

 <p> The query will block and returned values will be obtained by means of a network lookup.
 The results are a best guess and are not guaranteed to be meaningful or
 correct. It may be useful to call this method from a thread separate from your
 primary UI thread.
@param {String} locationName a user-supplied description of a location
@param {Number} maxResults max number of addresses to return. Smaller numbers (1 to 5) are recommended
@param {Number} lowerLeftLatitude the latitude of the lower left corner of the bounding box
@param {Number} lowerLeftLongitude the longitude of the lower left corner of the bounding box
@param {Number} upperRightLatitude the latitude of the upper right corner of the bounding box
@param {Number} upperRightLongitude the longitude of the upper right corner of the bounding box
@return {Object {java.util.List}} a list of Address objects. Returns null or empty list if no matches were
 found or there is no backend service available.
@throws IllegalArgumentException if locationName is null
@throws IllegalArgumentException if any latitude is
 less than -90 or greater than 90
@throws IllegalArgumentException if any longitude is
 less than -180 or greater than 180
@throws IOException if the network is unavailable or any other
 I/O problem occurs
*/
getFromLocationName : function(  ) {},


};