废话不多说,直接开始说说与实现Android定位有关的API吧。
这些API都在android.location包下,一共有三个接口和八个类。它们配合使用即可实现定位功能。
三个接口:
GpsStatus.Listener: 这是一个当GPS状态发生改变时,用来接收通知的接口。
GpsStatus.NmeaListener: 这是一个用来从GPS里接收Nmea-0183(为海用电子设备制定的标准格式)信息的接口。
LocationListener: 位置监听器,用于接收当位置信息发生改变时从LocationManager接收通知的接口。
八个类:
Address: 描述地址的类,比如:北京天安门
Criteria: 用于描述Location Provider标准的类,标准包括位置精度水平,电量消耗水平,是否获取海拔、方位信息,是否允许接收付费服务。
GeoCoder: 用于处理地理位置的编码。
GpsSatellite: 和GpsStatus联合使用,用于描述当前GPS卫星的状态。
GpsStatus: 和GpsStatus.Listener联合使用,用于描述当前GPS卫星的状态。
Location: 用于描述位置信息。
LocationManager: 通过此类获取和调用系统位置服务
LocationProvider: 用于描述Location Provider的抽象超类,一个LocationProvider应该能够周期性的报告当前设备的位置信息。
这里通过一个代码示例,演示一下如何实现定位。
首先,在AndroidManifest.xml清单文件里需要加入ACCESS_FINE_LOCATION权限
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>其次,实现代码如下:
package com.test;
import java.io.IOException;
import java.util.List;
import android.app.Activity;
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.os.Bundle;
import android.util.Log;
import android.widget.Toast;
public class MainActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
//获取到LocationManager对象
LocationManager locationManager = (LocationManager) getSystemService(LOCATION_SERVICE);
//创建一个Criteria对象
Criteria criteria = new Criteria();
//设置粗略精确度
criteria.setAccuracy(Criteria.ACCURACY_COARSE);
//设置是否需要返回海拔信息
criteria.setAltitudeRequired(false);
//设置是否需要返回方位信息
criteria.setBearingRequired(false);
//设置是否允许付费服务
criteria.setCostAllowed(true);
//设置电量消耗等级
criteria.setPowerRequirement(Criteria.POWER_HIGH);
//设置是否需要返回速度信息
criteria.setSpeedRequired(false);
//根据设置的Criteria对象,获取最符合此标准的provider对象
String currentProvider = locationManager.getBestProvider(criteria, true);
Log.d("Location", "currentProvider: " + currentProvider);
//根据当前provider对象获取最后一次位置信息
Location currentLocation = locationManager.getLastKnownLocation(currentProvider);
//如果位置信息为null,则请求更新位置信息
if(currentLocation == null){
locationManager.requestLocationUpdates(currentProvider, 0, 0, locationListener);
}
//直到获得最后一次位置信息为止,如果未获得最后一次位置信息,则显示默认经纬度
//每隔10秒获取一次位置信息
while(true){
currentLocation = locationManager.getLastKnownLocation(currentProvider);
if(currentLocation != null){
Log.d("Location", "Latitude: " + currentLocation.getLatitude());
Log.d("Location", "location: " + currentLocation.getLongitude());
break;
}else{
Log.d("Location", "Latitude: " + 0);
Log.d("Location", "location: " + 0);
}
try {
Thread.sleep(10000);
} catch (InterruptedException e) {
Log.e("Location", e.getMessage());
}
}
//解析地址并显示
Geocoder geoCoder = new Geocoder(this);
try {
int latitude = (int) currentLocation.getLatitude();
int longitude = (int) currentLocation.getLongitude();
List<Address> list = geoCoder.getFromLocation(latitude, longitude, 2);
for(int i=0; i<list.size(); i++){
Address address = list.get(i);
Toast.makeText(MainActivity.this, address.getCountryName() + address.getAdminArea() + address.getFeatureName(), Toast.LENGTH_LONG).show();
}
} catch (IOException e) {
Toast.makeText(MainActivity.this,e.getMessage(), Toast.LENGTH_LONG).show();
}
}
//创建位置监听器
private LocationListener locationListener = new LocationListener(){
//位置发生改变时调用
@Override
public void onLocationChanged(Location location) {
Log.d("Location", "onLocationChanged");
Log.d("Location", "onLocationChanged Latitude" + location.getLatitude());
Log.d("Location", "onLocationChanged location" + location.getLongitude());
}
//provider失效时调用
@Override
public void onProviderDisabled(String provider) {
Log.d("Location", "onProviderDisabled");
}
//provider启用时调用
@Override
public void onProviderEnabled(String provider) {
Log.d("Location", "onProviderEnabled");
}
//状态改变时调用
@Override
public void onStatusChanged(String provider, int status, Bundle extras) {
Log.d("Location", "onStatusChanged");
}
};
}
由于代码里的Criteria对象对位置精度要求并不高,所以一般会返回“network”作为provider,而基于network的定位往往会存在一定的位置偏差,这对于需要精确定位的应用程序来说,显然不合要求。这时,需要则需要用到基于GPS的定位方法了。
以上大致介绍了一下在Android平台中,和定位功能相关的类,并举例获取了位置信息。但是前文是基于Criteria定制了一个标准,通过getBestProvider()方法由Android系统自动获取最符合Criteria的LocationProvider,从而实现了定位功能。这样的做法能最大限度的保证定位功能的可实现性,但是却无法保证获取到的位置信息有最大的准确度。因为除了GPS外,其他定位方式都或多或少存在着位置偏移。
在实现GPS定位前,先了解一下GPS的部分特性:
1. GPS定位需要依靠3颗或3颗以上的卫星。
2. GPS定位受环境影响较大,在晴朗的空地上,较容易搜索到卫星,而在室内通常是无法搜索到卫星的。
3. GPS定位需要使用GPS功能模块,而GPS功能模块的耗电量是巨大的。
在Android系统中,实现GPS定位的思路应该是:
1. 获取GPS的Location Provider。
2. 讲此Provider传入到requestLocationUpdates()方法,让Android系统获知搜索位置方式。
3. 创建实现了GpsStatus.Listener接口的对象,重写onGpsStatusChanged()方法,向LocationManager添加次监听器,检测卫星状态。(可选步骤)
根据以上思路,仿仿照上文中的例子,可以很容易的得到以下实现代码:(此代码的实现前提是GPS功能模块处于打开状态)
public class MainActivity extends Activity {
private LocationManager locationManager;
private GpsStatus gpsstatus;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
//获取到LocationManager对象
locationManager = (LocationManager) getSystemService(LOCATION_SERVICE);
//根据设置的Criteria对象,获取最符合此标准的provider对象
String currentProvider = locationManager.getProvider(LocationManager.GPS_PROVIDER).getName();
//根据当前provider对象获取最后一次位置信息
Location currentLocation = locationManager.getLastKnownLocation(currentProvider);
//如果位置信息为null,则请求更新位置信息
if(currentLocation == null){
locationManager.requestLocationUpdates(currentProvider, 0, 0, locationListener);
}
//增加GPS状态监听器
locationManager.addGpsStatusListener(gpsListener);
//直到获得最后一次位置信息为止,如果未获得最后一次位置信息,则显示默认经纬度
//每隔10秒获取一次位置信息
while(true){
currentLocation = locationManager.getLastKnownLocation(currentProvider);
if(currentLocation != null){
Log.d("Location", "Latitude: " + currentLocation.getLatitude());
Log.d("Location", "location: " + currentLocation.getLongitude());
break;
}else{
Log.d("Location", "Latitude: " + 0);
Log.d("Location", "location: " + 0);
}
try {
Thread.sleep(10000);
} catch (InterruptedException e) {
Log.e("Location", e.getMessage());
}
}
}
private GpsStatus.Listener gpsListener = new GpsStatus.Listener(){
//GPS状态发生变化时触发
@Override
public void onGpsStatusChanged(int event) {
//获取当前状态
gpsstatus=locationManager.getGpsStatus(null);
switch(event){
//第一次定位时的事件
case GpsStatus.GPS_EVENT_FIRST_FIX:
break;
//开始定位的事件
case GpsStatus.GPS_EVENT_STARTED:
break;
//发送GPS卫星状态事件
case GpsStatus.GPS_EVENT_SATELLITE_STATUS:
Toast.makeText(MainActivity.this, "GPS_EVENT_SATELLITE_STATUS", Toast.LENGTH_SHORT).show();
Iterable<GpsSatellite> allSatellites = gpsstatus.getSatellites();
Iterator<GpsSatellite> it=allSatellites.iterator();
int count = 0;
while(it.hasNext())
{
count++;
}
Toast.makeText(MainActivity.this, "Satellite Count:" + count, Toast.LENGTH_SHORT).show();
break;
//停止定位事件
case GpsStatus.GPS_EVENT_STOPPED:
Log.d("Location", "GPS_EVENT_STOPPED");
break;
}
}
};
//创建位置监听器
private LocationListener locationListener = new LocationListener(){
//位置发生改变时调用
@Override
public void onLocationChanged(Location location) {
Log.d("Location", "onLocationChanged");
}
//provider失效时调用
@Override
public void onProviderDisabled(String provider) {
Log.d("Location", "onProviderDisabled");
}
//provider启用时调用
@Override
public void onProviderEnabled(String provider) {
Log.d("Location", "onProviderEnabled");
}
//状态改变时调用
@Override
public void onStatusChanged(String provider, int status, Bundle extras) {
Log.d("Location", "onStatusChanged");
}
};
}
通过以上代码中的注释部分,可以清晰的知道Android定位功能里相关方法的具体含义。希望对大家有用。
另外,因为GPS的自身特性,此代码在室内几乎无法定位,所以建议再真正的实际项目里,至少使用network和GPS两种不同的Location Provider实现定位功能。