[Android][工具類]LocationUtils

weixin_33728268發表於2017-03-19
import android.Manifest;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.location.Address;
import android.location.Criteria;
import android.location.Geocoder;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
import android.location.LocationProvider;
import android.os.Bundle;
import android.provider.Settings;
import android.support.v4.app.ActivityCompat;
import android.util.Log;

import java.io.IOException;
import java.util.List;
import java.util.Locale;

/**
 * 定位相關工具類
 * 如:判斷Gps是否可用,判斷定位是否可用,開啟Gps設定介面,註冊,登出,根據經緯度獲取地理位置,
 * 根據經緯度獲取所在國家,根據經緯度獲取所在地,根據經緯度獲取所在街道
 *
 */
public class LocationUtils {

    private static OnLocationChangeListener mListener;
    private static MyLocationListener myLocationListener;
    private static LocationManager mLocationManager;

    private LocationUtils() {
        throw new UnsupportedOperationException("u can't instantiate me...");
    }

    /**
     * 判斷Gps是否可用
     *
     * @return {@code true}: 是<br>{@code false}: 否
     */
    public static boolean isGpsEnabled(Context context) {
        LocationManager lm = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
        return lm.isProviderEnabled(LocationManager.GPS_PROVIDER);
    }

    /**
     * 判斷定位是否可用
     *
     * @return {@code true}: 是<br>{@code false}: 否
     */
    public static boolean isLocationEnabled(Context context) {
        LocationManager lm = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
        return lm.isProviderEnabled(LocationManager.NETWORK_PROVIDER) || lm.isProviderEnabled(LocationManager.GPS_PROVIDER);
    }

    /**
     * 開啟Gps設定介面
     */
    public static void openGpsSettings(Context context) {
        Intent intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        context.startActivity(intent);
    }

    /**
     * 註冊
     * <p>使用完記得呼叫{@link #unregister(Context context)}</p>
     * <p>需新增許可權 {@code <uses-permission android:name="android.permission.INTERNET"/>}</p>
     * <p>需新增許可權 {@code <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>}</p>
     * <p>需新增許可權 {@code <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>}</p>
     * <p>如果{@code minDistance}為0,則通過{@code minTime}來定時更新;</p>
     * <p>{@code minDistance}不為0,則以{@code minDistance}為準;</p>
     * <p>兩者都為0,則隨時重新整理。</p>
     *
     * @param minTime     位置資訊更新週期(單位:毫秒)
     * @param minDistance 位置變化最小距離:當位置距離變化超過此值時,將更新位置資訊(單位:米)
     * @param listener    位置重新整理的回撥介面
     * @return {@code true}: 初始化成功<br>{@code false}: 初始化失敗
     */
    public static boolean register(Context context, long minTime, long minDistance, OnLocationChangeListener listener) {
        if (listener == null) return false;
        mLocationManager = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
        mListener = listener;
        if (!isLocationEnabled(context)) {
            APPUtils.showToast(context, "無法定位,請開啟定位服務");
            return false;
        }
        String provider = mLocationManager.getBestProvider(getCriteria(), true);
        if (ActivityCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(context, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            return false;
        }
        Location location = mLocationManager.getLastKnownLocation(provider);
        if (location != null) listener.getLastKnownLocation(location);
        if (myLocationListener == null) myLocationListener = new MyLocationListener();
        mLocationManager.requestLocationUpdates(provider, minTime, minDistance, myLocationListener);
        return true;
    }


    /**
     * 登出
     * <p>使用{@link #register(Context context, long minTime, long minDistance, OnLocationChangeListener listener)}
     * 完記得呼叫此方法
     *
     * @param context 上下文
     */
    public static void unregister(Context context) {
        if (mLocationManager != null) {
            if (myLocationListener != null) {
                if (ActivityCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) !=
                        PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(
                        context, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
                    return;
                }
                mLocationManager.removeUpdates(myLocationListener);
                myLocationListener = null;
            }
            mLocationManager = null;
        }
    }

    /**
     * 設定定位引數
     *
     * @return {@link Criteria}
     */
    private static Criteria getCriteria() {
        Criteria criteria = new Criteria();
        //設定定位精確度 Criteria.ACCURACY_COARSE比較粗略,Criteria.ACCURACY_FINE則比較精細
        criteria.setAccuracy(Criteria.ACCURACY_FINE);
        //設定是否要求速度
        criteria.setSpeedRequired(false);
        // 設定是否允許運營商收費
        criteria.setCostAllowed(false);
        //設定是否需要方位資訊
        criteria.setBearingRequired(false);
        //設定是否需要海拔資訊
        criteria.setAltitudeRequired(false);
        // 設定對電源的需求
        criteria.setPowerRequirement(Criteria.POWER_LOW);
        return criteria;
    }

    /**
     * 根據經緯度獲取地理位置
     *
     * @param context   上下文
     * @param latitude  緯度
     * @param longitude 經度
     * @return {@link Address}
     */
    public static Address getAddress(Context context, double latitude, double longitude) {
        Geocoder geocoder = new Geocoder(context, Locale.getDefault());
        try {
            List<Address> addresses = geocoder.getFromLocation(latitude, longitude, 1);
            if (addresses.size() > 0) return addresses.get(0);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 根據經緯度獲取所在國家
     *
     * @param context   上下文
     * @param latitude  緯度
     * @param longitude 經度
     * @return 所在國家
     */
    public static String getCountryName(Context context, double latitude, double longitude) {
        Address address = getAddress(context, latitude, longitude);
        return address == null ? "unknown" : address.getCountryName();
    }

    /**
     * 根據經緯度獲取所在地
     *
     * @param context   上下文
     * @param latitude  緯度
     * @param longitude 經度
     * @return 所在地
     */
    public static String getLocality(Context context, double latitude, double longitude) {
        Address address = getAddress(context, latitude, longitude);
        return address == null ? "unknown" : address.getLocality();
    }

    /**
     * 根據經緯度獲取所在街道
     *
     * @param context   上下文
     * @param latitude  緯度
     * @param longitude 經度
     * @return 所在街道
     */
    public static String getStreet(Context context, double latitude, double longitude) {
        Address address = getAddress(context, latitude, longitude);
        return address == null ? "unknown" : address.getAddressLine(0);
    }

    private static class MyLocationListener
            implements LocationListener {
        /**
         * 當座標改變時觸發此函式,如果Provider傳進相同的座標,它就不會被觸發
         *
         * @param location 座標
         */
        @Override
        public void onLocationChanged(Location location) {
            if (mListener != null) {
                mListener.onLocationChanged(location);
            }
        }

        /**
         * provider的在可用、暫時不可用和無服務三個狀態直接切換時觸發此函式
         *
         * @param provider 提供者
         * @param status   狀態
         * @param extras   provider可選包
         */
        @Override
        public void onStatusChanged(String provider, int status, Bundle extras) {
            if (mListener != null) {
                mListener.onStatusChanged(provider, status, extras);
            }
            switch (status) {
                case LocationProvider.AVAILABLE:
                    Log.d("onStatusChanged", "當前GPS狀態為可見狀態");
                    break;
                case LocationProvider.OUT_OF_SERVICE:
                    Log.d("onStatusChanged", "當前GPS狀態為服務區外狀態");
                    break;
                case LocationProvider.TEMPORARILY_UNAVAILABLE:
                    Log.d("onStatusChanged", "當前GPS狀態為暫停服務狀態");
                    break;
            }
        }

        /**
         * provider被enable時觸發此函式,比如GPS被開啟
         */
        @Override
        public void onProviderEnabled(String provider) {
        }

        /**
         * provider被disable時觸發此函式,比如GPS被關閉
         */
        @Override
        public void onProviderDisabled(String provider) {
        }
    }

    public interface OnLocationChangeListener {

        /**
         * 獲取最後一次保留的座標
         *
         * @param location 座標
         */
        void getLastKnownLocation(Location location);

        /**
         * 當座標改變時觸發此函式,如果Provider傳進相同的座標,它就不會被觸發
         *
         * @param location 座標
         */
        void onLocationChanged(Location location);

        /**
         * provider的在可用、暫時不可用和無服務三個狀態直接切換時觸發此函式
         *
         * @param provider 提供者
         * @param status   狀態
         * @param extras   provider可選包
         */
        void onStatusChanged(String provider, int status, Bundle extras);//位置狀態發生改變
    }
}

相關文章