Most visited

Recently visited

Added in API level 1

Address

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

Summary

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

Fields

CREATOR

Added in API level 1
Creator<Address> CREATOR

Public constructors

Address

Added in API level 1
Address (Locale locale)

构造一个新的Address对象,将其设置为给定的Locale,并将所有其他字段初始化为null或false。

Parameters
locale Locale

Public methods

clearLatitude

Added in API level 1
void clearLatitude ()

删除与此地址相关的任何纬度。

clearLongitude

Added in API level 1
void clearLongitude ()

删除与此地址相关的任何经度。

describeContents

Added in API level 1
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.

getAddressLine

Added in API level 1
String getAddressLine (int index)

返回由给定索引编号的地址的一行(从0开始);如果不存在这样的行,则返回null。

Parameters
index int
Returns
String
Throws
IllegalArgumentException if index < 0

getAdminArea

Added in API level 1
String getAdminArea ()

返回地址的管理区域名称,例如“CA”;如果未知,则返回null

Returns
String

getCountryCode

Added in API level 1
String getCountryCode ()

返回地址的国家代码,例如“US”;如果未知,则返回null。

Returns
String

getCountryName

Added in API level 1
String getCountryName ()

返回地址的本地国家名称,例如“Iceland”;如果未知,则返回null。

Returns
String

getExtras

Added in API level 1
Bundle getExtras ()

以Bundle的形式返回有关该地址的其他特定于提供者的信息。 密钥和值由提供者决定。 如果没有可用的附加信息,则返回null。

Returns
Bundle

getFeatureName

Added in API level 1
String getFeatureName ()

返回地址的功能名称,例如“Golden Gate Bridge”,如果未知,则返回null

Returns
String

getLatitude

Added in API level 1
double getLatitude ()

如果已知,则返回地址的纬度。

Returns
double
Throws
IllegalStateException if this Address has not been assigned a latitude.

getLocale

Added in API level 1
Locale getLocale ()

返回与此地址关联的区域设置。

Returns
Locale

getLocality

Added in API level 1
String getLocality ()

返回地址的位置,例如“Mountain View”,如果未知,则返回null。

Returns
String

getLongitude

Added in API level 1
double getLongitude ()

如果已知地址,则返回地址的经度。

Returns
double
Throws
IllegalStateException if this Address has not been assigned a longitude.

getMaxAddressLineIndex

Added in API level 1
int getMaxAddressLineIndex ()

返回当前用于指定地址行的最大索引。 如果没有指定地址行,则返回-1。

Returns
int

getPhone

Added in API level 1
String getPhone ()

返回地址的电话号码(如果已知);如果未知,则返回null。

Returns
String
Throws
IllegalStateException if this Address has not been assigned a latitude.

getPostalCode

Added in API level 1
String getPostalCode ()

返回地址的邮政编码,例如“94110”;如果未知,则返回null。

Returns
String

getPremises

Added in API level 4
String getPremises ()

返回地址的前提,如果未知,则返回null。

Returns
String

getSubAdminArea

Added in API level 1
String getSubAdminArea ()

返回地址的子管理区域名称,例如“Santa Clara County”,如果未知,则返回null

Returns
String

getSubLocality

Added in API level 4
String getSubLocality ()

返回地址的子地址,如果未知,则返回null。 例如,这可能对应于该地区的邻居。

Returns
String

getSubThoroughfare

Added in API level 4
String getSubThoroughfare ()

返回地址的子通道名称,该名称可能为空。 这可能对应于地址的街道号码。

Returns
String

getThoroughfare

Added in API level 1
String getThoroughfare ()

返回地址的通道名称,例如,“1600 Ampitheater Parkway”,可能为空

Returns
String

getUrl

Added in API level 1
String getUrl ()

返回地址的公共URL(如果已知);如果未知,则返回null。

Returns
String

hasLatitude

Added in API level 1
boolean hasLatitude ()

如果纬度已分配给此地址,则返回true,否则返回false。

Returns
boolean

hasLongitude

Added in API level 1
boolean hasLongitude ()

如果已将经度分配给此地址,则返回true,否则返回false。

Returns
boolean

setAddressLine

Added in API level 1
void setAddressLine (int index, 
                String line)

将通过索引编号的地址的行(从0开始)设置为给定的String,该String可以为null。

Parameters
index int
line String
Throws
IllegalArgumentException if index < 0

setAdminArea

Added in API level 1
void setAdminArea (String adminArea)

将地址的管理区域名称设置为给定的String,该String可以为null

Parameters
adminArea String

setCountryCode

Added in API level 1
void setCountryCode (String countryCode)

将地址的国家代码设置为给定的String,该String可以为null。

Parameters
countryCode String

setCountryName

Added in API level 1
void setCountryName (String countryName)

将地址的国家名称设置为给定的String,该String可以为null。

Parameters
countryName String

setExtras

Added in API level 1
void setExtras (Bundle extras)

将与此修复相关的额外信息设置为给定的Bundle。

Parameters
extras Bundle

setFeatureName

Added in API level 1
void setFeatureName (String featureName)

将地址的功能名称设置为给定的String,该String可以为null

Parameters
featureName String

setLatitude

Added in API level 1
void setLatitude (double latitude)

设置与此地址关联的纬度。

Parameters
latitude double

setLocality

Added in API level 1
void setLocality (String locality)

将地址的位置设置为给定的String,该String可以为null。

Parameters
locality String

setLongitude

Added in API level 1
void setLongitude (double longitude)

设置与此地址相关的经度。

Parameters
longitude double

setPhone

Added in API level 1
void setPhone (String phone)

设置与此地址关联的电话号码。

Parameters
phone String

setPostalCode

Added in API level 1
void setPostalCode (String postalCode)

将地址的邮政编码设置为给定的String,该String可以为null。

Parameters
postalCode String

setPremises

Added in API level 4
void setPremises (String premises)

将地址的前提设置为给定的String,该String可以为null。

Parameters
premises String

setSubAdminArea

Added in API level 1
void setSubAdminArea (String subAdminArea)

将地址的子管理区域名称设置为给定的String,该String可以为null

Parameters
subAdminArea String

setSubLocality

Added in API level 4
void setSubLocality (String sublocality)

将地址的子位置设置为给定的String,该String可以为null。

Parameters
sublocality String

setSubThoroughfare

Added in API level 4
void setSubThoroughfare (String subthoroughfare)

设置地址的子通道名称,可能为空。

Parameters
subthoroughfare String

setThoroughfare

Added in API level 1
void setThoroughfare (String thoroughfare)

设置地址的通途名称,可能为空。

Parameters
thoroughfare String

setUrl

Added in API level 1
void setUrl (String Url)

设置与此地址关联的公用URL。

Parameters
Url String

toString

Added in API level 1
String toString ()

返回对象的字符串表示形式。 通常, toString方法将返回一个字符串,以“文本表示”该对象。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

Added in API level 1
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.

Hooray!