维智定位 SDK 集成

维智定位 SDK 集成

最近需要做一个 SDK 定位的项目，由于 APP 需在安卓应用商店上架，高德需付费，在网上搜到一家做互联网全域定位的维智科技，他们也提供设备定位 SDK，文档、支持还比较完善，个人在集成过程中遇到一些问题，分享给大家，避免走弯路。
下载定位 SDK
1.在AndroidManifest.xml 添加相前权限

<!--外部存储读取权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_LOCATION" />
<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.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<!--允许程序发现和配对蓝牙设备  -->
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- Needed only if your app targets Android 5.0 (API level 21) or higher. -->
<uses-feature android:name="android.hardware.location.gps" />

2.添加 Service

<!-- 必选-->
<service android:name="com.wayz.location.WzService"></service>

3.先声明

MapsInitializer.updatePrivacyShow(this, true, false)
MapsInitializer.updatePrivacyAgree(this, true)

4.初始化定位模式

private WzLocationClientOption option;

private fun initLocationClient() {
    option = WzLocationClientOption()
    // 回调间隔
    option.isFastLocation = false
    option.interval = 5000
    option.isLockScreenLocation = true
    option.isUsingSensor = true
    option.locationMode = WzLocationMode.HIGHT_ACCURACY
    option.setReportHost("")
    option.setOnceLocate(false)
    client = WzLocationClient(this@BasicLocContinuousActivity, option)
}

5.实现定位监听

class BasicLocContinuousActivity : AppCompatActivity(), WzLocationListener{
override fun onLocationReceived(location: WzLocation) {
         // 成功
}

    override fun onLocationError(exception: WzException) {
// 失败
    }
}

6.整体代码

/*
 * Copyright (C) 2017 GlobalEarth, Inc. All Rights Reserved.
 */
package com.example.sample

import android.os.Bundle
import android.view.View
import androidx.appcompat.app.AppCompatActivity
import com.wayz.location.*
import kotlinx.android.synthetic.main.activity_main.*
import pub.devrel.easypermissions.EasyPermissions

class BasicLocActivity : AppCompatActivity(), WzLocationListener, EasyPermissions.PermissionCallbacks {
    private lateinit var client: WzLocationClient
    private lateinit var option: WzLocationClientOption
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        location_btn.setOnClickListener {
            if(checkPermisson()) {
                tv.text = "正在定位..."
                tv.visibility = View.VISIBLE
                client?.startLocation(this@BasicLocActivity)
            } else {
                tv.text = "缺少权限..."
                tv.visibility = View.VISIBLE
            }
        }
        if(checkPermisson()) {
            initLocationClient()
        }
    }

    override fun onRequestPermissionsResult(
            requestCode: Int,
            permissions: Array<out String>,
            grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this)
    }

    private fun checkPermisson() : Boolean {
        if (!EasyPermissions.hasPermissions(this, *MyApp.permissions)) {
            EasyPermissions.requestPermissions(this, "需要申请如下权限", 1, *MyApp.permissions)
            return false
        } else {
            return true
        }
    }

    private fun initLocationClient() {
        option = WzLocationClientOption()
        // 回调间隔
        option.interval = 5000
        option.isFastLocation = false
        option.setOnceLocate(true)
        client = WzLocationClient(this@BasicLocActivity, option)
    }

    override fun onPermissionsDenied(requestCode: Int, perms: MutableList<String>) {
    }

    override fun onPermissionsGranted(requestCode: Int, perms: MutableList<String>) {
        initLocationClient()
    }

    override fun onLocationReceived(location: WzLocation) {
        if (location != null) {
            val stringBuilder = StringBuilder()
                    .append("Address:")
                    .append(location.address)
                    .append("\n").append("Accuracy:")
                    .append(location.accuracy)
                    .append("\n").append("Confidence:")
                    .append(location.confidence)
                    .append("\n").append("Longitude:")
                    .append(location.longitude)
                    .append("\n").append("Latitude:")
                    .append(location.latitude)
                    .append("\n").append("Altitude:")
                    .append(location.altitude)
                    .append("\n").append("Source:")
                    .append(location.source)
                    .append("\n")
            if (location.place != null) {
                stringBuilder.append("\nPlace:")
                stringBuilder.append(location.place.name)
            }
            val nearbyPlaces = location.nearbyPlaces
            if (nearbyPlaces != null && nearbyPlaces.size > 0) {
                stringBuilder.append("\n\nNearby:")
                for (nearbyPlace in nearbyPlaces) {
                    stringBuilder.append("\n${nearbyPlace.name}")
                }
            }
            tv.text = stringBuilder.toString()
        } else {
            tv.text = "数据为空"
        }
    }

    override fun onLocationError(exception: WzException) {
        tv.text = StringBuilder().append("数据异常：").append(exception.errorMessage).toString()
    }

    override fun onDestroy() {
        client?.onDestroy()
        super.onDestroy()
    }
}

注意事项：

1. 打包混淆，如 果 您 打 包 时 开 启 了 混 淆 建 议您在混淆规则中保留SDK在proguard-rules.pro 添加：

-keep class com.wayz.location.** {*;}
-dontwarn com.wayz.location.**

2. 如果您的应用 targetSdkVersion >= 23，则需要在调用SDK之前申请动态权限，否则在 Android 6.0 以上手机上运行可能会崩溃。
3. SDK 应用需要收集 WIFI 信息，如果运行在Android 6.0 以上手机上扫描 WIFI 信息需要打开 GPS 开关（位置服务选为高精度），如果您的应用不是系统应用，建议引导用户打开此开关，便于收集定位信息。
4. 在集成过程中，如果定位失败，首先检查是否添加相关权限，以及手机定位权限是否开启，还有手机系统日期时间是否正常，定位权限