public class AMapLocation
extends Location
implements java.lang.Cloneable
| 限定符和类型 | 字段和说明 |
|---|---|
protected java.lang.String |
buildingId
建筑物的POIID,只有室内定位的时候才会返回,主要用于室内地图的显示
|
static java.lang.String |
COORD_TYPE_GCJ02
GCJ02坐标系
|
static java.lang.String |
COORD_TYPE_WGS84
WGS84坐标系
|
static <any> |
CREATOR |
static int |
ERROR_CODE_AIRPLANEMODE_WIFIOFF
定位错误码:定位失败,飞行模式下关闭了WIFI开关,请关闭飞行模式或者打开WIFI开关
|
static int |
ERROR_CODE_FAILURE_AUTH
定位错误码:KEY错误,可以通过
getLocationDetail()获取详细信息来跟注册的KEY信息进行对照 |
static int |
ERROR_CODE_FAILURE_CELL
定位错误码:错误的基站信息,请检查是否安装SIM卡
|
static int |
ERROR_CODE_FAILURE_COARSE_LOCATION
定位错误码:定位失败,模糊权限下定位异常,可以通过
getErrorInfo() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_CONNECTION
定位错误码:网络连接异常,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_FAILURE_INIT
定位错误码:初始化异常,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_FAILURE_LOCATION
定位错误码:定位结果错误,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_FAILURE_LOCATION_PARAMETER
定位错误码:获取到的请求参数为空,可能获取过程中出现异常,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_FAILURE_LOCATION_PERMISSION
定位错误码:缺少定位权限,请检查是否配置定位权限,并在安全软件和设置中给应用打开定位权限
|
static int |
ERROR_CODE_FAILURE_NOENOUGHSATELLITES
定位错误码:卫星定位失败,可用卫星数不足
|
static int |
ERROR_CODE_FAILURE_NOWIFIANDAP
定位错误码:网络定位失败,请检查设备是否插入sim卡、开启移动网络或开启了wifi模块
|
static int |
ERROR_CODE_FAILURE_PARSER
定位错误码:解析XML出错,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_FAILURE_SIMULATION_LOCATION
定位错误码:定位位置可能被模拟
|
static int |
ERROR_CODE_FAILURE_WIFI_INFO
定位错误码:定位失败,由于设备仅扫描到单个wifi,不能精准的计算出位置信息。
|
static int |
ERROR_CODE_INVALID_PARAMETER
定位错误码:一些重要参数为空,如context,可以通过
getLocationDetail()获取详细信息 |
static int |
ERROR_CODE_NO_COMPENSATION_CACHE
定位错误码:首次加速定位失败
|
static int |
ERROR_CODE_NOCGI_WIFIOFF
定位错误码:定位失败,没有检查到SIM卡,并且关闭了WIFI开关,请打开WIFI开关或者插入SIM卡
|
static int |
ERROR_CODE_SERVICE_FAIL
定位错误码:定位服务启动失败,请检查是否配置service并且manifest中service标签是否配置在application标签内
|
static int |
ERROR_CODE_UNKNOWN
定位错误码:其他错误,可以通过
getLocationDetail()获取详细信息 |
protected java.lang.String |
floor
楼层信息,只有室内定位的时候才会返回
|
static int |
GPS_ACCURACY_BAD
卫星信号弱
|
static int |
GPS_ACCURACY_GOOD
卫星信号强
|
static int |
GPS_ACCURACY_UNKNOWN
卫星状态未知
|
static java.lang.String |
LBS_REAL_LOCATION_TYPE
缓存定位类型的真实定位结果,从extras bundle中获取
|
static int |
LOCATION_COMPENSATION |
static int |
LOCATION_SUCCESS
定位错误码:定位成功
|
static int |
LOCATION_TYPE_AMAP
定位结果类型:补偿定位(极少返回)
|
static int |
LOCATION_TYPE_CELL
定位结果类型:基站定位结果
属于网络定位
|
static int |
LOCATION_TYPE_COARSE_LOCATION
模糊定位类型
|
static int |
LOCATION_TYPE_FAST
已过时。
|
static int |
LOCATION_TYPE_FIX_CACHE
定位结果类型:缓存定位结果
返回一段时间前设备在相同的环境中缓存下来的网络定位结果,节省无必要的设备定位消耗
|
static int |
LOCATION_TYPE_GPS
定位结果类型:卫星定位结果
通过设备卫星定位模块返回的定位结果
|
static int |
LOCATION_TYPE_LAST_LOCATION_CACHE
定位结果类型: 最后位置缓存
|
static int |
LOCATION_TYPE_NETWORK
系统网络定位类型
|
static int |
LOCATION_TYPE_OFFLINE
定位结果类型: 离线定位结果
|
static int |
LOCATION_TYPE_SAME_REQ
定位结果类型:前次定位结果
网络定位请求低于1秒、或两次定位之间设备位置变化非常小时返回,设备位移通过传感器感知
|
static int |
LOCATION_TYPE_WIFI
定位结果类型:Wifi定位结果
属于网络定位,定位精度相对基站定位会更好
|
static int |
TRUSTED_LEVEL_BAD
定位结果的可信度-非常不可信
周边信息的新鲜度超过10分钟
模拟定位结果
|
static int |
TRUSTED_LEVEL_HIGH
定位结果的可信度-非常可信
周边信息的新鲜度在15s之内
实时GPS定位结果
|
static int |
TRUSTED_LEVEL_LOW
定位结果的可信度-可信度较低
周边信息的新鲜度在2-10分钟之间
|
static int |
TRUSTED_LEVEL_NORMAL
定位结果的可信度-可信度一般
周边信息的新鲜度在15秒-2分钟之间
缓存、离线定位、最后位置
|
| 构造器和说明 |
|---|
AMapLocation(Location location)
根据android.location.Location对象构造
|
AMapLocation(java.lang.String provider)
根据定位提供者构造
|
| 限定符和类型 | 方法和说明 |
|---|---|
AMapLocation |
clone() |
int |
describeContents() |
float |
getAccuracy()
获取定位精度
单位:米
|
java.lang.String |
getAdCode()
|
java.lang.String |
getAddress()
获取地址
2.9.0之前的版本定位类型为
LOCATION_TYPE_GPS时不会返回地址信息自2.9.0版本开始,当类型为 LOCATION_TYPE_GPS时也可以返回地址信息(需要网络通畅,第一次有可能没有地址信息返回)
|
double |
getAltitude()
获取海拔高度(单位:米)
默认值:0.0
3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回海拔高度,当设置为true时会通过手机传感器获取海拔高度,如果手机没有对应的传感器会返回0.0
|
java.lang.String |
getAoiName()
|
float |
getBearing()
获取方向角(单位:度)
默认值:0.0
取值范围:【0,360】,其中0度表示正北方向,90度表示正东,180度表示正南,270度表示正西 3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回方向角,当设置为true时会通过手机传感器获取方向角,如果手机没有对应的传感器会返回0.0
注意:定位类型为 LOCATION_TYPE_GPS时,方向角指的是运动方向定位类型不是 LOCATION_TYPE_GPS时,方向角指的是手机朝向 |
java.lang.String |
getBuildingId()
返回支持室内定位的建筑物ID信息
|
java.lang.String |
getCity()
|
java.lang.String |
getCityCode()
|
int |
getConScenario()
室内外置信度
室内:且置信度取值在[1 ~ 100],值越大在室内的可能性越大
室外:且置信度取值在[-100 ~ -1] ,值越小在室外的可能性越大
无法识别室内外:置信度返回值为 0
|
java.lang.String |
getCoordType()
获取坐标系类型
高德定位sdk会返回两种坐标系
COORD_TYPE_GCJ02 -- GCJ02坐标系
COORD_TYPE_WGS84 -- WGS84坐标系,国外定位时返回的是WGS84坐标系
|
java.lang.String |
getCountry()
获取国家名称
|
java.lang.String |
getDescription()
获取位置语义信息
|
java.lang.String |
getDistrict()
|
int |
getErrorCode()
获取错误码
|
java.lang.String |
getErrorInfo()
获取错误信息
|
Bundle |
getExtras() |
java.lang.String |
getFloor()
获取室内定位的楼层信息
|
int |
getGpsAccuracyStatus()
获取卫星信号强度,仅在卫星定位时有效,值为
#GPS_ACCURACY_BAD,#GPS_ACCURACY_GOOD,#GPS_ACCURACY_UNKNOWN |
double |
getLatitude()
获取纬度
|
java.lang.String |
getLocationDetail()
获取定位信息描述
|
AMapLocationQualityReport |
getLocationQualityReport()
获取定位质量
|
int |
getLocationType()
获取定位结果来源
|
double |
getLongitude()
获取经度
|
java.lang.String |
getPoiName()
|
java.lang.String |
getProvider()
获取定位提供者
|
java.lang.String |
getProvince()
|
java.lang.String |
getRoad()
已过时。
使用
getStreet()方法代替 |
int |
getSatellites()
获取当前可用卫星数量, 仅在卫星定位时有效,
|
float |
getSpeed()
获取当前速度(单位:米/秒)
默认值:0.0
3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回速度值,当设置为true时会通过手机传感器获取速度,如果手机没有对应的传感器会返回0.0
|
java.lang.String |
getStreet()
|
java.lang.String |
getStreetNum()
|
int |
getTrustedLevel()
获取定位结果的可信度
只有在定位成功时才有意义
非常可信
TRUSTED_LEVEL_HIGH
可信度一般TRUSTED_LEVEL_NORMAL
可信度较低 TRUSTED_LEVEL_LOW
非常不可信 TRUSTED_LEVEL_BAD
|
boolean |
isFixLastLocation()
是否命中最后位置缓存
|
boolean |
isMock()
是否为模拟定位
|
boolean |
isOffset()
获取是否偏转
|
void |
setAdCode(java.lang.String adCode)
设置区域编码
|
void |
setAddress(java.lang.String address)
设置地址信息
|
void |
setAltitude(double altitude)
设置海拔高度
|
void |
setAoiName(java.lang.String aoiName)
设置aoiName
|
void |
setBearing(float bearing)
设置方向角
|
void |
setBuildingId(java.lang.String buildingId)
建筑物的POIID,只有室内定位的时候才会返回
|
void |
setCity(java.lang.String city)
设置城市名称
|
void |
setCityCode(java.lang.String cityCode)
设置城市编码
|
void |
setConScenario(int conScenario)
室内外置信度
室内:且置信度取值在[1 ~ 100],值越大在室内的可能性越大
室外:且置信度取值在[-100 ~ -1] ,值越小在室外的可能性越大
无法识别室内外:置信度返回值为 0
|
void |
setCoordType(java.lang.String coordType)
设置坐标系类型
|
void |
setCountry(java.lang.String country)
获取国家名称
|
void |
setDescription(java.lang.String description)
设置位置语义信息
|
void |
setDistrict(java.lang.String district)
设置区的名称
|
void |
setErrorCode(int errorCode)
设置错误码
|
void |
setErrorInfo(java.lang.String errorInfo)
设置错误信息
|
void |
setExtras(Bundle extras)
设置扩展参数
|
void |
setFixLastLocation(boolean isFixLastLocation)
设置是否命中最后位置缓存
|
void |
setFloor(java.lang.String floor)
设置楼层信息,只有室内定位的时候才会返回
|
void |
setGpsAccuracyStatus(int signalIntensity)
设置卫星信号强度,仅在卫星定位时有效
|
void |
setLatitude(double latitude)
设置纬度
|
void |
setLocationDetail(java.lang.String detailErrorInfo)
设置定位信息描述
|
void |
setLocationQualityReport(AMapLocationQualityReport qualityReport)
设置定位质量
|
void |
setLocationType(int locationType)
设置定位结果来源
|
void |
setLongitude(double longitude)
设置经度
|
void |
setMock(boolean mock)
设置是否为模拟定位
|
void |
setNumber(java.lang.String number)
设置门牌号
|
void |
setOffset(boolean offset)
设置是否偏转
|
void |
setPoiName(java.lang.String poiName)
设置兴趣点名称
|
void |
setProvider(java.lang.String provider)
设置位置提供者
|
void |
setProvince(java.lang.String province)
设置省的名称
|
void |
setRoad(java.lang.String road)
已过时。
|
void |
setSatellites(int satellites)
设置卫星数量
|
void |
setSpeed(float speed)
设置当前速度
|
void |
setStreet(java.lang.String street)
设置街道名称
|
void |
setTrustedLevel(int trustedLevel)
设置定位结果可信度
|
JSONObject |
toJson(int iT)
将记录转化为字符串
|
java.lang.String |
toStr()
将定位结果转换成字符串
|
java.lang.String |
toStr(int iT)
将定位结果转化为字符串
|
java.lang.String |
toString() |
void |
writeToParcel(Parcel parcel,
int flags) |
public static final int LOCATION_SUCCESS
public static final int ERROR_CODE_INVALID_PARAMETER
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_WIFI_INFO
public static final int ERROR_CODE_FAILURE_LOCATION_PARAMETER
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_CONNECTION
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_PARSER
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_LOCATION
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_AUTH
getLocationDetail()获取详细信息来跟注册的KEY信息进行对照public static final int ERROR_CODE_UNKNOWN
getLocationDetail()获取详细信息public static final int ERROR_CODE_FAILURE_INIT
getLocationDetail()获取详细信息public static final int ERROR_CODE_SERVICE_FAIL
public static final int ERROR_CODE_FAILURE_CELL
public static final int ERROR_CODE_FAILURE_LOCATION_PERMISSION
public static final int ERROR_CODE_FAILURE_NOWIFIANDAP
public static final int ERROR_CODE_FAILURE_NOENOUGHSATELLITES
public static final int ERROR_CODE_FAILURE_SIMULATION_LOCATION
public static final int ERROR_CODE_AIRPLANEMODE_WIFIOFF
public static final int ERROR_CODE_NOCGI_WIFIOFF
public static final int ERROR_CODE_FAILURE_COARSE_LOCATION
getErrorInfo() 获取详细信息public static final int ERROR_CODE_NO_COMPENSATION_CACHE
public static final int LOCATION_TYPE_GPS
通过设备卫星定位模块返回的定位结果
public static final int LOCATION_TYPE_SAME_REQ
网络定位请求低于1秒、或两次定位之间设备位置变化非常小时返回,设备位移通过传感器感知
public static final int LOCATION_TYPE_FAST
LOCATION_TYPE_SAME_REQpublic static final int LOCATION_TYPE_FIX_CACHE
返回一段时间前设备在相同的环境中缓存下来的网络定位结果,节省无必要的设备定位消耗
public static final int LOCATION_TYPE_WIFI
属于网络定位,定位精度相对基站定位会更好
public static final int LOCATION_TYPE_CELL
属于网络定位
public static final int LOCATION_TYPE_AMAP
public static final int LOCATION_TYPE_OFFLINE
public static final int LOCATION_TYPE_LAST_LOCATION_CACHE
public static final int LOCATION_COMPENSATION
public static final int LOCATION_TYPE_COARSE_LOCATION
public static final int LOCATION_TYPE_NETWORK
public static final java.lang.String COORD_TYPE_WGS84
public static final java.lang.String COORD_TYPE_GCJ02
public static final int GPS_ACCURACY_GOOD
public static final int GPS_ACCURACY_BAD
public static final int GPS_ACCURACY_UNKNOWN
public static final java.lang.String LBS_REAL_LOCATION_TYPE
protected java.lang.String buildingId
protected java.lang.String floor
public static final <any> CREATOR
public static final int TRUSTED_LEVEL_HIGH
public static final int TRUSTED_LEVEL_NORMAL
public static final int TRUSTED_LEVEL_LOW
public static final int TRUSTED_LEVEL_BAD
public AMapLocation(java.lang.String provider)
provider - 定位提供者名称public AMapLocation(Location location)
location - android。location.Location对象public int getGpsAccuracyStatus()
#GPS_ACCURACY_BAD,#GPS_ACCURACY_GOOD,#GPS_ACCURACY_UNKNOWNpublic void setGpsAccuracyStatus(int signalIntensity)
public int getLocationType()
public void setLocationType(int locationType)
locationType - 定位结果来源public java.lang.String getLocationDetail()
public void setLocationDetail(java.lang.String detailErrorInfo)
detailErrorInfo - 定位信息描述public int getErrorCode()
public void setErrorCode(int errorCode)
errorCode - 错误码public java.lang.String getErrorInfo()
public void setErrorInfo(java.lang.String errorInfo)
errorInfo - 错误信息public java.lang.String getCountry()
public void setCountry(java.lang.String country)
country - public java.lang.String getRoad()
getStreet()方法代替public void setRoad(java.lang.String road)
road - 街道或者道路名称public java.lang.String getAddress()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回地址信息
自2.9.0版本开始,当类型为LOCATION_TYPE_GPS时也可以返回地址信息(需要网络通畅,第一次有可能没有地址信息返回)
public void setAddress(java.lang.String address)
address - 地址信息public java.lang.String getProvince()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回省份名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回省份名称
public void setProvince(java.lang.String province)
province - 省的名称public java.lang.String getCity()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回城市名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回省城市名称
public void setCity(java.lang.String city)
city - 城市名称public java.lang.String getDistrict()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回区的名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回区的名称
public void setDistrict(java.lang.String district)
district - 区的名称public java.lang.String getCityCode()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回城市编码
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回城市编码
public void setCityCode(java.lang.String cityCode)
cityCode - 城市编码public java.lang.String getAdCode()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回区域编码
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回区域编码
public void setAdCode(java.lang.String adCode)
adCode - 区域编码public java.lang.String getPoiName()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回兴趣点名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回兴趣点名称
public void setPoiName(java.lang.String poiName)
poiName - public double getLatitude()
public void setLatitude(double latitude)
public double getLongitude()
public void setLongitude(double longitude)
public int getSatellites()
public void setSatellites(int satellites)
satellites - public java.lang.String getStreet()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回街道名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回街道名称
public void setStreet(java.lang.String street)
street - 街道名称public java.lang.String getStreetNum()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回门牌号
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回门牌号
public void setNumber(java.lang.String number)
number - public void setOffset(boolean offset)
offset - public boolean isOffset()
public java.lang.String getAoiName()
2.9.0之前的版本定位类型为LOCATION_TYPE_GPS时不会返回兴趣面名称
自2.9.0版本开始,当LOCATION_TYPE_GPS时也可以返回兴趣面名称
public void setAoiName(java.lang.String aoiName)
aoiName - public java.lang.String getBuildingId()
public void setBuildingId(java.lang.String buildingId)
public java.lang.String getFloor()
public boolean isFixLastLocation()
public void setFixLastLocation(boolean isFixLastLocation)
public void setFloor(java.lang.String floor)
public boolean isMock()
public void setMock(boolean mock)
mock - 是否为模拟定位public java.lang.String getDescription()
public void setDescription(java.lang.String description)
description - public java.lang.String toString()
public java.lang.String toStr()
public java.lang.String toStr(int iT)
iT - 【1代表完整描述,2代表精简描述,3代表极简描述】public float getAccuracy()
单位:米
public void setBearing(float bearing)
bearing - public float getBearing()
默认值:0.0
取值范围:【0,360】,其中0度表示正北方向,90度表示正东,180度表示正南,270度表示正西
3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回方向角,当设置为true时会通过手机传感器获取方向角,如果手机没有对应的传感器会返回0.0
注意:
定位类型为LOCATION_TYPE_GPS时,方向角指的是运动方向
定位类型不是LOCATION_TYPE_GPS时,方向角指的是手机朝向
public void setAltitude(double altitude)
altitude - public double getAltitude()
默认值:0.0
3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回海拔高度,当设置为true时会通过手机传感器获取海拔高度,如果手机没有对应的传感器会返回0.0
public void setSpeed(float speed)
speed - public float getSpeed()
默认值:0.0
3.1.0之前的版本只有定位类型为 LOCATION_TYPE_GPS时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是LOCATION_TYPE_GPS时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回速度值,当设置为true时会通过手机传感器获取速度,如果手机没有对应的传感器会返回0.0
public void setProvider(java.lang.String provider)
provider - public java.lang.String getProvider()
lbs:高德网络定位
gps:卫星定位
public void setExtras(Bundle extras)
extras - public Bundle getExtras()
public JSONObject toJson(int iT)
iT - 【1代表完整描述,2代表精简描述,3代表极简描述】public int describeContents()
public void writeToParcel(Parcel parcel,
int flags)
public AMapLocation clone()
public AMapLocationQualityReport getLocationQualityReport()
public void setLocationQualityReport(AMapLocationQualityReport qualityReport)
qualityReport - public java.lang.String getCoordType()
public void setCoordType(java.lang.String coordType)
coordType - 坐标系类型public void setTrustedLevel(int trustedLevel)
trustedLevel - 可信度public int getTrustedLevel()
TRUSTED_LEVEL_HIGHTRUSTED_LEVEL_NORMALTRUSTED_LEVEL_LOWTRUSTED_LEVEL_BADpublic int getConScenario()
public void setConScenario(int conScenario)
conScenario - 室内外置信度