public class AMapLocation
extends Location
implements java.lang.Cloneable
限定符和类型 | 字段和说明 |
---|---|
static java.lang.String |
COORD_TYPE_GCJ02
GCJ02坐标系
|
static java.lang.String |
COORD_TYPE_WGS84
WGS84坐标系
|
static int |
ERROR_CODE_AIRPLANEMODE_WIFIOFF
定位错误码:定位失败,飞行模式下关闭了WIFI开关,请关闭飞行模式或者打开WIFI开关
|
static int |
ERROR_CODE_FAILURE_AUTH
定位错误码:KEY错误,可以通过
AMapLocation.getLocationDetail() 获取详细信息来跟注册的KEY信息进行对照 |
static int |
ERROR_CODE_FAILURE_CELL
定位错误码:错误的基站信息,请检查是否安装SIM卡
|
static int |
ERROR_CODE_FAILURE_COARSE_LOCATION
定位错误码:定位失败,模糊权限下定位异常,可以通过
AMapLocation.getErrorInfo() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_CONNECTION
定位错误码:网络连接异常,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_INIT
定位错误码:初始化异常,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_LOCATION
定位错误码:定位结果错误,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_LOCATION_PARAMETER
定位错误码:获取到的请求参数为空,可能获取过程中出现异常,可以通过
AMapLocation.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出错,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
static int |
ERROR_CODE_FAILURE_SIMULATION_LOCATION
定位错误码:定位位置可能被模拟
|
static int |
ERROR_CODE_FAILURE_WIFI_INFO
定位错误码:定位失败,由于设备仅扫描到单个wifi,不能精准的计算出位置信息。
|
static int |
ERROR_CODE_INVALID_PARAMETER
定位错误码:一些重要参数为空,如context,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
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
定位错误码:其他错误,可以通过
AMapLocation.getLocationDetail() 获取详细信息 |
static int |
GPS_ACCURACY_BAD
卫星信号弱
|
static int |
GPS_ACCURACY_GOOD
卫星信号强
|
static int |
GPS_ACCURACY_UNKNOWN
卫星状态未知
|
static int |
LOCATION_COMPENSATION |
static int |
LOCATION_SUCCESS
定位错误码:定位成功
|
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_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)
根据定位提供者构造
|
限定符和类型 | 方法和说明 |
---|---|
float |
getAccuracy()
获取定位精度
单位:米
|
java.lang.String |
getAdCode()
获取区域编码
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回区域编码自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回区域编码
|
java.lang.String |
getAddress()
获取地址
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回地址信息自2.9.0版本开始,当类型为 AMapLocation.LOCATION_TYPE_GPS 时也可以返回地址信息(需要网络通畅,第一次有可能没有地址信息返回)
|
double |
getAltitude()
获取海拔高度(单位:米)
默认值:0.0
3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS 时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 AMapLocation.LOCATION_TYPE_GPS 时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回海拔高度,当设置为true时会通过手机传感器获取海拔高度,如果手机没有对应的传感器会返回0.0
|
java.lang.String |
getAoiName()
获取兴趣面名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回兴趣面名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回兴趣面名称
|
float |
getBearing()
获取方向角(单位:度)
默认值:0.0
取值范围:【0,360】,其中0度表示正北方向,90度表示正东,180度表示正南,270度表示正西 3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS 时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 AMapLocation.LOCATION_TYPE_GPS 时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回方向角,当设置为true时会通过手机传感器获取方向角,如果手机没有对应的传感器会返回0.0
注意:定位类型为 AMapLocation.LOCATION_TYPE_GPS 时,方向角指的是运动方向定位类型不是 AMapLocation.LOCATION_TYPE_GPS 时,方向角指的是手机朝向 |
java.lang.String |
getBuildingId()
返回支持室内定位的建筑物ID信息
|
java.lang.String |
getCity()
获取城市名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回城市名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回省城市名称
|
java.lang.String |
getCityCode()
获取城市编码
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回城市编码自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回城市编码
|
int |
getConScenario()
室内外置信度
室内:且置信度取值在[1 ~ 100],值越大在室内的可能性越大
室外:且置信度取值在[-100 ~ -1] ,值越小在室外的可能性越大
无法识别室内外:置信度返回值为 0
|
java.lang.String |
getCoordType()
获取坐标系类型
高德定位sdk会返回两种坐标系
AMapLocation.COORD_TYPE_GCJ02 -- GCJ02坐标系
AMapLocation.COORD_TYPE_WGS84 -- WGS84坐标系,国外定位时返回的是WGS84坐标系
|
java.lang.String |
getCountry()
获取国家名称
|
java.lang.String |
getDescription()
获取位置语义信息
|
java.lang.String |
getDistrict()
获取区的名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回区的名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回区的名称
|
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()
获取兴趣点名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回兴趣点名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回兴趣点名称
|
java.lang.String |
getProvider()
获取定位提供者
|
java.lang.String |
getProvince()
获取省的名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回省份名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回省份名称
|
java.lang.String |
getRoad()
已过时。
使用
AMapLocation.getStreet() 方法代替 |
int |
getSatellites()
获取当前可用卫星数量, 仅在卫星定位时有效,
|
float |
getSpeed()
获取当前速度(单位:米/秒)
默认值:0.0
3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS 时才有值自3.1.0版本开始,不限定定位类型,当定位类型不是 AMapLocation.LOCATION_TYPE_GPS 时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回速度值,当设置为true时会通过手机传感器获取速度,如果手机没有对应的传感器会返回0.0
|
java.lang.String |
getStreet()
获取街道名称
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回街道名称自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回街道名称
|
java.lang.String |
getStreetNum()
获取门牌号
2.9.0之前的版本定位类型为
AMapLocation.LOCATION_TYPE_GPS 时不会返回门牌号自2.9.0版本开始,当 AMapLocation.LOCATION_TYPE_GPS 时也可以返回门牌号
|
int |
getTrustedLevel()
获取定位结果的可信度
只有在定位成功时才有意义
非常可信
AMapLocation.TRUSTED_LEVEL_HIGH
可信度一般AMapLocation.TRUSTED_LEVEL_NORMAL
可信度较低 AMapLocation.TRUSTED_LEVEL_LOW
非常不可信 AMapLocation.TRUSTED_LEVEL_BAD
|
java.lang.String |
toStr()
将定位结果转换成字符串
|
java.lang.String |
toStr(int iT)
将定位结果转化为字符串
|
java.lang.String |
toString() |
public static final int LOCATION_SUCCESS
public static final int ERROR_CODE_INVALID_PARAMETER
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_WIFI_INFO
public static final int ERROR_CODE_FAILURE_LOCATION_PARAMETER
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_CONNECTION
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_PARSER
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_LOCATION
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_AUTH
AMapLocation.getLocationDetail()
获取详细信息来跟注册的KEY信息进行对照public static final int ERROR_CODE_UNKNOWN
AMapLocation.getLocationDetail()
获取详细信息public static final int ERROR_CODE_FAILURE_INIT
AMapLocation.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
AMapLocation.getErrorInfo()
获取详细信息public static final int LOCATION_TYPE_GPS
通过设备卫星定位模块返回的定位结果
public static final int LOCATION_TYPE_SAME_REQ
网络定位请求低于1秒、或两次定位之间设备位置变化非常小时返回,设备位移通过传感器感知
public static final int LOCATION_TYPE_FAST
AMapLocation.LOCATION_TYPE_SAME_REQ
public 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_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 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 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_UNKNOWN
public int getLocationType()
public java.lang.String getLocationDetail()
public int getErrorCode()
public java.lang.String getErrorInfo()
public java.lang.String getCountry()
public java.lang.String getRoad()
AMapLocation.getStreet()
方法代替public java.lang.String getAddress()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回地址信息
自2.9.0版本开始,当类型为AMapLocation.LOCATION_TYPE_GPS
时也可以返回地址信息(需要网络通畅,第一次有可能没有地址信息返回)
public java.lang.String getProvince()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回省份名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回省份名称
public java.lang.String getCity()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回城市名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回省城市名称
public java.lang.String getDistrict()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回区的名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回区的名称
public java.lang.String getCityCode()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回城市编码
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回城市编码
public java.lang.String getAdCode()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回区域编码
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回区域编码
public java.lang.String getPoiName()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回兴趣点名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回兴趣点名称
public double getLatitude()
public double getLongitude()
public int getSatellites()
public java.lang.String getStreet()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回街道名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回街道名称
public java.lang.String getStreetNum()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回门牌号
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回门牌号
public java.lang.String getAoiName()
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS
时不会返回兴趣面名称
自2.9.0版本开始,当AMapLocation.LOCATION_TYPE_GPS
时也可以返回兴趣面名称
public java.lang.String getBuildingId()
public java.lang.String getFloor()
public java.lang.String getDescription()
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 float getBearing()
默认值:0.0
取值范围:【0,360】,其中0度表示正北方向,90度表示正东,180度表示正南,270度表示正西
3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS
时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是AMapLocation.LOCATION_TYPE_GPS
时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回方向角,当设置为true时会通过手机传感器获取方向角,如果手机没有对应的传感器会返回0.0
注意:
定位类型为AMapLocation.LOCATION_TYPE_GPS
时,方向角指的是运动方向
定位类型不是AMapLocation.LOCATION_TYPE_GPS
时,方向角指的是手机朝向
public double getAltitude()
默认值:0.0
3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS
时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是AMapLocation.LOCATION_TYPE_GPS
时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回海拔高度,当设置为true时会通过手机传感器获取海拔高度,如果手机没有对应的传感器会返回0.0
public float getSpeed()
默认值:0.0
3.1.0之前的版本只有定位类型为 AMapLocation.LOCATION_TYPE_GPS
时才有值
自3.1.0版本开始,不限定定位类型,当定位类型不是AMapLocation.LOCATION_TYPE_GPS
时,可以通过
AMapLocationClientOption.setSensorEnable(boolean)
控制是否返回速度值,当设置为true时会通过手机传感器获取速度,如果手机没有对应的传感器会返回0.0
public java.lang.String getProvider()
lbs:高德网络定位
gps:卫星定位
public Bundle getExtras()
public AMapLocationQualityReport getLocationQualityReport()
public java.lang.String getCoordType()
高德定位sdk会返回两种坐标系
AMapLocation.COORD_TYPE_GCJ02
-- GCJ02坐标系
AMapLocation.COORD_TYPE_WGS84
-- WGS84坐标系,国外定位时返回的是WGS84坐标系
public int getTrustedLevel()
AMapLocation.TRUSTED_LEVEL_HIGH
AMapLocation.TRUSTED_LEVEL_NORMAL
AMapLocation.TRUSTED_LEVEL_LOW
AMapLocation.TRUSTED_LEVEL_BAD
public int getConScenario()