高德定位

场景

AndroidStudio实现定位功能。

文档

步骤

准备

Key获取
高德Key获取之SHA1

SDK

• 下载
• 配置
  • libs
    
  • gradle（app）

    android {
        ......
        sourceSets {
            main {
                /*环信-没用默认jniLibs目录*/
                jniLibs.srcDirs = ['libs']
            }
        }
    }
    

清单文件

• 权限

• key

• 服务

代码

LocationKit

package widget.location.kit;

import android.app.Application;
import android.util.Log;

import com.amap.api.location.AMapLocation;
import com.amap.api.location.AMapLocationClient;
import com.amap.api.location.AMapLocationClientOption;
import com.zsp.utilone.datetime.DateUtils;

/**
 * Created on 2019/6/22.
 *
 * @author 郑少鹏
 * @desc 定位
 */
public class LocationKit {
    /**
     * DCL（Double Check Lock）式单例
     */
    private static LocationKit dclInstance;
    /**
     * 定位结果
     */
    public AMapLocation aMapLocationResult;
    /**
     * 定位客户端
     */
    private AMapLocationClient aMapLocationClient;
    /**
     * 定位客户端配置
     */
    private AMapLocationClientOption aMapLocationClientOption;

    /**
     * constructor
     *
     * @param application 应用
     */
    private LocationKit(Application application) {
        this.aMapLocationClient = new AMapLocationClient(application);
    }

    /**
     * DCL（Double Check Lock）获单例
     * 

     * 网上建议和使用最多。
     * 

     * 优点：
     * 构造函数private修饰（外部无法访）。
     * 用即调getInstanceByDcl()时才初始化。
     * static关键字修饰（静态变量，存于内存，仅一份数据）。
     * synchronized线程安全（多线程单例唯一性）。
     * 两次判空避多次同步。
     * 

     * 缺点：
     * {@link #dclInstance}、{@link #LocationKit(Application)}、getInstanceByDcl()因jvm允乱序执行。该三句代码顺序不定，或现DCL失效。
     * 步骤一：A线程执行getInstanceByDcl()时还没执行构造方法{@link #LocationKit(Application)}。
     * 步骤二：此时B线程调getInstanceByDcl()，因A已执行getInstanceByDcl()，故{@link #dclInstance}不为空就直获。
     * 步骤三：因B直获，而真实情况A线程构造方法还未执行，故{@link #dclInstance}为空。
     * 

     * 解决：
     * 此况概率较小。但为解决，Java1.6加volatile关键字避DCL方式失效。虽volatile消耗一些性能，但为DCL最佳写法。
     * 虽volatile使DCL方式完美，但没volatile关键字写法满足大部分情况。除非高并发运行或Java1.6前。
     *
     * @return 单例
     */
    public static LocationKit getInstanceByDcl(Application application) {
        if (dclInstance == null) {
            synchronized (LocationKit.class) {
                if (dclInstance == null) {
                    dclInstance = new LocationKit(application);
                }
            }
        }
        return dclInstance;
    }

    /**
     * 定位场景模式
     * 

     * 定位SDK v3.7.0+提供。
     * 选对应定位场景不自设AMapLocationClientOption参数值，SDK据场景自定。
     * 亦可于基础上自设，最后设参数值有效。
     * 

     * 默无场景。
     * 目前支持三种场景（签到、出行、运动）
     *
     * @param model 模式
     */
    public void positioningSceneModel(Model model) {
        aMapLocationClientOption = new AMapLocationClientOption();
        switch (model) {
            // 签到
            case SIGN_IN:
                aMapLocationClientOption.setLocationPurpose(AMapLocationClientOption.AMapLocationPurpose.SignIn);
                break;
            // 出行
            case TRANSPORT:
                aMapLocationClientOption.setLocationPurpose(AMapLocationClientOption.AMapLocationPurpose.Transport);
                break;
            // 运动
            case SPORT:
                aMapLocationClientOption.setLocationPurpose(AMapLocationClientOption.AMapLocationPurpose.Sport);
                break;
            default:
                break;
        }
        // 设场景模式后最好调stop后再调start保场景模式生效
        aMapLocationClient.stopLocation();
        aMapLocationClient.startLocation();
    }

    /**
     * 普通模式
     */
    public void commonModel() {
        aMapLocationClientOption();
        aMapLocationClient();
    }

    private void aMapLocationClientOption() {
        aMapLocationClientOption = new AMapLocationClientOption();
        // 高精度定位模式
        // 同时网络定位和GPS定位，优先返最高精度定位结果及对应地址描述信息
        aMapLocationClientOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
        // true定位SDK返近3s精度最高结果（默false）
        // true时setOnceLocation(boolean b)接口true，反不
        aMapLocationClientOption.setOnceLocationLatest(true);
        // 定位间隔最低1000ms（默2000ms）
        aMapLocationClientOption.setInterval(5000);
        // 返地址信息（默返）
        aMapLocationClientOption.setNeedAddress(true);
        // 允模拟位置（默true）
        aMapLocationClientOption.setMockEnable(true);
        // 超时建不低8000ms（默30000ms）
        aMapLocationClientOption.setHttpTimeOut(30000);
        // 关定位缓存机制
        // 开定位缓存于高精度模式和低功耗模式网络定位结果均生成本地缓存，不区分单次定位还是连续定位
        // 不缓存GPS定位结果
        aMapLocationClientOption.setLocationCacheEnable(false);
        // 强刷WIFI（默强）
        aMapLocationClientOption.setWifiScan(true);
        // 传感器
        aMapLocationClientOption.setSensorEnable(true);
    }

    private void aMapLocationClient() {
        // 定位回调监听
        aMapLocationClient.setLocationListener(aMapLocation -> {
            if (aMapLocation != null) {
                if (aMapLocation.getErrorCode() == 0) {
                    aMapLocationResult = aMapLocation;
                } else {
                    // 定位失败通错误码/信息确定原因，详见错误码表。
                    Log.e("AmapError", "location Error, ErrCode:"
                            + aMapLocation.getErrorCode() + ", errInfo:"
                            + aMapLocation.getErrorInfo());
                }
            }
        });
        // 设参数
        aMapLocationClient.setLocationOption(aMapLocationClientOption);
        // 启定位
        aMapLocationClient.startLocation();
    }

    /**
     * 定位结果
     *
     * @return 定位结果
     */
    public String locationResult() {
        if (null == aMapLocationResult) {
            return null;
        }
        StringBuilder stringBuilder = new StringBuilder();
        // 错误码0定位成功，否失败。详见错误码表。
        if (aMapLocationResult.getErrorCode() == 0) {
            stringBuilder.append("定位成功" + "\n");
            stringBuilder.append("定位类型：").append(aMapLocationResult.getLocationType()).append("\n");
            stringBuilder.append("经    度：").append(aMapLocationResult.getLongitude()).append("\n");
            stringBuilder.append("纬    度：").append(aMapLocationResult.getLatitude()).append("\n");
            stringBuilder.append("精    度：").append(aMapLocationResult.getAccuracy()).append("米").append("\n");
            stringBuilder.append("提 供 者：").append(aMapLocationResult.getProvider()).append("\n");
            stringBuilder.append("速    度：").append(aMapLocationResult.getSpeed()).append("米/秒").append("\n");
            stringBuilder.append("角    度：").append(aMapLocationResult.getBearing()).append("\n");
            // 当前提供定位服务卫星数
            stringBuilder.append("星    数：").append(aMapLocationResult.getSatellites()).append("\n");
            stringBuilder.append("国    家：").append(aMapLocationResult.getCountry()).append("\n");
            stringBuilder.append("省：").append(aMapLocationResult.getProvince()).append("\n");
            stringBuilder.append("市：").append(aMapLocationResult.getCity()).append("\n");
            stringBuilder.append("城市编码：").append(aMapLocationResult.getCityCode()).append("\n");
            stringBuilder.append("区：").append(aMapLocationResult.getDistrict()).append("\n");
            stringBuilder.append("区 域 码：").append(aMapLocationResult.getAdCode()).append("\n");
            stringBuilder.append("地    址：").append(aMapLocationResult.getAddress()).append("\n");
            stringBuilder.append("兴 趣 点：").append(aMapLocationResult.getPoiName()).append("\n");
            // 定位完成时间
            stringBuilder.append("定位时间：").append(DateUtils.formatUtc(aMapLocationResult.getTime(), "yyyy-MM-dd HH:mm:ss")).append("\n");
        } else {
            // 定位失败
            stringBuilder.append("定位失败" + "\n");
            stringBuilder.append("错 误 码：").append(aMapLocationResult.getErrorCode()).append("\n");
            stringBuilder.append("错误信息：").append(aMapLocationResult.getErrorInfo()).append("\n");
            stringBuilder.append("错误描述：").append(aMapLocationResult.getLocationDetail()).append("\n");
        }
        // 定位后回调时间
        stringBuilder.append("回调时间: ").append(DateUtils.formatUtc(System.currentTimeMillis(), "yyyy-MM-dd HH:mm:ss")).append("\n");
        return stringBuilder.toString();
    }

    /**
     * 停定位
     * 

     * 不销本地定位服务。
     */
    public void stopLocation() {
        aMapLocationClient.stopLocation();
    }

    /**
     * 销毁
     * 

     * 销定位客户端同销本地定位服务。
     * 销定位客户端后重开定位需重创一AMapLocationClient对象。
     */
    public void destroy() {
        aMapLocationClient.onDestroy();
    }

    public enum Model {
        /**
         * 签到
         */
        SIGN_IN,
        /**
         * 出行
         */
        TRANSPORT,
        /**
         * 运动
         */
        SPORT
    }
}

LocationInitConfigure

package widget.location.configure;

import android.app.Application;

import widget.location.kit.LocationKit;

/**
 * Created on 2019/7/1.
 *
 * @author 郑少鹏
 * @desc 定位初始化配置
 */
public class LocationInitConfigure {
    public static void initLocation(Application application) {
        LocationKit.getInstanceByDcl(application).commonModel();
    }
}

Application

@Override
public void onCreate() {  
    super.onCreate();
 	// 高德（定位）
    LocationInitConfigure.initLocation(this);       
}

Activity或Fragment

LocationKit.getInstanceByDcl(App.getInstance()).aMapLocationResult.getLongitude();
...

结果来源

分类

• 移动网络和WIFI关闭 检查网络是否畅通
• 移动网络开启，WIFI关闭 6 基站定位结果 单纯依赖移动、联通、电信等移动网络定位，精度500米-5000米
• WIFI打开，移动网络关闭 5 Wifi定位结果 网络定位，精度较高且较基站更好，5米－200米
• WIFI和移动网络打开 5 Wifi定位结果 网络定位，精度较高且较基站更好，5米－200米

其它

• 0 定位失败 通过AMapLocation.getErrorCode()获取错误码并参考错误码对照表进行问题排查
• 1 GPS定位结果 通过设备GPS定位模块返定位结果，精度较高，10米－100米左右
• 2 前次定位结果 网络定位请求低于1秒或两次定位间设备位置变化非常小时返回，设备位移通过传感器感知
• 4 缓存定位结果 返回一段时间前设备在同位置缓存网络定位结果
• 8 离线定位结果 -

注意

• 工具类中添监听前判断防添多监听致定位结果重复输出。如第一次定位输出一结果，第二次定位输出两结果，以此类推。
• 工具类destroy方法于应用退出即BaseAcitvity相应处调用。别处调用因全局仅一定位客户端对象（Application之OnCreate初始化）致定位异常。

问题

描述

定位客户端对象于Application之OnCreate初始，退程序销。再打开应用Application不执行onCreate致定位不可用。

解决

直于Activity或Fragment初始。