Most visited

Recently visited

Results for

Added in API level 1
Summary: Ctors | Methods | Inherited Methods | [Expand All]

Geocoder

public final class Geocoder
extends Object

java.lang.Object
   ↳ android.location.Geocoder

处理地理编码和反向地理编码的类。 地理编码是将街道地址或其他位置描述转换为（纬度，经度）坐标的过程。 反向地理编码是将（纬度，经度）坐标转换为（部分）地址的过程。 反向地理编码位置描述中的详细信息数量可能会有所不同，例如，其中可能包含最近建筑物的完整街道地址，而另一个可能只包含城市名称和邮政编码。 Geocoder类需要一个未包含在核心android框架中的后端服务。 如果平台中没有后端服务，Geocoder查询方法将返回一个空列表。 使用isPresent（）方法来确定Geocoder实现是否存在。

Summary

Public constructors
Geocoder(Context context, Locale locale)

构造一个Geocoder，其响应将针对给定的Locale进行本地化。
Geocoder(Context context)

构造一个Geocoder，其响应将针对默认系统Locale进行本地化。

Public methods
List<Address> getFromLocation(double latitude, double longitude, int maxResults)

返回一组已知地址，用于描述紧邻给定经度和纬度的区域。
List<Address> getFromLocationName(String locationName, int maxResults, double lowerLeftLatitude, double lowerLeftLongitude, double upperRightLatitude, double upperRightLongitude)

返回已知描述指定位置的地址数组，该地址可能是诸如“Dalvik，Iceland”之类的地名，诸如“1600 Amphitheatre Parkway，Mountain View，CA”之类的地址，诸如“SFO “等。
List<Address> getFromLocationName(String locationName, int maxResults)

返回已知描述指定位置的地址数组，该地址可能是诸如“Dalvik，Iceland”之类的地名，诸如“1600 Amphitheatre Parkway，Mountain View，CA”之类的地址，诸如“SFO “等。
static boolean isPresent()

如果实现Geocoder方法getFromLocation和getFromLocationName，则返回true。

Inherited methods
From class java.lang.Object

Public constructors

Geocoder

Added in API level 1 
Geocoder (Context context, 
                Locale locale)

构造一个Geocoder，其响应将针对给定的Locale进行本地化。

Parameters
context Context: the Context of the calling Activity
locale Locale: the desired Locale for the query results
Throws
NullPointerException if Locale is null

Geocoder

Added in API level 1 
Geocoder (Context context)

构造一个Geocoder，其响应将针对默认系统Locale进行本地化。

Parameters
context Context: the Context of the calling Activity

Public methods

getFromLocation

Added in API level 1 
List<Address> getFromLocation (double latitude, 
                double longitude, 
                int maxResults)

返回一组已知地址，用于描述紧邻给定经度和纬度的区域。 返回的地址将根据提供给此类构造函数的语言环境进行本地化。

返回值可以通过网络查找获得。 结果是最好的猜测，并不保证是有意义的或正确的。 从与主UI线程分离的线程中调用此方法可能很有用。

Parameters
latitude double: the latitude a point for the search
longitude double: the longitude a point for the search
maxResults int: max number of addresses to return. Smaller numbers (1 to 5) are recommended
Returns
List<Address> 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

Added in API level 1 
List<Address> getFromLocationName (String locationName, 
                int maxResults, 
                double lowerLeftLatitude, 
                double lowerLeftLongitude, 
                double upperRightLatitude, 
                double upperRightLongitude)

返回已知描述指定位置的地址数组，该地址可能是诸如“Dalvik，Iceland”之类的地名，诸如“1600 Amphitheatre Parkway，Mountain View，CA”之类的地址，诸如“SFO “等等。返回的地址将根据提供给该类的构造函数的语言环境进行本地化。

您可以通过包含框的左下点和右上点的纬度和经度来为搜索结果指定边界框。

查询将阻止并返回值将通过网络查找获得。 结果是最好的猜测，并不保证是有意义的或正确的。 从与主UI线程分离的线程中调用此方法可能很有用。

Parameters
locationName String: a user-supplied description of a location
maxResults int: max number of addresses to return. Smaller numbers (1 to 5) are recommended
lowerLeftLatitude double: the latitude of the lower left corner of the bounding box
lowerLeftLongitude double: the longitude of the lower left corner of the bounding box
upperRightLatitude double: the latitude of the upper right corner of the bounding box
upperRightLongitude double: the longitude of the upper right corner of the bounding box
Returns
List<Address> 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

getFromLocationName

Added in API level 1 
List<Address> getFromLocationName (String locationName, 
                int maxResults)

返回已知描述指定位置的地址数组，该地址可能是诸如“Dalvik，Iceland”之类的地名，诸如“1600 Amphitheatre Parkway，Mountain View，CA”之类的地址，诸如“SFO “等等。返回的地址将根据提供给该类的构造函数的语言环境进行本地化。

查询将阻止并返回值将通过网络查找获得。 结果是最好的猜测，并不保证是有意义的或正确的。 从与主UI线程分离的线程中调用此方法可能很有用。

Parameters
locationName String: a user-supplied description of a location
maxResults int: max number of results to return. Smaller numbers (1 to 5) are recommended
Returns
List<Address> 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

isPresent

Added in API level 9 
boolean isPresent ()

如果实现Geocoder方法getFromLocation和getFromLocationName，则返回true。 缺乏网络连接可能仍会导致这些方法返回空列表或空列表。

Returns
boolean
Android开发手册

Hooray!