使用

• 创建位置监听器
• 创建定位请求
• 注册位置监听器
• 获取定位结果
• 删除位置监听器
• Android 6.0 说明

创建位置监听器

TencentLocationListener 接口代表位置监听器，您的 App 通过位置监听器接收定位 SDK 的位置变化通知。创建位置监听器非常简单，通常您只需实现 TencentLocationListener 接口。如下所示:

public class MyActivity extends Activity implements TencentLocationListener {

    ...

    @Override
    public void onLocationChanged(TencentLocation location, int error, String reason) {
        // do your work
    }

    @Override
    public void onStatusUpdate(String name, int status, String desc) {
        // do your work
    }          
}

位置监听器的回调方法分为两类：一类是位置更新时的回调，一类是 GPS 和 Wi-Fi 的状态变化回调。

• 位置回调接口如下：

public void onLocationChanged(TencentLocation location, int error, String reason)

• 状态回调接口如下:

public void onStatusUpdate(String name, int status, String desc)

在 Android 6.0 及以上的系统版本中，当位置开关关闭时，onStatusUpdate 接口会返回 name=wifi，status=5，该状态码说明位置开关关闭，此时无法进行 Wi-Fi 扫描。收到该状态码后，请及时提醒用户打开位置开关。

状态码即 TencentLocationListener的onStatusUpdate 回调的 status 字段返回的。

创建定位请求

TencentLocationRequest 类代表定位请求， 您的 App 通过向定位 SDK 发送定位请求来启动定位。通常您只需获取 TencentLocationRequest 实例即可，如下所示：

TencentLocationRequest request = TencentLocationRequest.create();

以上得到的是一个缺省的定位请求，缺省的定位请求各参数如下：

• 定位周期（位置监听器回调周期）: 10秒

• Request Level: REQUEST_LEVEL_NAME

• 缓存: 允许使用缓存

• QQ: 空字符串

• 手机号：空字符串

• 传感器：默认不使用

• GPS：允许使用缓存

• 室内定位：默认不使用

可调用如下方法来对定位请求进行自定义配置：

Request level 决定定位结果中包含哪些信息，分为以下几类：

注册位置监听器

TencentLocationManager 类代表腾讯定位服务。注册位置监听器前需要获取 TencentLocationManager 实例，示例如下

Context context = ...
TencentLocationListener listener = ...
TencentLocationRequest request = ...
TencentLocationManager locationManager = TencentLocationManager.getInstance(context);
int error = locationManager.requestLocationUpdates(request, listener);

• 返回值为0时，表示位置监听器注册成功。注册成功之后，在位置发生变化时，位置监听器的位置回调接口或状态回调接口将会被调用，用以接收最新的位置或状态。
• 返回值非0时，表示位置监听器注册失败。注册监听器失败时，将无法接收到位置更新，继续使用腾讯地图定位SDK前您应先排查注册失败的问题。常见的返回值如下：

获取定位结果

通过位置监听器的位置回调接口获取定位结果。使用定位结果前应当先检查错误码：

@Override
public void onLocationChanged(TencentLocation location, int error, String reason) {
    if (TencentLocation.ERROR_OK == error) {
        // 定位成功
    } else {
        // 定位失败
    }
}

错误码说明

错误码来自 TencentLocation 的 ERROR_XXX 常量，分如下几种情形：

request level 说明

request level 来自 TencentLocationRequest 的 REQUEST_LEVEL_XXX 常量，分如下几种情形：

• 当定位请求的 request level 为 REQ_LEVEL_GEO 时，以下字段有效:

• 当定位请求的 request level 为 REQ_LEVEL_NAME 时，以下字段有效:

• 当定位请求的 request level 为 REQ_LEVEL_ADMIN_AREA 时，以下字段有效:

• 当定位请求的 request level 为 REQ_LEVEL_POI 时，以下字段有效:

删除位置监听器

定位完成后，无论成功或失败，都应当尽快删除之前注册的位置监听器。代码如下：

Context context = ...
TencentLocationListener listener = ...
TencentLocationManager locationManager =
                        TencentLocationManager.getInstance(context);
locationManager.removeUpdates(listener);

Android 6.0 说明

Android 6.0 系统在原有的 AndroidManifest.xml 声明权限的基础上新增了运行时权限动态检测，定位等权限也包含在其中。如果您的应用程序设置了 targetSdkVersion ≥ 23，则需要在调用定位功能前进行权限检查，权限检查的示例代码如下：

if (Build.VERSION.SDK_INT >= 23) {
     String[] permissions = {
                Manifest.permission.ACCESS_COARSE_LOCATION,
                Manifest.permission.READ_PHONE_STATE,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
        };
    if (checkSelfPermission(permissions[0]) != PackageManager.PERMISSION_GRANTED)
    {
        requestPermissions(permissions, 0);
    }
}

用户选择允许或拒绝后，会回调 onRequestPermissionsResult 方法:

@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    //可在此继续其他操作。
}