TencentLocationManager

java.lang.Object
- com.tencent.map.geolocation.TencentLocationManager

```
public final class TencentLocationManager
extends java.lang.Object
```
用于访问腾讯定位服务的类, 腾讯定位服务可周期性向客户端提供位置更新.
注意, 使用腾讯定位服务前, 应确保:
- manifest中配置正确的key, 立即申请key
- manifest中配置正确的权限, 详情请参考开发指南

字段概要

字段
限定符和类型	字段和说明
`static int`	`COORDINATE_TYPE_GCJ02` 坐标系标识, 国测局坐标(火星坐标).
`static int`	`COORDINATE_TYPE_WGS84` 坐标系标识, WGS84坐标(GPS坐标, 地球坐标).
`static int`	`TYPE_OAID`
`static int`	`TYPE_OTHER_ID`
`static int`	`TYPE_QIMEI`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`disableForegroundLocation(boolean removeNotification)` 关闭前台定位服务
`void`	`enableForegroundLocation(int notificationId, android.app.Notification notification)` 开启前台定位服务，注意需要在清单文件中配置服务 com.tencent.map.geolocation.s
`java.lang.String`	`getBuild()`
`int`	`getCoordinateType()` 获取当前使用的坐标系.
`static TencentLocationManager`	`getInstance(android.content.Context context)` 获取腾讯定位服务实例，该方法需要在带有looper的线程调用，SDK会保证无耗时操作并立即返回。
`TencentLocation`	`getLastKnownLocation()` 返回最近一次的位置, 可能为 null.
`java.lang.String`	`getVersion()`
`void`	`removeUpdates(TencentLocationListener listener)` 移除位置监听器并停止定位.
`int`	`requestLocationUpdates(TencentLocationRequest request, TencentLocationListener listener)` 请求定位, 位置更新将通过 listener 回调通知.
`int`	`requestLocationUpdates(TencentLocationRequest request, TencentLocationListener listener, android.os.Looper looper)` 请求(在与 looper 关联的线程中)定位, 位置更新将通过 listener 回调通知.
`int`	`requestSingleFreshLocation(TencentLocationRequest request, TencentLocationListener listener, android.os.Looper looper)` 获取当前单次定位，该方法可在未启动周期性回调时获取一次最新位置也可以在启动周期性回调时，强制刷新得到一次最新的位置信息该接口在单次定位时，获取位置结果为1号定位接口，在启动周期性回调时，结果跟随TencentLocationRequest中设置的定位接口号码。
`void`	`setCoordinateType(int coordinateType)` 设置坐标系.
`void`	`setDebuggable(boolean debuggable)` 设置是否允许内部进入Debug模式[默认为false]。
`boolean`	`startIndoorLocation()` 立即启动高精度室内定位.
`boolean`	`stopIndoorLocation()` 立即中断室内定位组件运行，相当于interrupt the indoor thread。
`void`	`triggerCodeGuarder(boolean trigger)` 启动反调试代码保护策略，默认关闭。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - TYPE_QIMEI
```
public static final int TYPE_QIMEI
```
    另请参阅:
    
    常量字段值
  - TYPE_OAID
```
public static final int TYPE_OAID
```
    另请参阅:
    
    常量字段值
  - TYPE_OTHER_ID
```
public static final int TYPE_OTHER_ID
```
    另请参阅:
    
    常量字段值
  - COORDINATE_TYPE_GCJ02
```
public static final int COORDINATE_TYPE_GCJ02
```
    坐标系标识, 国测局坐标(火星坐标).
    
    另请参阅:
    
    常量字段值
  - COORDINATE_TYPE_WGS84
```
public static final int COORDINATE_TYPE_WGS84
```
    坐标系标识, WGS84坐标(GPS坐标, 地球坐标).
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - getInstance
```
public static TencentLocationManager getInstance(android.content.Context context)
                                          throws java.lang.NullPointerException,
                                                 java.lang.IllegalArgumentException
```
    获取腾讯定位服务实例，该方法需要在带有looper的线程调用，SDK会保证无耗时操作并立即返回。
    
    参数:
    
    context - Activity, Service, ApplicationContext 等各种 Context
    
    抛出:
    
    java.lang.NullPointerException - context 为 null
    
    java.lang.IllegalArgumentException - 没有在带有线程调用该方法
  - enableForegroundLocation
```
public void enableForegroundLocation(int notificationId,
                                     android.app.Notification notification)
                              throws java.lang.IllegalArgumentException
```
    开启前台定位服务，注意需要在清单文件中配置服务 com.tencent.map.geolocation.s
    
    参数:
    
    notificationId - notifation设置唯一id
    
    notification - 自定义的通知
    
    抛出:
    
    java.lang.IllegalArgumentException - 非法的的坐标类型，notificationId必须大于0，且notification不为null，否则抛出该异常
  - disableForegroundLocation
```
public void disableForegroundLocation(boolean removeNotification)
```
    关闭前台定位服务
    
    参数:
    
    removeNotification - 是否移除通知栏通知
  - setCoordinateType
```
public void setCoordinateType(int coordinateType)
```
    设置坐标系. 缺省的坐标为 GCJ02, 通常*不应*调整.
    
    参数:
    
    coordinateType - 合法的坐标系只包括 COORDINATE_TYPE_GCJ02 和 COORDINATE_TYPE_WGS84
    
    抛出:
    
    java.lang.IllegalArgumentException - 非法的的坐标类型
    
    java.lang.IllegalStateException - 未取消位置监听器(定位仍在进行)的情况下调用本方法
  - getCoordinateType
```
public int getCoordinateType()
```
    获取当前使用的坐标系.
  - requestLocationUpdates
```
public int requestLocationUpdates(TencentLocationRequest request,
                                  TencentLocationListener listener)
```
    请求定位, 位置更新将通过 listener 回调通知.
    强烈建议在主线程中调用本方法, 定位完成后(无论定位成功或失败)都应尽快移除 listener, 否则可能不必要地消耗较多电量.
    
    参数:
    
    request - 定位请求
    
    listener - 位置监听器
    
    返回:
    
    0-成功注册监听器, 1-设备缺少使用腾讯定位服务需要的基本条件, 2-manifest 中配置的 key 不正确, 3-自动加载libtencentloc.so失败 4-ClassLoader获取或加载失败，5-加载类失败
    
    抛出:
    
    java.lang.NullPointerException - request 或 listener 为 null
  - requestLocationUpdates
```
public int requestLocationUpdates(TencentLocationRequest request,
                                  TencentLocationListener listener,
                                  android.os.Looper looper)
```
    请求(在与 looper 关联的线程中)定位, 位置更新将通过 listener 回调通知.
    强烈建议在主线程中调用本方法, 定位完成后(无论定位成功或失败)都应尽快移除 listener, 否则可能不必要地消耗较多电量.
    注意: 由于回调方法在新线程中调用, 回调方法中*不应*执行某些必须在主线程中完成的操作, 比如更新UI.
    
    参数:
    
    request - 定位请求
    
    listener - 位置监听器
    
    looper - looper
    
    返回:
    
    0-成功注册监听器, 1-设备缺少使用腾讯定位服务需要的基本条件, 2-manifest 中配置的 key 不正确, 3-自动加载libtencentloc.so失败 4-ClassLoader获取或加载失败，5-加载类失败
    
    抛出:
    
    java.lang.NullPointerException - request, listener 或者 looper 为 null
  - requestSingleFreshLocation
```
public int requestSingleFreshLocation(TencentLocationRequest request,
                                      TencentLocationListener listener,
                                      android.os.Looper looper)
```
    获取当前单次定位，该方法可在未启动周期性回调时获取一次最新位置也可以在启动周期性回调时，强制刷新得到一次最新的位置信息该接口在单次定位时，获取位置结果为1号定位接口，在启动周期性回调时，结果跟随TencentLocationRequest中设置的定位接口号码。
    
    参数:
    
    listener，回调完成后，sdk中会置null释放指向，防止内存泄漏 -
    
    返回:
    
    0为成功，其他为异常
  - startIndoorLocation
```
public boolean startIndoorLocation()
```
    立即启动高精度室内定位. 启动后，当所在的楼宇支持腾讯的高精度室内定位时，会默认切换到室内定位，离开时自动切换回原定位方式
  - stopIndoorLocation
```
public boolean stopIndoorLocation()
```
    立即中断室内定位组件运行，相当于interrupt the indoor thread。中断后，室内定位组件停止运行，但不影响正常定位逻辑。
  - getLastKnownLocation
```
public TencentLocation getLastKnownLocation()
```
    返回最近一次的位置, 可能为 null.
  - removeUpdates
```
public void removeUpdates(TencentLocationListener listener)
```
    移除位置监听器并停止定位.
    定位完成后应尽快通过本方法移除 listener 否则可能消耗较多电量.
    
    参数:
    
    listener - 位置监听器
  - getBuild
```
public java.lang.String getBuild()
```
  - getVersion
```
public java.lang.String getVersion()
```
  - setDebuggable
```
public void setDebuggable(boolean debuggable)
```
    设置是否允许内部进入Debug模式[默认为false]。如果开发者遇到问题，在请求定位前设置为true，内部会将运行日志上传到腾讯服务器，将手机IMEI和当前时间提供给我们，可以分析出现问题的原因。
    
    参数:
    
    debuggable - 是否允许内部进入Debug模式[默认为false]
  - triggerCodeGuarder
```
public void triggerCodeGuarder(boolean trigger)
```
    启动反调试代码保护策略，默认关闭。注意开启反调试策略后可能会导致debug失败，因此如果需要调试时请不要开启，上线部署时再开启。
    
    参数:
    
    trigger - 是否启动反调试策略[默认为false]

类 TencentLocationManager

字段概要

方法概要

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

字段详细资料

TYPE_QIMEI

TYPE_OAID

TYPE_OTHER_ID

COORDINATE_TYPE_GCJ02

COORDINATE_TYPE_WGS84

方法详细资料

getInstance

enableForegroundLocation

disableForegroundLocation

setCoordinateType

getCoordinateType

requestLocationUpdates

requestLocationUpdates

requestSingleFreshLocation

startIndoorLocation

stopIndoorLocation

getLastKnownLocation

removeUpdates

getBuild

getVersion

setDebuggable

triggerCodeGuarder