public class Address
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.location.Address |
表示地址的类,即描述位置的一组字符串。 地址格式是xAL(eXtensible Address Language)的简化版本http://www.oasis-open.org/committees/ciq/ciq.html#6
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<Address> |
CREATOR |
Public constructors |
|
---|---|
Address(Locale locale) 构造一个新的Address对象,将其设置为给定的Locale,并将所有其他字段初始化为null或false。 |
Public methods |
|
---|---|
void |
clearLatitude() 删除与此地址相关的任何纬度。 |
void |
clearLongitude() 删除与此地址相关的任何经度。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
String |
getAddressLine(int index) 返回由给定索引编号的地址的一行(从0开始);如果不存在这样的行,则返回null。 |
String |
getAdminArea() 返回地址的管理区域名称,例如“CA”;如果未知,则返回null |
String |
getCountryCode() 返回地址的国家代码,例如“US”;如果未知,则返回null。 |
String |
getCountryName() 返回地址的本地国家名称,例如“Iceland”;如果未知,则返回null。 |
Bundle |
getExtras() 以Bundle的形式返回有关该地址的其他特定于提供者的信息。 |
String |
getFeatureName() 返回地址的功能名称,例如“Golden Gate Bridge”,如果未知,则返回null |
double |
getLatitude() 如果已知,则返回地址的纬度。 |
Locale |
getLocale() 返回与此地址关联的区域设置。 |
String |
getLocality() 返回地址的位置,例如“Mountain View”,如果未知,则返回null。 |
double |
getLongitude() 如果已知地址,则返回地址的经度。 |
int |
getMaxAddressLineIndex() 返回当前用于指定地址行的最大索引。 |
String |
getPhone() 返回地址的电话号码(如果已知);如果未知,则返回null。 |
String |
getPostalCode() 返回地址的邮政编码,例如“94110”;如果未知,则返回null。 |
String |
getPremises() 返回地址的前提,如果未知,则返回null。 |
String |
getSubAdminArea() 返回地址的子管理区域名称,例如“Santa Clara County”,如果未知,则返回null |
String |
getSubLocality() 返回地址的子地址,如果未知,则返回null。 |
String |
getSubThoroughfare() 返回地址的子通道名称,该名称可能为空。 |
String |
getThoroughfare() 返回地址的通道名称,例如,“1600 Ampitheater Parkway”,可能为空 |
String |
getUrl() 返回地址的公共URL(如果已知);如果未知,则返回null。 |
boolean |
hasLatitude() 如果纬度已分配给此地址,则返回true,否则返回false。 |
boolean |
hasLongitude() 如果已将经度分配给此地址,则返回true,否则返回false。 |
void |
setAddressLine(int index, String line) 将通过索引编号的地址的行(从0开始)设置为给定的String,该String可以为null。 |
void |
setAdminArea(String adminArea) 将地址的管理区域名称设置为给定的String,该String可以为null |
void |
setCountryCode(String countryCode) 将地址的国家代码设置为给定的String,该String可以为null。 |
void |
setCountryName(String countryName) 将地址的国家名称设置为给定的String,该String可以为null。 |
void |
setExtras(Bundle extras) 将与此修复相关的额外信息设置为给定的Bundle。 |
void |
setFeatureName(String featureName) 将地址的功能名称设置为给定的String,该String可以为null |
void |
setLatitude(double latitude) 设置与此地址关联的纬度。 |
void |
setLocality(String locality) 将地址的位置设置为给定的String,该String可以为null。 |
void |
setLongitude(double longitude) 设置与此地址相关的经度。 |
void |
setPhone(String phone) 设置与此地址关联的电话号码。 |
void |
setPostalCode(String postalCode) 将地址的邮政编码设置为给定的String,该String可以为null。 |
void |
setPremises(String premises) 将地址的前提设置为给定的String,该String可以为null。 |
void |
setSubAdminArea(String subAdminArea) 将地址的子管理区域名称设置为给定的String,该String可以为null |
void |
setSubLocality(String sublocality) 将地址的子位置设置为给定的String,该String可以为null。 |
void |
setSubThoroughfare(String subthoroughfare) 设置地址的子通道名称,可能为空。 |
void |
setThoroughfare(String thoroughfare) 设置地址的通途名称,可能为空。 |
void |
setUrl(String Url) 设置与此地址关联的公用URL。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel parcel, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
Address (Locale locale)
构造一个新的Address对象,将其设置为给定的Locale,并将所有其他字段初始化为null或false。
Parameters | |
---|---|
locale |
Locale
|
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
String getAddressLine (int index)
返回由给定索引编号的地址的一行(从0开始);如果不存在这样的行,则返回null。
Parameters | |
---|---|
index |
int
|
Returns | |
---|---|
String |
Throws | |
---|---|
IllegalArgumentException |
if index < 0 |
String getAdminArea ()
返回地址的管理区域名称,例如“CA”;如果未知,则返回null
Returns | |
---|---|
String |
String getCountryCode ()
返回地址的国家代码,例如“US”;如果未知,则返回null。
Returns | |
---|---|
String |
String getCountryName ()
返回地址的本地国家名称,例如“Iceland”;如果未知,则返回null。
Returns | |
---|---|
String |
Bundle getExtras ()
以Bundle的形式返回有关该地址的其他特定于提供者的信息。 密钥和值由提供者决定。 如果没有可用的附加信息,则返回null。
Returns | |
---|---|
Bundle |
String getFeatureName ()
返回地址的功能名称,例如“Golden Gate Bridge”,如果未知,则返回null
Returns | |
---|---|
String |
double getLatitude ()
如果已知,则返回地址的纬度。
Returns | |
---|---|
double |
Throws | |
---|---|
IllegalStateException |
if this Address has not been assigned a latitude. |
String getLocality ()
返回地址的位置,例如“Mountain View”,如果未知,则返回null。
Returns | |
---|---|
String |
double getLongitude ()
如果已知地址,则返回地址的经度。
Returns | |
---|---|
double |
Throws | |
---|---|
IllegalStateException |
if this Address has not been assigned a longitude. |
int getMaxAddressLineIndex ()
返回当前用于指定地址行的最大索引。 如果没有指定地址行,则返回-1。
Returns | |
---|---|
int |
String getPhone ()
返回地址的电话号码(如果已知);如果未知,则返回null。
Returns | |
---|---|
String |
Throws | |
---|---|
IllegalStateException |
if this Address has not been assigned a latitude. |
String getPostalCode ()
返回地址的邮政编码,例如“94110”;如果未知,则返回null。
Returns | |
---|---|
String |
String getSubAdminArea ()
返回地址的子管理区域名称,例如“Santa Clara County”,如果未知,则返回null
Returns | |
---|---|
String |
String getSubLocality ()
返回地址的子地址,如果未知,则返回null。 例如,这可能对应于该地区的邻居。
Returns | |
---|---|
String |
String getSubThoroughfare ()
返回地址的子通道名称,该名称可能为空。 这可能对应于地址的街道号码。
Returns | |
---|---|
String |
String getThoroughfare ()
返回地址的通道名称,例如,“1600 Ampitheater Parkway”,可能为空
Returns | |
---|---|
String |
boolean hasLatitude ()
如果纬度已分配给此地址,则返回true,否则返回false。
Returns | |
---|---|
boolean |
boolean hasLongitude ()
如果已将经度分配给此地址,则返回true,否则返回false。
Returns | |
---|---|
boolean |
void setAddressLine (int index, String line)
将通过索引编号的地址的行(从0开始)设置为给定的String,该String可以为null。
Parameters | |
---|---|
index |
int
|
line |
String
|
Throws | |
---|---|
IllegalArgumentException |
if index < 0 |
void setAdminArea (String adminArea)
将地址的管理区域名称设置为给定的String,该String可以为null
Parameters | |
---|---|
adminArea |
String
|
void setCountryCode (String countryCode)
将地址的国家代码设置为给定的String,该String可以为null。
Parameters | |
---|---|
countryCode |
String
|
void setCountryName (String countryName)
将地址的国家名称设置为给定的String,该String可以为null。
Parameters | |
---|---|
countryName |
String
|
void setExtras (Bundle extras)
将与此修复相关的额外信息设置为给定的Bundle。
Parameters | |
---|---|
extras |
Bundle
|
void setFeatureName (String featureName)
将地址的功能名称设置为给定的String,该String可以为null
Parameters | |
---|---|
featureName |
String
|
void setLatitude (double latitude)
设置与此地址关联的纬度。
Parameters | |
---|---|
latitude |
double
|
void setLocality (String locality)
将地址的位置设置为给定的String,该String可以为null。
Parameters | |
---|---|
locality |
String
|
void setLongitude (double longitude)
设置与此地址相关的经度。
Parameters | |
---|---|
longitude |
double
|
void setPostalCode (String postalCode)
将地址的邮政编码设置为给定的String,该String可以为null。
Parameters | |
---|---|
postalCode |
String
|
void setPremises (String premises)
将地址的前提设置为给定的String,该String可以为null。
Parameters | |
---|---|
premises |
String
|
void setSubAdminArea (String subAdminArea)
将地址的子管理区域名称设置为给定的String,该String可以为null
Parameters | |
---|---|
subAdminArea |
String
|
void setSubLocality (String sublocality)
将地址的子位置设置为给定的String,该String可以为null。
Parameters | |
---|---|
sublocality |
String
|
void setSubThoroughfare (String subthoroughfare)
设置地址的子通道名称,可能为空。
Parameters | |
---|---|
subthoroughfare |
String
|
void setThoroughfare (String thoroughfare)
设置地址的通途名称,可能为空。
Parameters | |
---|---|
thoroughfare |
String
|
String toString ()
返回对象的字符串表示形式。 通常, toString
方法将返回一个字符串,以“文本表示”该对象。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel parcel, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
parcel |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |