Android封裝高德地圖定位工具類Util的詳細步驟

Posted on by

前提

每次做的項目中或者維護公司之前舊項目的時候，都會用到通過定位來獲取經緯度,我們都知道，Android官方也提供瞭獲取經緯度的方法，但是不太好使，所以就用瞭高德地圖的API，不能每次用的時候都要寫一堆代碼，效率挺低的，於是就想著，封裝成一個工具類，方便調用，為以後的項目，不管是管理方面還是查找方面都簡潔瞭不少。

第一步、去官網創建高德Key

官網地址：lbs.amap.com/product/loc…

帶*號的填完後，點擊提交，獲取SHA1值如下（通過代碼獲取的）或者通過命令行獲取，兩者都行。

Android studio代碼獲取SHA1值

調用 Log.e("-->打印sha1 ","${sha1(this)}")
fun sha1(context: Context): String {
        try {
            val info: PackageInfo = context.packageManager.getPackageInfo(
                    context.packageName, PackageManager.GET_SIGNATURES)
            val cert: ByteArray = info.signatures.get(0).toByteArray()
            val md: MessageDigest = MessageDigest.getInstance("SHA1")
            val publicKey: ByteArray = md.digest(cert)
            val hexString = StringBuffer()
            for (i in publicKey.indices) {
                val appendString = Integer.toHexString(0xFF and publicKey[i].toInt())
                        .toUpperCase(Locale.US)
                if (appendString.length == 1) hexString.append("0")
                hexString.append(appendString)
                hexString.append(":")
            }
            val result = hexString.toString()
            return result.substring(0, result.length - 1)
        } catch (e: PackageManager.NameNotFoundException) {
            e.printStackTrace()
        } catch (e: NoSuchAlgorithmException) {
            e.printStackTrace()
        }
        return ""
    }

第二步  通過Gradle集成SDK（方便）：

1、在Project的build.gradle文件中配置repositories，添加maven或jcenter倉庫地址：

allprojects { repositories { jcenter() // 或者 mavenCentral() } }

2、在主工程的build.gradle文件配置dependencies

   //定位
   implementation 'com.amap.api:location:latest.integration'

第三步    配置參數

第1步，配置AndroidManifest.xml

請在application標簽中聲明service組件,每個app擁有自己單獨的定位service。

 <!-- 定位需要的服務 使用2.0的定位需要加上這個 -->
        <service android:name="com.amap.api.location.APSService" >
        </service>

第2步，聲明權限 如果項目中已有其中的權限，那就不用加瞭

<!--用於進行網絡定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission> <!--用於訪問GPS定位--> 
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<!--用於獲取運營商信息，用於支持提供運營商信息相關的接口--> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<!--用於訪問wifi網絡信息，wifi信息會用於進行網絡定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<!--用於獲取wifi的獲取權限，wifi信息會用來進行網絡定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<!--用於訪問網絡，網絡定位需要上網-->
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<!--用於讀取手機當前的狀態-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<!--用於寫入緩存數據到擴展存儲卡-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> <!--用於申請調用A-GPS模塊-->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"></uses-permission>

第3步，設置高德Key:

<meta-data android:name="com.amap.api.v2.apikey" android:value="key">//開發者申請的key           </meta-data>

第四步   獲取定位數據

在需要獲取經緯度的頁面調用如下代碼:

    private var amapLocationUtil: AmapLocationUtil? = null
    
    
     fun initLocationOption() {
        if (null == amapLocationUtil) {
            amapLocationUtil = AmapLocationUtil(CommApplication.getApplication())
        }
        amapLocationUtil!!.initLocation()
        amapLocationUtil!!.startLocation()
        amapLocationUtil!!.setOnCallBackListener { longitude, latitude, location, isSucdess, address ->
       //Log.e("--->", "longitude" + longitude + "\n" + "latitude" + latitude + "\n" + "isSucdess" + isSucdess + "\n" + "address" + address);
       //Log.e("--->",location.getProvince()+ "\n" +location.getCity()+"\n"+location.getDistrict());
        //isSucdess    true  定位成功   false  失敗
            if (isSucdess) {
               
            } else {
            //定位失敗，重試定位
            amapLocationUtil!!.startLocation()
            }
        }
    }

註意：如果是在當前Activity實例化的，不要忘瞭銷毀

override fun onDestroy() {
        super.onDestroy()
        if (amapLocationUtil != null) {
            amapLocationUtil!!.destroyLocation()
        }
    }

看到瞭代碼裡調用瞭AmapLocationUtil，這個是我封裝好的一個工具類，方便調用，代碼如下：

/**
 *
 * Created by JasonYin
 * Description:封裝高德地圖Util
 *
 */
class AmapLocationUtil(private val mContext: Context) {
    private var locationClient: AMapLocationClient? = null
    private var locationOption: AMapLocationClientOption? = null
    private var mOnCallBackListener: onCallBackListener? = null
    /**
     * 初始化定位
     */
    fun initLocation() { //初始化client
        if (null == locationClient) {
            locationClient = AMapLocationClient(mContext)
        }
        locationOption = defaultOption
        //設置定位參數
        locationClient!!.setLocationOption(locationOption)
        // 設置定位監聽
        locationClient!!.setLocationListener(locationListener)
    }//可選，設置定位模式，可選的模式有高精度、僅設備、僅網絡。默認為高精度模式
    //可選，設置是否gps優先，隻在高精度模式下有效。默認關閉
    //可選，設置網絡請求超時時間。默認為30秒。在僅設備模式下無效
    //可選，設置定位間隔。默認為2秒
    //可選，設置是否返回逆地理地址信息。默認是true
    //可選，設置是否單次定位。默認是false
    //可選，設置是否等待wifi刷新，默認為false.如果設置為true,會自動變為單次定位，持續定位時不要使用
    //可選， 設置網絡請求的協議。可選HTTP或者HTTPS。默認為HTTP
    //可選，設置是否使用傳感器。默認是false
    //可選，設置是否開啟wifi掃描。默認為true，如果設置為false會同時停止主動刷新，停止以後完全依賴於系統刷新，定位位置可能存在誤差
    //可選，設置是否使用緩存定位，默認為true
//可選，設置定位模式，可選的模式有高精度、僅設備、僅網絡。默認為高精度模式
    //可選，設置是否gps優先，隻在高精度模式下有效。默認關閉

    //如果網絡可用就選擇高精度
    private val defaultOption: AMapLocationClientOption
        private get() {
            val mOption = AMapLocationClientOption()
            //如果網絡可用就選擇高精度
            if (NetworkUtils.isConnected()) { //可選，設置定位模式，可選的模式有高精度、僅設備、僅網絡。默認為高精度模式
                mOption.locationMode = AMapLocationClientOption.AMapLocationMode.Hight_Accuracy
                mOption.isGpsFirst = true //可選，設置是否gps優先，隻在高精度模式下有效。默認關閉
            } else {
                mOption.locationMode = AMapLocationClientOption.AMapLocationMode.Device_Sensors //可選，設置定位模式，可選的模式有高精度、僅設備、僅網絡。默認為高精度模式
                mOption.isGpsFirst = true //可選，設置是否gps優先，隻在高精度模式下有效。默認關閉
            }
            mOption.httpTimeOut = 30000 //可選，設置網絡請求超時時間。默認為30秒。在僅設備模式下無效
            mOption.interval = 2000 //可選，設置定位間隔。默認為2秒
            mOption.isNeedAddress = true //可選，設置是否返回逆地理地址信息。默認是true
            mOption.isOnceLocation = false //可選，設置是否單次定位。默認是false
            mOption.isOnceLocationLatest = false //可選，設置是否等待wifi刷新，默認為false.如果設置為true,會自動變為單次定位，持續定位時不要使用
            AMapLocationClientOption.setLocationProtocol(AMapLocationClientOption.AMapLocationProtocol.HTTP) //可選， 設置網絡請求的協議。可選HTTP或者HTTPS。默認為HTTP
            mOption.isSensorEnable = true //可選，設置是否使用傳感器。默認是false
            mOption.isWifiScan = true //可選，設置是否開啟wifi掃描。默認為true，如果設置為false會同時停止主動刷新，停止以後完全依賴於系統刷新，定位位置可能存在誤差
            mOption.isLocationCacheEnable = true //可選，設置是否使用緩存定位，默認為true
            return mOption
        }

    var locationListener = AMapLocationListener { location ->
        val sb = StringBuilder()
        if (null != location) { //errCode等於0代表定位成功，其他的為定位失敗，具體的可以參照官網定位錯誤碼說明
            if (location.errorCode == 0) {
                longitude = location.longitude
                latitude = location.latitude
                val district = location.district
                locationSuccess(longitude, latitude, true, location, district)
                //定位成功，停止定位：如果實時定位，就把stopLocation()關閉
                stopLocation()
            } else { //定位失敗
//                    sb.append("定位失敗" + "\n");
//                    sb.append("錯誤碼:" + location.getErrorCode() + "\n");
//                    sb.append("錯誤信息:" + location.getErrorInfo() + "\n");
//                    sb.append("錯誤描述:" + location.getLocationDetail() + "\n");
//                    Log.e("---> 定位失敗", sb.toString());
                LocationFarile(false, location)
            }
        } else {
            LocationFarile(false, location)
        }
    }

    private fun LocationFarile(isSucdess: Boolean, location: AMapLocation) {
        if (mOnCallBackListener != null) {
            mOnCallBackListener!!.onCallBack(0.0, 0.0, location, false, "")
        }
    }

    fun locationSuccess(longitude: Double, latitude: Double, isSucdess: Boolean, location: AMapLocation?, address: String?) {
        if (mOnCallBackListener != null) {
            mOnCallBackListener!!.onCallBack(longitude, latitude, location, true, address)
        }
    }

    fun setOnCallBackListener(listener: onCallBackListener?) {
        mOnCallBackListener = listener
    }

    interface onCallBackListener {
        fun onCallBack(longitude: Double, latitude: Double, location: AMapLocation?, isSucdess: Boolean, address: String?)
    }

    /**
     * 開始定位
     */
    fun startLocation() {
        locationClient!!.startLocation()
    }

    /**
     * 停止定位
     */
    fun stopLocation() {
        locationClient!!.stopLocation()
    }

    /**
     * 銷毀定位
     */
    fun destroyLocation() {
        if (null != locationClient) {
            /**
             * 如果AMapLocationClient是在當前Activity實例化的，
             * 在Activity的onDestroy中一定要執行AMapLocationClient的onDestroy
             */
            locationClient!!.onDestroy()
            locationClient = null
            locationOption = null
        }
    }

    companion object {
        var longitude = 0.0
        var latitude = 0.0
    }

}

總結

到此這篇關於Android封裝高德地圖定位工具類Util的文章就介紹到這瞭,更多相關Android封裝高德定位工具類內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：