IT. Expert System.

Android Reference

Geocoder


android.location

Class Geocoder



  • public final class Geocoder
    extends 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.
    • Constructor Summary

      Constructors
      Constructor and Description
      Geocoder(Context context)
      Constructs a Geocoder whose responses will be localized for the default system Locale.
      Geocoder(Context context, Locale locale)
      Constructs a Geocoder whose responses will be localized for the given Locale.
    • Method Summary

      Methods
      Modifier and Type Method and Description
      List<Address> getFromLocation(double latitude, double longitude, int maxResults)
      Returns an array of Addresses that are known to describe the area immediately surrounding the given latitude and longitude.
      List<Address> getFromLocationName(String locationName, int maxResults)
      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..
      List<Address> getFromLocationName(String locationName, int maxResults, double lowerLeftLatitude, double lowerLeftLongitude, double upperRightLatitude, double upperRightLongitude)
      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..
      static boolean isPresent()
      Returns true if the Geocoder methods getFromLocation and getFromLocationName are implemented.
    • Constructor Detail

      • Geocoder

        public Geocoder(Context context,
                Locale locale)
        Constructs a Geocoder whose responses will be localized for the given Locale.
        Parameters:
        context - the Context of the calling Activity
        locale - the desired Locale for the query results
        Throws:
        NullPointerException - if Locale is null
      • Geocoder

        public Geocoder(Context context)
        Constructs a Geocoder whose responses will be localized for the default system Locale.
        Parameters:
        context - the Context of the calling Activity
    • Method Detail

      • isPresent

        public static boolean isPresent()
        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.
      • getFromLocation

        public List<Address> getFromLocation(double latitude,
                                    double longitude,
                                    int maxResults)
                                      throws IOException
        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.

        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.

        Parameters:
        latitude - the latitude a point for the search
        longitude - the longitude a point for the search
        maxResults - max number of addresses to return. Smaller numbers (1 to 5) are recommended
        Returns:
        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
        IllegalArgumentException - if longitude is less than -180 or greater than 180
        IOException - if the network is unavailable or any other I/O problem occurs
      • getFromLocationName

        public List<Address> getFromLocationName(String locationName,
                                        int maxResults)
                                          throws IOException
        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.

        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.

        Parameters:
        locationName - a user-supplied description of a location
        maxResults - max number of results to return. Smaller numbers (1 to 5) are recommended
        Returns:
        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
        IOException - if the network is unavailable or any other I/O problem occurs
      • getFromLocationName

        public List<Address> getFromLocationName(String locationName,
                                        int maxResults,
                                        double lowerLeftLatitude,
                                        double lowerLeftLongitude,
                                        double upperRightLatitude,
                                        double upperRightLongitude)
                                          throws IOException
        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.

        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.

        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.

        Parameters:
        locationName - a user-supplied description of a location
        maxResults - max number of addresses to return. Smaller numbers (1 to 5) are recommended
        lowerLeftLatitude - the latitude of the lower left corner of the bounding box
        lowerLeftLongitude - the longitude of the lower left corner of the bounding box
        upperRightLatitude - the latitude of the upper right corner of the bounding box
        upperRightLongitude - the longitude of the upper right corner of the bounding box
        Returns:
        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
        IllegalArgumentException - if any latitude is less than -90 or greater than 90
        IllegalArgumentException - if any longitude is less than -180 or greater than 180
        IOException - if the network is unavailable or any other I/O problem occurs


Content

Android Reference

Java basics

Java Enterprise Edition (EE)

Java Standard Edition (SE)

SQL

HTML

PHP

CSS

Java Script

MYSQL

JQUERY

VBS

REGEX

C

C++

C#

Design patterns

RFC (standard status)

RFC (proposed standard status)

RFC (draft standard status)

RFC (informational status)

RFC (experimental status)

RFC (best current practice status)

RFC (historic status)

RFC (unknown status)

IT dictionary

License.
All information of this service is derived from the free sources and is provided solely in the form of quotations. This service provides information and interfaces solely for the familiarization (not ownership) and under the "as is" condition.
Copyright 2016 © ELTASK.COM. All rights reserved.
Site is optimized for mobile devices.
Downloads: 381 / 158861654. Delta: 0.04692 с