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);//位置狀態發生改變
}
}