Google Map API开发Android地图应用实例

下面通过一个实例完成一个简单的定位系统,并且在地图上显示当前的位置,实例的详细代码在 GPSLocationInMapDemo 项目中,实际调试时需要在真机上进行并且需要开启 GPS。运行效果如图 1 所示。

一个简单的定位系统
图 1  一个简单的定位系统
具体步骤如下:

1)创建一个新的工程并命名为 GPSLocationInMapDemo。

需要注意的是,由于要使用 Google Map API,因此创建的主 Activity 需要继承自 MapActivity,而不是 Activity。当选择 Build Target 时,应选择 Google APIs,如图 2 所示。

New Andriod Project对话框
图 2  New Andriod Project 对话框

2)在 AndroidManifest.xml 文件中的 <application> 标签中加入:

<uses-library android:name="com.google.android.maps" />

以便可以使用 Google Map API。为了使用 GPS 数据,在 <application> 标签之外加入如下权限:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

为了从 Internet 获取地图数据,需要网络访问权限:

<uses-permission android:name="android.permission.INTERNET"/>

3)编写 main.xml 布局文件,具体代码如下:
<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical">

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

<TextView
    android:id="@+id/myLocationText"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"/>

<com.google.android.maps.MapView
    android:id="@+id/myMapView"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:apiKey="OrvIRrEPTuYsUXACd_p53h-ftI7T425PToOjKuQ"
    android:clickable="true" />
</LinearLayout>
在 main.xml 布局中放置了两个 TextView 和一个 MapView 组件。

GPSLocationInMapDemoActivity.java 的代码如下:
package introduction.android.gpsLocationInMapDemo;

import android.content.Context;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
import android.os.Bundle;
import android.widget.TextView;

import com.google.android.maps.GeoPoint;
import com.google.android.maps.MapActivity;
import com.google.android.maps.MapController;
import com.google.android.maps.MapView;
import com.google.android.maps.MyLocationOverlay;

public class GPSLocationInMapDemoActivity extends MapActivity {
    /**
     * Called when the activity is first created.
     */
    // 定义Location对象
    protected Location location;
    //定义MapView对象
    private MapView map;
    // 定义MyLocationOverlay 对象,在地图上标注当前位置
    private MyLocationOverlay myLocation;
    private MapController mapController;
    private TextView myLocationText;
    private GeoPoint geopoint;
    private double latitude;
    private double longitude;

    /**
     * Called when the activity is first created.
     */
    protected boolean isRouteDisplayed() {
        return false;
    }

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        myLocationText = (TextView) findViewById(R.id.myLocation_Text);
        //定义 LocationManager对象
        LocationManager locationManager;
        String seviceName = Context.LOCATION_SERVICE;
        // 获取LocationManager对象
        locationManager = (LocationManager) getSystemService(seviceName);
        locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 2000, 10, locationListener);
        // 得到MapView对象
        map = (MapView) findViewById(R.id.myMapView);
        //得到MapView对象的控制器
        mapController = map.getController();
        //设置 map 支持缩放工具条
        map.setBuiltInZoomControls(true);
        map.setSatellite(true);
    }

    //得到LocationListener对象
    private final LocationListener locationListener = new LocationListener() {
        //当Provider处于不能使用时触发
        public void onProviderDisabled(String provider) {

        }

        //当状态发生改变时触发
        public void onStatusChanged(String provider, int status, Bundle extras) {

        }

        //当位置发生变化时触发
        @Override
        public void onLocationChanged(Location location) {
            // TODO Auto-generated method stub
            // 得到当前位置的纬度
            latitude = location.getLatitude();
            //得到当前时间的经度
            longitude = location.getLongitude();
            geopoint = new GeoPoint(new Double(latitude * 1E6).intValue(), new Double(longitude * 1E6).intValue());
            mapController.setCenter(geopoint);

            //得到当前时间的MyLocationOverlay对象
            myLocation = new MyLocationOverlay(
                    GPSLocationInMapDemoActivity.this, map);
            myLocation.enableMyLocation();
            // 将当前位置添加到地图上
            map.getOverlays().add(myLocation);
            //设置地图为卫星模式
            myLocationText.setText("当前位置纬度" + latitude + "\n当前位置经度"
                    + longitude);
        }

        //当Provider处于可用时触发
        @Override
        public void onProviderEnabled(String provider) {
            // TODO Auto-generated method stub
        }
    };
}
MapView 组件通过网络载入所需地图,并且提供了拖曳地图的接口,用户可以直接在 MapView 中移动地图。MapView 提供了地图控制器,通过

mapController=map.getController();

方法可以获取到。通过控制器可以方便地控制 MapView 组件中地图的缩放和窗口移动。本实例中通过

mapController.setCenter(geopoint);

控制器将当前位置 geopoint 设置为 MapView 组件的中心。GeoPoint 代表的是地图上特定的点,需要注意的是,在 MapView 中使用的 geoPoint 的经纬度位置与从 GPS 中获取的经纬度存在一个 1E6 的比例差,需要经过转换后才能正确显示当前位置。本实例中的坐标转换代码为:

latitude = location.getLatitude();
longitude = location.getLongitude();
geopoint = new GeoPoint(new Double(latitude * 1E6).intValue(), new Double(longitude * 1E6).intValue());

MapView 提供了更加方便地对地图数据进行缩放的方式,通过

map.setBuiltInZoomControls(true);

在地图上放置一个缩放条(如图 3 所示),用户可以直接使用该缩放条对地图进行放大和缩小,而无须编写任何代码。
缩放条
图 3  缩放条

Overlay 是 Google Map API 提供的专门在地图上进行标记的类。本实例中使用 Overlay 标记当前的位置点。相关代码为:
//得到当前时间的MyLocationOverlay对象
myLocation = new MyLocationOverlay(GPSLocationInMapDemoActivity.this, map);
myLocation.enableMyLocation();
// 将当前位置添加到地图上
map.getOverlays().add(myLocation);
至此,该实例开发完成。运行该实例需要支持 Google APIs 的 AVD,如图 4 所示。若没有,则可以通过 AVD Manager 创建一个。
 创建支持 Google APIs 的 AVD
图 4  创建支持 Google APIs 的 AVD