com.amap.api.location

## 类 AMapLocation

- java.lang.Object
- - Location
  - - com.amap.api.location.AMapLocation

- 所有已实现的接口:
    java.lang.Cloneable

      public class AMapLocation
      extends Location
      implements java.lang.Cloneable

  定位信息类。定位完成后的位置信息。
  从以下版本开始:
    2.0.0
  版本:
    2.0.0

- - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `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` 已过时。 已合并到`AMapLocation.LOCATION_TYPE_SAME_REQ`
    `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()`

    - ### 从类继承的方法 java.lang.Object

      `equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### 字段详细资料

    - #### LOCATION_SUCCESS

          public static final int LOCATION_SUCCESS

      定位错误码：定位成功
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_INVALID_PARAMETER

          public static final int ERROR_CODE_INVALID_PARAMETER

      定位错误码：一些重要参数为空,如context,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_WIFI_INFO

          public static final int ERROR_CODE_FAILURE_WIFI_INFO

      定位错误码：定位失败，由于设备仅扫描到单个wifi，不能精准的计算出位置信息。
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_LOCATION_PARAMETER

          public static final int ERROR_CODE_FAILURE_LOCATION_PARAMETER

      定位错误码：获取到的请求参数为空，可能获取过程中出现异常,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_CONNECTION

          public static final int ERROR_CODE_FAILURE_CONNECTION

      定位错误码：网络连接异常,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_PARSER

          public static final int ERROR_CODE_FAILURE_PARSER

      定位错误码：解析XML出错,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_LOCATION

          public static final int ERROR_CODE_FAILURE_LOCATION

      定位错误码：定位结果错误,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_AUTH

          public static final int ERROR_CODE_FAILURE_AUTH

      定位错误码：KEY错误,可以通过`AMapLocation.getLocationDetail()`获取详细信息来跟注册的KEY信息进行对照
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_UNKNOWN

          public static final int ERROR_CODE_UNKNOWN

      定位错误码：其他错误,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_INIT

          public static final int ERROR_CODE_FAILURE_INIT

      定位错误码：初始化异常,可以通过`AMapLocation.getLocationDetail()`获取详细信息
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_SERVICE_FAIL

          public static final int ERROR_CODE_SERVICE_FAIL

      定位错误码：定位服务启动失败，请检查是否配置service并且manifest中service标签是否配置在application标签内
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_CELL

          public static final int ERROR_CODE_FAILURE_CELL

      定位错误码：错误的基站信息，请检查是否安装SIM卡
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_LOCATION_PERMISSION

          public static final int ERROR_CODE_FAILURE_LOCATION_PERMISSION

      定位错误码：缺少定位权限,请检查是否配置定位权限,并在安全软件和设置中给应用打开定位权限
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_NOWIFIANDAP

          public static final int ERROR_CODE_FAILURE_NOWIFIANDAP

      定位错误码：网络定位失败，请检查设备是否插入sim卡、开启移动网络或开启了wifi模块
      从以下版本开始:
        3.0.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_NOENOUGHSATELLITES

          public static final int ERROR_CODE_FAILURE_NOENOUGHSATELLITES

      定位错误码：卫星定位失败，可用卫星数不足
      从以下版本开始:
        3.1.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_SIMULATION_LOCATION

          public static final int ERROR_CODE_FAILURE_SIMULATION_LOCATION

      定位错误码：定位位置可能被模拟
      从以下版本开始:
        3.2.0
      另请参阅:
        常量字段值

    - #### ERROR_CODE_AIRPLANEMODE_WIFIOFF

          public static final int ERROR_CODE_AIRPLANEMODE_WIFIOFF

      定位错误码：定位失败，飞行模式下关闭了WIFI开关，请关闭飞行模式或者打开WIFI开关
      从以下版本开始:
        3.4.1
      另请参阅:
        常量字段值

    - #### ERROR_CODE_NOCGI_WIFIOFF

          public static final int ERROR_CODE_NOCGI_WIFIOFF

      定位错误码：定位失败，没有检查到SIM卡，并且关闭了WIFI开关，请打开WIFI开关或者插入SIM卡
      从以下版本开始:
        3.4.1
      另请参阅:
        常量字段值

    - #### ERROR_CODE_FAILURE_COARSE_LOCATION

          public static final int ERROR_CODE_FAILURE_COARSE_LOCATION

      定位错误码：定位失败，模糊权限下定位异常，可以通过`AMapLocation.getErrorInfo()` 获取详细信息
      从以下版本开始:
        6.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_GPS

          public static final int LOCATION_TYPE_GPS

      定位结果类型：卫星定位结果

      通过设备卫星定位模块返回的定位结果

      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_SAME_REQ

          public static final int LOCATION_TYPE_SAME_REQ

      定位结果类型：前次定位结果

      网络定位请求低于1秒、或两次定位之间设备位置变化非常小时返回，设备位移通过传感器感知

      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_FAST

          public static final int LOCATION_TYPE_FAST

      已过时。 已合并到`AMapLocation.LOCATION_TYPE_SAME_REQ`
      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_FIX_CACHE

          public static final int LOCATION_TYPE_FIX_CACHE

      定位结果类型：缓存定位结果

      返回一段时间前设备在相同的环境中缓存下来的网络定位结果，节省无必要的设备定位消耗

      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_WIFI

          public static final int LOCATION_TYPE_WIFI

      定位结果类型：Wifi定位结果

      属于网络定位，定位精度相对基站定位会更好

      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_CELL

          public static final int LOCATION_TYPE_CELL

      定位结果类型：基站定位结果

      属于网络定位

      从以下版本开始:
        2.0.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_OFFLINE

          public static final int LOCATION_TYPE_OFFLINE

      定位结果类型： 离线定位结果
      从以下版本开始:
        2.2.0
      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_LAST_LOCATION_CACHE

          public static final int LOCATION_TYPE_LAST_LOCATION_CACHE

      定位结果类型： 最后位置缓存
      从以下版本开始:
        3.4.1
      另请参阅:
        常量字段值

    - #### LOCATION_COMPENSATION

          public static final int LOCATION_COMPENSATION

      另请参阅:
        常量字段值

    - #### LOCATION_TYPE_COARSE_LOCATION

          public static final int LOCATION_TYPE_COARSE_LOCATION

      模糊定位类型
      从以下版本开始:
        6.0.0
      另请参阅:
        常量字段值

    - #### COORD_TYPE_WGS84

          public static final java.lang.String COORD_TYPE_WGS84

      WGS84坐标系
      从以下版本开始:
        4.3.0

    - #### COORD_TYPE_GCJ02

          public static final java.lang.String COORD_TYPE_GCJ02

      GCJ02坐标系
      从以下版本开始:
        4.3.0

    - #### GPS_ACCURACY_GOOD

          public static final int GPS_ACCURACY_GOOD

      卫星信号强
      从以下版本开始:
        3.1.0
      另请参阅:
        常量字段值

    - #### GPS_ACCURACY_BAD

          public static final int GPS_ACCURACY_BAD

      卫星信号弱
      从以下版本开始:
        3.1.0
      另请参阅:
        常量字段值

    - #### GPS_ACCURACY_UNKNOWN

          public static final int GPS_ACCURACY_UNKNOWN

      卫星状态未知
      从以下版本开始:
        3.1.0
      另请参阅:
        常量字段值

    - #### TRUSTED_LEVEL_HIGH

          public static final int TRUSTED_LEVEL_HIGH

      定位结果的可信度-非常可信

    - 周边信息的新鲜度在15s之内
    - 实时GPS定位结果

从以下版本开始:
  4.4.0
另请参阅:
  常量字段值

- #### TRUSTED_LEVEL_NORMAL

      public static final int TRUSTED_LEVEL_NORMAL

  定位结果的可信度-可信度一般

- 周边信息的新鲜度在15秒-2分钟之间
- 缓存、离线定位、最后位置

从以下版本开始:
  4.4.0
另请参阅:
  常量字段值

- #### TRUSTED_LEVEL_LOW

      public static final int TRUSTED_LEVEL_LOW

  定位结果的可信度-可信度较低

- 周边信息的新鲜度在2-10分钟之间

从以下版本开始:
  4.4.0
另请参阅:
  常量字段值

- #### TRUSTED_LEVEL_BAD

      public static final int TRUSTED_LEVEL_BAD

  定位结果的可信度-非常不可信

- 周边信息的新鲜度超过10分钟
- 模拟定位结果

从以下版本开始:
  4.4.0
另请参阅:
  常量字段值

- ### 构造器详细资料

  - #### AMapLocation

        public AMapLocation(java.lang.String provider)

    根据定位提供者构造
    参数:
      `provider` - 定位提供者名称
    从以下版本开始:
      2.0.0

  - #### AMapLocation

        public AMapLocation(Location location)

    根据android.location.Location对象构造
    参数:
      `location` - android。location.Location对象
    从以下版本开始:
      2.0.0

- ### 方法详细资料

  - #### getGpsAccuracyStatus

        public int getGpsAccuracyStatus()

    获取卫星信号强度，仅在卫星定位时有效,值为 `#GPS_ACCURACY_BAD，#GPS_ACCURACY_GOOD，#GPS_ACCURACY_UNKNOWN`
    返回:
    从以下版本开始:
      3.1.0

  - #### getLocationType

        public int getLocationType()

    获取定位结果来源
    返回:
    从以下版本开始:
      2.0.0

  - #### getLocationDetail

        public java.lang.String getLocationDetail()

    获取定位信息描述
    返回:
      定位信息描述
    从以下版本开始:
      2.0.0

  - #### getErrorCode

        public int getErrorCode()

    获取错误码
    返回:
      错误码
    从以下版本开始:
      2.0.0

  - #### getErrorInfo

        public java.lang.String getErrorInfo()

    获取错误信息
    返回:
      错误信息
    从以下版本开始:
      2.0.0

  - #### getCountry

        public java.lang.String getCountry()

    获取国家名称
    返回:
    从以下版本开始:
      2.0.0

  - #### getRoad

        public java.lang.String getRoad()

    已过时。 使用`AMapLocation.getStreet()`方法代替
    获取街道或者道路名称
    返回:
      街道或者道路名称
    从以下版本开始:
      2.0.0

  - #### getAddress

        public java.lang.String getAddress()

    获取地址

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回地址信息
    自2.9.0版本开始，当类型为`AMapLocation.LOCATION_TYPE_GPS`时也可以返回地址信息(需要网络通畅，第一次有可能没有地址信息返回）

    返回:
      地址
    从以下版本开始:
      2.0.0

  - #### getProvince

        public java.lang.String getProvince()

    获取省的名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回省份名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回省份名称

    返回:
      省的名称
    从以下版本开始:
      2.0.0

  - #### getCity

        public java.lang.String getCity()

    获取城市名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回城市名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回省城市名称

    返回:
      城市名称
    从以下版本开始:
      2.0.0

  - #### getDistrict

        public java.lang.String getDistrict()

    获取区的名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回区的名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回区的名称

    返回:
      区的名称
    从以下版本开始:
      2.0.0

  - #### getCityCode

        public java.lang.String getCityCode()

    获取城市编码

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回城市编码
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回城市编码

    返回:
      城市编码
    从以下版本开始:
      2.0.0

  - #### getAdCode

        public java.lang.String getAdCode()

    获取区域编码

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回区域编码
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回区域编码

    返回:
      区域编码
    从以下版本开始:
      2.0.0

  - #### getPoiName

        public java.lang.String getPoiName()

    获取兴趣点名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回兴趣点名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回兴趣点名称

    返回:
      兴趣点名称
    从以下版本开始:
      2.2.0

  - #### getLatitude

        public double getLatitude()

    获取纬度
    返回:
      纬度
    从以下版本开始:
      2.0.0

  - #### getLongitude

        public double getLongitude()

    获取经度
    返回:
      经度
    从以下版本开始:
      2.0.0

  - #### getSatellites

        public int getSatellites()

    获取当前可用卫星数量, 仅在卫星定位时有效,
    返回:
      卫星数量
    从以下版本开始:
      2.3.0

  - #### getStreet

        public java.lang.String getStreet()

    获取街道名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回街道名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回街道名称

    返回:
      街道名称
    从以下版本开始:
      2.3.0

  - #### getStreetNum

        public java.lang.String getStreetNum()

    获取门牌号

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回门牌号
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回门牌号

    返回:
      门牌号
    从以下版本开始:
      2.3.0

  - #### getAoiName

        public java.lang.String getAoiName()

    获取兴趣面名称

    2.9.0之前的版本定位类型为`AMapLocation.LOCATION_TYPE_GPS`时不会返回兴趣面名称
    自2.9.0版本开始，当`AMapLocation.LOCATION_TYPE_GPS`时也可以返回兴趣面名称

    返回:
      兴趣面名称
    从以下版本开始:
      2.4.0

  - #### getBuildingId

        public java.lang.String getBuildingId()

    返回支持室内定位的建筑物ID信息
    返回:
      建筑物的POIID，
    从以下版本开始:
      3.2.0

  - #### getFloor

        public java.lang.String getFloor()

    获取室内定位的楼层信息
    返回:
      楼层信息
    从以下版本开始:
      3.2.0

  - #### getDescription

        public java.lang.String getDescription()

    获取位置语义信息
    返回:
      位置语义信息
    从以下版本开始:
      3.4.0

  - #### toString

        public java.lang.String toString()

  - #### toStr

        public java.lang.String toStr()

    将定位结果转换成字符串
    返回:
      定位结果字符串
    从以下版本开始:
      2.0.0

  - #### toStr

        public java.lang.String toStr(int iT)

    将定位结果转化为字符串
    参数:
      `iT` - 【1代表完整描述，2代表精简描述，3代表极简描述】
    返回:
      定位结果字符串
    从以下版本开始:
      2.0.0

  - #### getAccuracy

        public float getAccuracy()

    获取定位精度

    单位:米

    返回:
      定位精度
    从以下版本开始:
      2.0.0

  - #### getBearing

        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`时，方向角指的是手机朝向

    返回:
      方向角
    从以下版本开始:
      2.0.0

  - #### getAltitude

        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

    返回:
      海拔高度
    从以下版本开始:
      2.0.0

  - #### getSpeed

        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

    返回:
      当前速度
    从以下版本开始:
      2.0.0

  - #### getProvider

        public java.lang.String getProvider()

    获取定位提供者
    返回:
      定位提供者

      lbs:高德网络定位

      gps:卫星定位

    从以下版本开始:
      2.0.0

  - #### getExtras

        public Bundle getExtras()

  - #### getLocationQualityReport

        public AMapLocationQualityReport getLocationQualityReport()

    获取定位质量
    返回:
    从以下版本开始:
      3.6.0

  - #### getCoordType

        public java.lang.String getCoordType()

    获取坐标系类型

    高德定位sdk会返回两种坐标系

  - `AMapLocation.COORD_TYPE_GCJ02` -- GCJ02坐标系
  - `AMapLocation.COORD_TYPE_WGS84` -- WGS84坐标系,国外定位时返回的是WGS84坐标系
  从以下版本开始:
    4.3.0

- #### getTrustedLevel

      public int getTrustedLevel()

  获取定位结果的可信度

- 只有在定位成功时才有意义
- 非常可信 `AMapLocation.TRUSTED_LEVEL_HIGH`
- 可信度一般`AMapLocation.TRUSTED_LEVEL_NORMAL`
- 可信度较低 `AMapLocation.TRUSTED_LEVEL_LOW`
- 非常不可信 `AMapLocation.TRUSTED_LEVEL_BAD`

返回:
从以下版本开始:
  4.4.0

- #### getConScenario

      public int getConScenario()

  室内外置信度

- 室内：且置信度取值在[1 ～ 100]，值越大在室内的可能性越大
- 室外：且置信度取值在[-100 ～ -1] ,值越小在室外的可能性越大
- 无法识别室内外：置信度返回值为 0

返回:
  室内外置信度
从以下版本开始:
  4.6