GPS英文是Global Positioning System 全球定位系统的简称。

Android为GPS功能支持专门提供了一个LocationManager,位置管理器。全部GPS定位相关的服务、对象都将由该对象产生。


获取LocationManager实例:
LocationManager lm = (LocationManager)getSystemService (Context.LOCATION_SERVICE)

 

三个核心API:LocationManager、LocationProvider、Location

 

LocationManager提供例如以下方法:

boolean addGpsStatusListener(GpsStatus.Listener listener):加入一个监听GPS状态的监听器;

void addProximityAlert(double latitude,double longitude,float radius,long expiration,PendingIntent intent):加入一个临近警告;

List getAllProviders():获取全部的LocationProvider列表;
String getBestProvider(Criteria criteria,boolean enabledOnly):依据制定条件返回最优的LocationProvider对象。

GpsStatus getGpsStatus(GpsStatus status):获取GPS状态;

Location getLastKnownLocation(String provider):依据LocationProvider获取近期一次已知的Location;

LocationProvider getProvider(String name):依据名称来获取LocationProvider;

List getProviders(Criteria criteria,boolean enabledOnly):依据制定条件获取满足条件的所有LocationProvier的名称;
List getProviders(boolean enabledOnly):获取全部可用的LocationProvider;
boolean isProviderEnabled(String provider):推断制定名称的LocationProvider是否可用。

void removeGpsStatusListener(GpsStatus.Listener listener):删除GPS状态监听器。

void removeProximityAlert(PendingIntent intent):删除一个趋近警告。

void requestLocationUpdates(String provider,long minTime,float minDistance,PendingIntent intent):通过指定的LocationProvider周期性获取定位信息。并通过Intent启动对应的组件;

void requestLocationUpdates(String provider,long minTime,float minDistance,LcoationListener listener):通过指定的LocationProvider周期性的获取定位信息。并触发listener相应的触发器。

 

LocationProvider类

定位组件的抽象标识,通过它能够获取定位的相关信息。

提供例如以下经常用法:

String getName():返回该LocationProvider的名称;

int getAccuracy():返回该LocationProvider的精度;

int getPowerRequirement():返回该LocationProvider的电源需求;

boolean hasMonetaryCost():返回LocationProvider是收费还是免费;

boolean meetsCriteria(Criteria criteria):推断该LocationProvider是否满足Criteria条件。

boolean requiresCell():推断该LocationProvider是否须要訪问网路基站;

boolean requiresNetword():推断该LocationProvider是否须要网路数据;

boolean requiresStatellite():推断该LocationProvider是否须要訪问卫星的定位系统。

boolean supportsAltitude():推断该LocationProvider是否支持高度信息;

boolean supportsBearing():推断该LocationProvider是否支持方向信息;

boolean supportsSpeed():推断该LocationProvider是否支持速度信息;


LocationListener:位置监听器,监听位置变化,监听设备开关与状态

 

Location类

代表位置信息的抽象类;

提供例如以下方法来获取定位信息:

float getAccuracy():获取定位信息的精度。

double getAltitude():获取定位信息的高度;

float getBearing():获取定位信息的方向;

double getLatitude():获取定位信息的经度。

double getLongitude():获取定位信息的纬度;

String getProvider():获取提供该定位信息的LocationProvider;

float getSpeed():获取定位信息的速度;

boolean hasAccuracy():推断该定位信息是否有经度信息。

boolean hasAltitude():推断定位信息是否有高度信息;

boolean hasBearing():推断定位信息是否有方向信息;

boolean hasSpeed():推断定位信息是否有速度信息;

 

 

 


LocationListener:位置监听器,监听位置变化。监听设备开关与状态

 

步骤:
1.获取系统的LocationManager对象
2.使用LocationManager,通过指定LocationProvider来获取定位信息,定位信息由Location对象来表示
3.从Location对象中获取定位信息

 

 

以下是几个样例:

1.获取全部可用的LocationProvider:

布局文件:

 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.allproviderstest.AllProvidersTest" >

    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/providerList" />

    <ListView
        android:id="@+id/providers"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent" >
    </ListView>

</LinearLayout>


 

Activity:

 

public class AllProvidersTest extends Activity {

	ListView providers;
	LocationManager lm;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_all_providers_test);
		providers = (ListView) findViewById(R.id.providers);
		lm = (LocationManager) getSystemService(Context.LOCATION_SERVICE);

		List<String> providerNames = lm.getAllProviders();
		ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
				android.R.layout.simple_list_item_1, providerNames);
		
		providers.setAdapter(adapter);
	}
}

 


模拟器中全部可用的LocationProvider有两个:
passive:由LocationProvider.PASSIVE_PROVIDER常量表示
gps:由LocationProvider.GPS_PROVIDER常量表示。

代表通过GPS获取定位信息的LocationProvider对象

另一个名为network的LocationProvider,由LocationProvider.NETWORK_PROVIDER常量表示。
代表通过移动通信网络获取定位信息的LocationProvider对象。

 

 

2.通过名称来获取指定的LocationProvider:

 

比如:

获取基于GPS的LocationProvider:
LocationProvider locProvider = lm.getProvider(LocationManager.GPS_PROVIDER)

 

依据Criteria获得LocationProvider:

 

 

布局文件:

 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.freeproviderstest.FreeProvidersTest" >

    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/providerList" />

    <ListView
        android:id="@+id/providers"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent" />

</LinearLayout>


 

Activity:

 

public class FreeProvidersTest extends Activity {

	ListView providers;
	LocationManager lm;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_free_providers_test);

		providers = (ListView) findViewById(R.id.providers);
		lm = (LocationManager) getSystemService(Context.LOCATION_SERVICE);

		// 创建一个LocationProvider的过滤条件
		Criteria cri = new Criteria();
		// 设置要求LocationProvider必须是免费的。
		cri.setCostAllowed(false);
		// 设置要求LocationProvider能提供高度信息
		cri.setAltitudeRequired(true);
		// 设置要求LocationProvider能提供方向信息
		cri.setBearingRequired(true);
		// 获取系统全部复合条件的LocationProvider的名称
		List<String> providerNames = lm.getProviders(cri, false);
		System.out.println(providerNames.size());
		ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
				android.R.layout.simple_list_item_1, providerNames);
		// 使用ListView来显示全部可用的LocationProvider
		providers.setAdapter(adapter);
	}
}


 

 

3.
获取定位数据:


通过模拟器发送GPS信息:

启动模拟器之后,在DDMS下的Emulator Control 面板就可以发送GPS定位信息。

 

布局文件:

 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.locationtest.LocationTest" >

    <EditText
        android:id="@+id/show"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:cursorVisible="false"
        android:editable="false" />

</LinearLayout>


 

Activity:

public class LocationTest extends Activity {

	// 定义LocationManager对象
	LocationManager locManager;
	// 定义程序界面中的EditText组件
	EditText show;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_location_test);

		show = (EditText) findViewById(R.id.show);
		locManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
		// 从GPS获取近期的近期的定位信息
		Location location = locManager
				.getLastKnownLocation(LocationManager.GPS_PROVIDER);
		// 使用location依据EditText的显示
		updateView(location);// 设置每3秒获取一次GPS的定位信息
		locManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 3000,
				8, new LocationListener() // ①
				{
					@Override
					public void onLocationChanged(Location location) {
						// 当GPS定位信息发生改变时,更新位置
						updateView(location);
					}

					@Override
					public void onProviderDisabled(String provider) {
						updateView(null);
					}

					@Override
					public void onProviderEnabled(String provider) {
						// 当GPS LocationProvider可用时。更新位置
						updateView(locManager.getLastKnownLocation(provider));
					}

					@Override
					public void onStatusChanged(String provider, int status,
							Bundle extras) {
					}
				});
	}

	// 更新EditText中显示的内容
	public void updateView(Location newLocation) {
		if (newLocation != null) {
			StringBuilder sb = new StringBuilder();
			sb.append("实时的位置信息:\n");
			sb.append("经度:");
			sb.append(newLocation.getLongitude());
			sb.append("\n纬度:");
			sb.append(newLocation.getLatitude());
			sb.append("\n高度:");
			sb.append(newLocation.getAltitude());
			sb.append("\n速度:");
			sb.append(newLocation.getSpeed());
			sb.append("\n方向:");
			sb.append(newLocation.getBearing());
			show.setText(sb.toString());
		} else {
			// 假设传入的Location对象为空则清空EditText
			show.setText("");
		}
	}
}



 

 

4.
临近警告:
通过LocationManager.addProximityAlert(double latitude,double longitude , float radius , long expiration ,PendingIntent intent)加入一个临近警告

參数:

latitude:指定固定点的经度
longitude:指定固定点的纬度
radius:半径长度
expiration:该參数指定经过多少毫秒后该临近警告就会过期失效
intent:该參数指定临近该固定点时出发该intent相应的组件。


 

布局文件:

 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.proximitytest.ProximityTest" >

    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/hello" />

</LinearLayout>


 

Activity:

 

public class ProximityTest extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_proximity_test);
		// 定位服务常量
				String locService = Context.LOCATION_SERVICE;
				// 定位服务管理器实例
				LocationManager locationManager;
				// 通过getSystemService方法获得LocationManager实例
				locationManager = (LocationManager) getSystemService(locService);
				// 定义山东淄博的大致经度、纬度
				double longitude = 117.3;
				double latitude = 36.5;
				// 定义半径(5公里)
				float radius = 5000;
				// 定义Intent
				Intent intent = new Intent(this, ProximityAlertReciever.class);
				// 将Intent包装成PendingIntent
				PendingIntent pi = PendingIntent.getBroadcast(this, -1, intent, 0);
				// 加入临近警告
				locationManager.addProximityAlert(latitude, longitude, radius, -1, pi);
	}
}


 

ProximityAlertReciever:

 

public class ProximityAlertReciever extends BroadcastReceiver {

	@Override
	public void onReceive(Context context, Intent intent) {
		// 获取是否为进入指定区域
		boolean isEnter = intent.getBooleanExtra(
				LocationManager.KEY_PROXIMITY_ENTERING, false);
		if (isEnter) {
			// 显示提示信息
			Toast.makeText(context, "您已经进入广州天河区", Toast.LENGTH_LONG).show();
		} else {
			// 显示提示信息
			Toast.makeText(context, "您已经离开广州天河区", Toast.LENGTH_LONG).show();
		}
	}
}