Android封装高德地图定位工具类Util的方法

发布时间：2022-03-30 10:51:17 作者：iii
来源：亿速云阅读：497

# Android封装高德地图定位工具类Util的方法

## 前言

在移动应用开发中，位置服务(LBS)已成为不可或缺的功能模块。高德地图作为国内领先的地图服务提供商，其定位SDK被广泛应用于各类Android应用中。本文将详细介绍如何封装一个高德地图定位工具类Util，实现定位功能的模块化、标准化和易用性。

---

## 目录
1. [准备工作](#1-准备工作)
2. [基础封装](#2-基础封装)
3. [定位功能实现](#3-定位功能实现)
4. [回调机制设计](#4-回调机制设计)
5. [异常处理](#5-异常处理)
6. [性能优化](#6-性能优化)
7. [完整工具类代码](#7-完整工具类代码)
8. [使用示例](#8-使用示例)
9. [常见问题解决](#9-常见问题解决)
10. [扩展功能](#10-扩展功能)

---

## 1. 准备工作

### 1.1 申请高德开发者账号
访问[高德开放平台](https://lbs.amap.com/)注册账号，创建应用并获取API Key。

### 1.2 配置Android项目
```gradle
// build.gradle(Module)
dependencies {
    implementation 'com.amap.api:location:latest.integration'
    implementation 'com.amap.api:map2d:latest.integration'
}

// AndroidManifest.xml
<manifest>
    <application>
        <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="您的API_KEY"/>
        
        <!-- 必要权限 -->
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
        <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
        <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
        <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
        <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
        <uses-permission android:name="android.permission.INTERNET"/>
    </application>
</manifest>

1.3 动态权限申请

Android 6.0+需要动态申请定位权限：

public class PermissionUtil {
    public static boolean checkLocationPermission(Activity activity) {
        return ContextCompat.checkSelfPermission(activity, 
                Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED;
    }
    
    public static void requestLocationPermission(Activity activity, int requestCode) {
        ActivityCompat.requestPermissions(activity,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 
                requestCode);
    }
}

2. 基础封装

2.1 创建定位工具类框架

public class AMapLocationUtil {
    private static final String TAG = "AMapLocationUtil";
    
    // 高德定位客户端
    private AMapLocationClient mLocationClient;
    private AMapLocationClientOption mLocationOption;
    
    // 单例模式
    private static volatile AMapLocationUtil instance;
    
    public static AMapLocationUtil getInstance(Context context) {
        if (instance == null) {
            synchronized (AMapLocationUtil.class) {
                if (instance == null) {
                    instance = new AMapLocationUtil(context.getApplicationContext());
                }
            }
        }
        return instance;
    }
    
    private AMapLocationUtil(Context context) {
        initLocation(context);
    }
    
    private void initLocation(Context context) {
        // 初始化定位客户端
        try {
            mLocationClient = new AMapLocationClient(context);
            mLocationOption = getDefaultOption();
            mLocationClient.setLocationOption(mLocationOption);
        } catch (Exception e) {
            Log.e(TAG, "定位初始化失败", e);
        }
    }
    
    private AMapLocationClientOption getDefaultOption() {
        AMapLocationClientOption option = new AMapLocationClientOption();
        option.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
        option.setGpsFirst(true);
        option.setHttpTimeOut(30000);
        option.setInterval(2000);
        option.setNeedAddress(true);
        option.setOnceLocation(false);
        option.setOnceLocationLatest(false);
        option.setMockEnable(false);
        option.setSensorEnable(false);
        option.setWifiScan(true);
        option.setLocationCacheEnable(true);
        return option;
    }
}

3. 定位功能实现

3.1 基本定位方法

// 在AMapLocationUtil类中添加
public void startLocation() {
    if (mLocationClient != null) {
        mLocationClient.startLocation();
    }
}

public void stopLocation() {
    if (mLocationClient != null) {
        mLocationClient.stopLocation();
    }
}

public void destroyLocation() {
    if (mLocationClient != null) {
        mLocationClient.onDestroy();
        mLocationClient = null;
        mLocationOption = null;
    }
    instance = null;
}

3.2 定位参数配置

public void setLocationOption(AMapLocationClientOption option) {
    if (mLocationClient != null && option != null) {
        mLocationOption = option;
        mLocationClient.setLocationOption(option);
    }
}

public void setOnceLocation(boolean isOnce) {
    if (mLocationOption != null) {
        mLocationOption.setOnceLocation(isOnce);
        mLocationClient.setLocationOption(mLocationOption);
    }
}

public void setInterval(long interval) {
    if (mLocationOption != null) {
        mLocationOption.setInterval(interval);
        mLocationClient.setLocationOption(mLocationOption);
    }
}

4. 回调机制设计

4.1 定义定位监听接口

public interface LocationListener {
    void onSuccess(AMapLocation location);  // 定位成功
    void onFailure(int errorCode, String errorMsg);  // 定位失败
    void onStatusChanged(String provider, int status, Bundle extras); // 状态变化
}

// 在AMapLocationUtil中添加
private LocationListener mLocationListener;

public void setLocationListener(LocationListener listener) {
    this.mLocationListener = listener;
    registerLocationListener();
}

private void registerLocationListener() {
    if (mLocationClient != null) {
        mLocationClient.setLocationListener(new AMapLocationListener() {
            @Override
            public void onLocationChanged(AMapLocation aMapLocation) {
                if (mLocationListener != null) {
                    if (aMapLocation != null && aMapLocation.getErrorCode() == 0) {
                        mLocationListener.onSuccess(aMapLocation);
                    } else {
                        mLocationListener.onFailure(
                            aMapLocation != null ? aMapLocation.getErrorCode() : -1,
                            aMapLocation != null ? aMapLocation.getErrorInfo() : "未知错误"
                        );
                    }
                }
            }
        });
    }
}

4.2 定位结果解析方法

public static String parseLocation(AMapLocation location) {
    if (location == null) return "定位失败";
    
    StringBuilder sb = new StringBuilder();
    sb.append("经度: ").append(location.getLongitude()).append("\n");
    sb.append("纬度: ").append(location.getLatitude()).append("\n");
    sb.append("精度: ").append(location.getAccuracy()).append("米\n");
    sb.append("地址: ").append(location.getAddress()).append("\n");
    sb.append("国家: ").append(location.getCountry()).append("\n");
    sb.append("省份: ").append(location.getProvince()).append("\n");
    sb.append("城市: ").append(location.getCity()).append("\n");
    sb.append("区县: ").append(location.getDistrict()).append("\n");
    sb.append("街道: ").append(location.getStreet()).append("\n");
    sb.append("门牌: ").append(location.getStreetNum()).append("\n");
    sb.append("城市编码: ").append(location.getCityCode()).append("\n");
    sb.append("区域编码: ").append(location.getAdCode()).append("\n");
    sb.append("定位时间: ").append(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")
            .format(new Date(location.getTime())));
    
    return sb.toString();
}

5. 异常处理

5.1 错误码处理

public static String getErrorInfo(int errorCode) {
    switch (errorCode) {
        case 0: return "定位成功";
        case 1: return "一些重要参数为空";
        case 2: return "定位失败，请检查网络连接";
        case 3: return "定位失败，请检查GPS或网络状态";
        case 4: return "定位结果被模拟";
        case 5: return "定位失败，无法获取有效定位依据";
        case 6: return "定位服务返回定位失败";
        case 7: return "KEY错误";
        case 8: return "Android定位权限被拒绝";
        case 9: return "初始化定位服务失败";
        case 10: return "定位服务启动失败";
        case 11: return "定位客户端启动失败";
        case 12: return "定位失败，请检查手机时间设置";
        case 13: return "定位失败，请插入SIM卡或检查网络";
        case 14: return "定位失败，请检查网络权限";
        case 15: return "定位失败，请重新启动定位";
        case 16: return "定位失败，请检查定位SDK版本";
        case 18: return "定位失败，请重新授权";
        default: return "未知错误";
    }
}

5.2 健壮性增强

// 在startLocation方法中添加检查
public void startLocation() {
    if (mLocationClient == null) {
        Log.e(TAG, "定位客户端未初始化");
        if (mLocationListener != null) {
            mLocationListener.onFailure(-2, "定位客户端未初始化");
        }
        return;
    }
    
    try {
        mLocationClient.startLocation();
    } catch (Exception e) {
        Log.e(TAG, "启动定位失败", e);
        if (mLocationListener != null) {
            mLocationListener.onFailure(-3, "启动定位异常: " + e.getMessage());
        }
    }
}

6. 性能优化

6.1 定位模式选择

public enum LocationMode {
    BATTERY_SAVING(AMapLocationClientOption.AMapLocationMode.Battery_Saving),
    DEVICE_SENSORS(AMapLocationClientOption.AMapLocationMode.Device_Sensors),
    HIGHT_ACCURACY(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
    
    private AMapLocationClientOption.AMapLocationMode mode;
    
    LocationMode(AMapLocationClientOption.AMapLocationMode mode) {
        this.mode = mode;
    }
}

public void setLocationMode(LocationMode mode) {
    if (mLocationOption != null) {
        mLocationOption.setLocationMode(mode.mode);
        mLocationClient.setLocationOption(mLocationOption);
    }
}

6.2 缓存策略优化

public void enableCache(boolean enable, long expireTime) {
    if (mLocationOption != null) {
        mLocationOption.setLocationCacheEnable(enable);
        if (enable) {
            mLocationOption.setHttpTimeOut(expireTime);
        }
        mLocationClient.setLocationOption(mLocationOption);
    }
}

7. 完整工具类代码

（因篇幅限制，此处展示核心代码结构，完整代码需包含以上所有方法实现）

8. 使用示例

8.1 基础使用

AMapLocationUtil.getInstance(context)
    .setLocationListener(new LocationListener() {
        @Override
        public void onSuccess(AMapLocation location) {
            String info = AMapLocationUtil.parseLocation(location);
            Log.d("Location", info);
        }
        
        @Override
        public void onFailure(int errorCode, String errorMsg) {
            Toast.makeText(context, 
                "定位失败: " + AMapLocationUtil.getErrorInfo(errorCode), 
                Toast.LENGTH_SHORT).show();
        }
    })
    .startLocation();

8.2 高级配置

AMapLocationClientOption option = new AMapLocationClientOption();
option.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
option.setOnceLocation(true);
option.setNeedAddress(true);

AMapLocationUtil.getInstance(context)
    .setLocationOption(option)
    .setLocationListener(...)
    .startLocation();

9. 常见问题解决

9.1 定位失败排查流程

检查API Key配置是否正确
验证网络连接是否正常
确认定位权限已授权
检查设备GPS是否开启
查看错误码和错误信息
测试不同定位模式

9.2 耗电优化建议

根据场景选择合适的定位模式
合理设置定位间隔
及时停止不需要的定位
使用缓存定位结果
考虑使用最后一次已知位置

10. 扩展功能

10.1 地理围栏功能

public void addGeoFence(String id, double latitude, double longitude, 
        float radius, long expiration) {
    if (mLocationClient != null) {
        mLocationClient.addGeoFence(
            new GeoFence.Builder()
                .setCustomId(id)
                .setRoundArea(latitude, longitude, radius)
                .setExpirationDutation(expiration)
                .build(),
            GeoFenceClient.GEOFENCE_IN | GeoFenceClient.GEOFENCE_OUT,
            new GeoFenceListener() {
                // 实现围栏触发回调
            }
        );
    }
}

10.2 轨迹记录功能

public void startTrackRecord() {
    if (mLocationClient != null) {
        mLocationClient.startAssistantLocation();
    }
}

public List<AMapLocation> getTrackPoints() {
    return mLocationClient != null ? 
        mLocationClient.getAssistantLocations() : null;
}

结语

本文详细介绍了高德地图定位SDK的封装方法，通过工具类的方式将复杂的位置服务功能简化为几个易用的API接口。良好的封装不仅能提高开发效率，还能增强代码的可维护性和稳定性。建议根据实际项目需求进行适当调整和扩展。

注意：实际开发中请遵循高德地图官方文档，及时更新SDK版本，并注意用户隐私保护相关法律法规。 “`

（注：本文实际字数约为4500字，要达到9350字需要进一步扩展每个章节的详细说明、原理分析、更多代码示例、性能对比数据、实际案例分析等内容。受限于回答篇幅，这里展示了核心框架和关键实现。）