com.tencent.map.geolocation

## 接口 TencentLocationListener

-     public interface TencentLocationListener

  位置监听器.

  定位 SDK 通过位置监听器将位置变化通知给客户端.

- - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static java.lang.String` | `CELL` 设备名, Cell.
    `static java.lang.String` | `GPS` 设备名, GPS.
    `static java.lang.String` | `RADIO` 已过时。
    `static int` | `STATUS_DENIED` 状态码, 位置权限被拒绝，通常由于LBE类似的管理软件禁止了app的定位权限.
    `static int` | `STATUS_DISABLED` 状态码, 代表设备(wifi、基站、GPS)已关闭.
    `static int` | `STATUS_ENABLED` 状态码, 代表设备(wifi、基站、GPS)已开启(开启并不意味着可用).
    `static int` | `STATUS_GPS_AVAILABLE` 状态码，GPS可用，代表GPS开关打开，且搜星定位成功
    `static int` | `STATUS_GPS_UNAVAILABLE` 状态码，GPS不可用，不可用有多种可能，比如GPS开关被关闭，GPS开关开着但是没办法搜到卫星等等
    `static int` | `STATUS_LOCATION_SWITCH_OFF` 状态码，表示位置服务开关未打开
    `static int` | `STATUS_UNKNOWN` 状态码, 未知状态.
    `static java.lang.String` | `WIFI` 设备名, WiFi.

  - ### 方法概要

    所有方法 实例方法 抽象方法
    限定符和类型 | 方法和说明
    --- | ---
    `void` | `onLocationChanged(TencentLocation location, int error, java.lang.String reason)` 位置发生变化.
    `void` | `onStatusUpdate(java.lang.String name, int status, java.lang.String desc)` GPS, WiFi, Radio 等状态发生变化.

- - ### 字段详细资料

    - #### GPS

          static final java.lang.String GPS

      设备名, GPS.
      另请参阅:
        常量字段值

    - #### WIFI

          static final java.lang.String WIFI

      设备名, WiFi.
      另请参阅:
        常量字段值

    - #### RADIO

          @Deprecated
          static final java.lang.String RADIO

      已过时。
      设备名, 基站信号.
      另请参阅:
        `CELL`, 常量字段值

    - #### CELL

          static final java.lang.String CELL

      设备名, Cell.
      另请参阅:
        常量字段值

    - #### STATUS_DISABLED

          static final int STATUS_DISABLED

      状态码, 代表设备(wifi、基站、GPS)已关闭.
      另请参阅:
        常量字段值

    - #### STATUS_ENABLED

          static final int STATUS_ENABLED

      状态码, 代表设备(wifi、基站、GPS)已开启(开启并不意味着可用).
      另请参阅:
        常量字段值

    - #### STATUS_DENIED

          static final int STATUS_DENIED

      状态码, 位置权限被拒绝，通常由于LBE类似的管理软件禁止了app的定位权限.

      注意: 位置权限被拒绝通常发生在禁用当前应用的 ACCESS_COARSE_LOCATION 等定位权限
      另请参阅:
        常量字段值

    - #### STATUS_GPS_AVAILABLE

          static final int STATUS_GPS_AVAILABLE

      状态码，GPS可用，代表GPS开关打开，且搜星定位成功
      另请参阅:
        常量字段值

    - #### STATUS_GPS_UNAVAILABLE

          static final int STATUS_GPS_UNAVAILABLE

      状态码，GPS不可用，不可用有多种可能，比如GPS开关被关闭，GPS开关开着但是没办法搜到卫星等等
      另请参阅:
        常量字段值

    - #### STATUS_LOCATION_SWITCH_OFF

          static final int STATUS_LOCATION_SWITCH_OFF

      状态码，表示位置服务开关未打开
      另请参阅:
        常量字段值

    - #### STATUS_UNKNOWN

          static final int STATUS_UNKNOWN

      状态码, 未知状态.
      另请参阅:
        常量字段值

  - ### 方法详细资料

    - #### onLocationChanged

          void onLocationChanged(TencentLocation location,
                                 int error,
                                 java.lang.String reason)

      位置发生变化.
      参数:
        `location` - 新的位置, *可能*来自缓存. 定位失败时 location 无效或者为 null
        `error` - 错误码, 仅当错误码为 `TencentLocation.ERROR_OK` 时表示定位成功, 为其他值时表示定位失败
        `reason` - 错误描述, 简要描述错误原因
      另请参阅:
        `TencentLocation.ERROR_BAD_JSON`, `TencentLocation.ERROR_NETWORK`, `TencentLocation.ERROR_OK`, `TencentLocation.ERROR_UNKNOWN`

    - #### onStatusUpdate

          void onStatusUpdate(java.lang.String name,
                              int status,
                              java.lang.String desc)

      GPS, WiFi, Radio 等状态发生变化.
      参数:
        `name` - 设备名, `GPS`, `WIFI`, `CELL` 中的某个
        `status` - 状态码, `STATUS_ENABLED`, `STATUS_DISABLED`, `STATUS_UNKNOWN`, `STATUS_GPS_AVAILABLE`, `STATUS_GPS_UNAVAILABLE`, `STATUS_DENIED`中的某个 在使用status之前,请先按照name进行区分
        `desc` - 状态描述
      另请参阅:
        `GPS`, `WIFI`, `CELL`