开发基于 Google Map 的 Android 应用

标签: IT技术 书籍与教程 Android Google Map | 发表时间:2012-06-30 14:56 | 作者:童海波
出处:http://blog.jobbole.com

简介: 随着移动互联网应用的迅速发展,利用智能手机提供的实时地理位置信息服务功能扩展出众多 LBS(Location Based Service) 应用,将实时地理位置信息与手机的便捷、移动特性结合,为人们提供多种多样的应用场景,比如实时定位、导航、搜索周围好友、基于地理位置的信息推荐等。本文通过实例介绍如何开发基于 Google Map 的 Android 应用。

概述

本文以实例介绍如何开发基于 Google Map 的 Android 应用,共分为五部分:1. 开发 Android 应用的准备以及 Google Map API 密钥的获取;2. 将 google 地图控件放入 Android 工程中;3. 添加地图缩放组件,以及地图模式,缩放比例的调整;4. 使用 Android 系统提供的地理位置信息的服务获取当前地理位置信息;5. 将当前地理位置信息以图标的方式显示在地图上。

回页首

开发 android 应用的准备

本文将主要介绍如何在 Android 系统上开发基于 Google 地图的应用。在开始阅读这篇文章之前,需要具备基本的 Android 开发的相关知识。读者需要了解如何在 eclipse 开发简单的 android 应用程序,例如 Eclipse IDE 的配置和 Android SDK 的安装。

●  Eclipse IDE( http://www.eclipse.org/downloads/)

● Android SDK( http://developer.android.com/sdk/index.html)

为了开发基于 Google map 的 Android 应用,同时还需要安装 Google APIs Add-on,以及创建包含有 Google API 的 Android 模拟器。

● Google APIs Add-on( http://code.google.com/android/add-ons/google-apis/installing.html)

● Android Virtual device Targeting Google APIs( http://developer.android.com/guide/developing/devices/index.html)

获取 Google 地图 API key,以及生成 keyStore 文件

使用 google map 第一步是要获得 google map API 密钥,一个密钥只对一个”目录”或者”域”有效,对于 Google 来说,获取密钥的过程其实也是认证的过程,在你获取密钥时,需要同意 Google 所列出的一些法律条款,所以在你使用获取密钥后,Google 默认你已经同意了其地图使用的条款。

获取密钥的过程可以简单分为两个阶段:

阶段 1:获得 MD5 指纹并创建证书

通过 JDK( 本文中所指的 JDK 均为 Oracle JDK) 中自带的 Keytool.exe 工具来生成证书,Keytool.exe 可以在 %JAVA_HOME%\jdk1.6.0_21\bin 里找到,

图 1. 创建证书

开发基于 Google Map 的 Android 应用

为了开发和调试基于 Google Map 的 Android 应用,我们可以使用在 Android 应用调试模式下的证书 debug.keystore,该文件一般存放在 : %userprofile%/.android/

在笔者的 Windows XP 系统中,该文件的存放路径为

C:\Documents and Settings\Administrator\.android\

将 debug.keystore 文件复制到 Keytool 工具的目录下,然后通过下面的命令来获取证书的 MD5 值 : keytool.exe -list -alias androiddebugkey -keystore debug.keystore -storepass android -keypass android

图 2. 获取证书的 MD5 值

开发基于 Google Map 的 Android 应用

阶段 2:获取 Google Map 的 API 密钥

登陆  http://code.google.com/android/maps-api-signup.html,通过使用之前获得的 MD5 值,来完成 Google Map API 密钥的申请。图 3 为申请成功的截图。

图 3. 申请 Google Map API 密钥界面

开发基于 Google Map 的 Android 应用

 

创建一个 Android 工程

1.建立新的 Android 工程,并命名为 GoogleMapExample,开发基于 Google Map 的应用需要指定该工程的 build target 为 Google APIs。 

图 4. 创建 Android 工程界

开发基于 Google Map 的 Android 应用

2.开发 Android 应用可以在手机或者模拟器上进行调试,如果使用模拟器进行开发,首先需要创建 Android 模拟器,并且指定该模拟器的 target 为 Google APIs。 

图 5. 创建 Android 模拟器界面

开发基于 Google Map 的 Android 应用

3.设置示例工程的运行环境,确保示例工程运行在包含有 Google API 的目标模拟器上。

图 6. 设置示例工程运行环境界面

开发基于 Google Map 的 Android 应用

4.在模拟器上运行 GoogleMapExample 示例工程,模拟器应该有如图 7 的输出。自此,开发基于 Google Map 应用的工程就初步搭建起来了,接下来我们一步一步来将地图控件添加进 GoogleMapExample 应用中

图 7. 运行结果界面

开发基于 Google Map 的 Android 应用

将 Google Map 控件添加到 GoogleMapExample 工程中

首先,在 AndroidManifest.xml 文件中添加对于 Google Map 库的引用。通过使用 uses-library 标签来添加 google map 库到当前应用中。
清单 1. 添加对于 Google Map 库的引用

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

添加的相应的访问权限:

● android.permission.ACCESS_COARSE_LOCATION: 允许应用通过网络信息获取当前地理位置信息的权限。

● android.permission.ACCESS_FINE_LOCATION: 允许应用通过 GPS 获取当前地理位置信息的权限,较网络获得的地理位置信息更为精确。

● android.permission.INTERNET: 允许应用访问网络的权限。

最终的 AndroidManifest.xml 文件示例如下:
清单 2. AndroidManifest.xml 文件

<?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.android.mapExample"
      android:versionCode="1"
      android:versionName="1.0">
      <uses-sdk android:minSdkVersion="3" />
      <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
      <uses-permission android:name="android.permission.INTERNET"/>
      <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

      <application android:icon="@drawable/icon" android:label="@string/app_name">
          <uses-library android:name="com.google.android.maps" />
 <activity android:name=".GoogleMapExampleActivity"
              android:label="@string/app_name">
              <intent-filter>
                  <action android:name="android.intent.action.MAIN" />
                  <category android:name="android.intent.category.LAUNCHER" />
              </intent-filter>
          </activity>
      </application> 

 </manifest>

其次,将 MapView 控件添加进布局文件 main.xml 中,并将 1.3 中获得的 API 填入 MapView 控件的声明中。
清单 3. main.xml 文件

<?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      android:orientation="vertical"
      android:layout_width="fill_parent"
      android:layout_height="fill_parent"> 

      <com.google.android.maps.MapView
           android:id="@+id/mapView"
           android:layout_width="fill_parent"
           android:layout_height="fill_parent"
           android:clickable="true"
           android:apiKey="0gtIEXVeu0g96nXpxjvByVW9hs7V0mDiuNHRwRw" /> 

 </LinearLayout>

第三,将 GoogleMapExampleActivity 的继承类修改为 MapActivity,并添加  com.google. android . map s. Map Activity 重写 isRouteDisplayed 方法,由于示例中没有正在显示的路线信息,这里我们返回 false 即可。
清单 4. GoogleMapExampleActivity 类

public class GoogleMapExampleActivity extends MapActivity {
      @Override
      public void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.main);
      }
      @Override
      protected boolean isRouteDisplayed() {
           return false;
      }
 }

编译并且运行,将会得到如图 8 所示的地图,这时地图控件已经被我们成功的添加进示例工程中了。

图 8. 世界地图界面

开发基于 Google Map 的 Android 应用

添加缩放控件并控制缩放比例,切换地图显示类型(卫星,地图,街道)

Google 地图 MapView 对象自带有控制缩放比例的组件,我们可以通过调用 MapView 对象的  setBuiltInZoomControls方法来完成添加或者移除缩放控件。

1.通过在 layout 文件 main.xml 中的 id 获取找到 MapView 对象

清单 5. 获取 MapView 对象

mapView = (MapView) findViewById(R.id.mapView);

2.在 mapView 对象上调用 setBuiltInZoomControls 方法,这里传入 boolean 类型的参数,true 和 false 分别表示添加或者移除缩放组件

清单 6. 调用 setBuiltInZoomControls 方法

mapView.setBuiltInZoomControls(true);

需要提到的是,如果添加了缩放控件,它会在第一次触击地图的时候生效,如图 9 所示。

图 9. 地图的缩放控件

开发基于 Google Map 的 Android 应用

通过 MapControl 来控制缩放比例,通过获取 MapView 的 MapControl 对象,控制缩放比例。这里我们设置 16 档为当前缩放大小。

清单 7. 控制缩放比例

mapController = mapView.getController();
 mapController.setZoom(16);

Google 地图缩放比例共分为 21 档,具体的缩放划分可以参考 google 文档,以及链接  http://greg-koppel.site88.net/maps/InfoDisplay.html

切换地图的显示类型,Google 地图提供了三种地图的显示方式,分别为卫星,地图,街道,默认设置为街道模式,这些模式的切换可以通过调用 MapView 对象提供的相应方法来完成切换。

最终的代码示例:

清单 8. 切换地图的显示类型

@Override
 public void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          setContentView(R.layout.main);
          mapView = (MapView) findViewById(R.id.mapView);
       // 街道模式(默认设置)
          mapView.setStreetView(true); 

          // 卫星模式
          //mapView.setSatellite(true); 

          // 是否显示交通信息
          // mapView.setTraffic(true); 

           mapView.setBuiltInZoomControls(true);
           mapController = mapView.getController();
           mapController.setZoom(16);
  }

获取当前地理位置信息

Android 系统提供的获取地理位置信息的服务,通过该服务开发者不仅可以方便的获取当前 Android 设备的地理位置信息,并且还提供定制地理位置信息获取的方式,位置变化追踪等。

LocationManager,LocationProviders 这两个类在 Android 系统中,提供获取当前地理位置信息的功能。

● LocationManager: 提供访问 Android 地理信息服务的接口。

● LocationProvider: 提供多种定位方式供开发者选择(GPS, NETWORK 定位等)。

● Critieria:设置一系列的查询条件,来获取相应的 Location Provider。

下面通过一个具体的示例来说明,如何获取 Android 系统中最后一次更新的地理位置信息。

1.根据应用需求创建 Criteria 对象,设定获取地理位置信息的精度,方向信息等。

2.获取当前符合步骤 1 定义的规则最优的 LocationProvider。

3.获取 LocationManager 对象来访问 android 系统地理位置信息服务。

4.通过 LocationManager 对象提供的方法获取系统最后一次更新的地理位置信息。

示例代码如下:

清单 9. 获取 Android 系统中最后一次更新的地理位置信息

mapView = (MapView) findViewById(R.id.mapView);
 private LocationManager locationManager = null;
 private String bestProvider = null; 

 private String getBestProvider(Context context){
    Criteria criteria = new Criteria();
    criteria.setAccuracy(Criteria.ACCURACY_COARSE); // 设置精度
    criteria.setAltitudeRequired(false); // 设置是否需要提供海拔信息
    criteria.setBearingRequired(false); // 是否需要方向信息
    criteria.setCostAllowed(false); // 设置找到的 Provider 是否允许产生费用
    criteria.setPowerRequirement(Criteria.POWER_LOW); // 设置耗电

    locationManager=(LocationManager)context.getSystemService(Context.LOCATION_SERVICE);
    String provider=locationManager.getBestProvider(criteria, true);
    // 这里可能返回 null, 地理位置信息服务未开启
    return provider;
    }  

    public Location getLastKnowLocation(Context context) {
             Location ret = null;
             this.bestProvider = getBestProvider(context); 

            if(this.bestProvider != null) {
                       ret = locationManager.getLastKnownLocation(this.bestProvider);
            }
            // 这里可能会返回 null, 表示按照当前的查询条件无法获取系统最后一次更新的地理位置信息
           return ret;
     }

在实际应用中,这里有两个问题需要特别注意:

一方面,当 Android 设备的地理位置信息服务处于未开启的状态时, 通过LocationManager 获取的LocationProvider 将会返回null ,在这里需要提示用户当前地理位置信息服务未开启,否则将会有" java.lang.IllegalArgumentException: provider==null " 异常抛出 ( 具体方式请参考 附带 源代码 )

另一方面,由于 getLastKnownLocation 方法是一个非阻塞调用方法,例如在设置为GPS 方式获取地理位置信息时经常会返回null,通常处理在 getLastKnownLocation 中返回值为null 的方法有两种 :

1.设置地理位置信息获取的精度为粗粒度位置信息获取,相对于 GPS 方式,通过网络信息等方式获取当前位置更容易进行定位。

criteria.setAccuracy(Criteria. ACCURACY_COARSE)

通过使用 LocationListener 请求并监听用户地理位置信息的变化

Step 1. 创建 Location Listener 对象,实现 LocationListener 接口

Step 2. 使用在 4.1 中初始化的 locationManager 对象请求地理位置信息的更新,并绑定到自己定义的 locationListener 对象

Step 3. 当 LocationManager 获取到有效的地理位置信息时,在 LocationListener 接口定义的 onLocationChanged 方法将会被回调,传入参数就是当前获取的位置。

最后需要注意的是,获取到地理位置信息后,以及当前 Activity 生命周期结束时,将 locationListener 在 LocationManager 的绑定移除。

清单 11. 监听用户地理位置信息的变化

private MyLocationListener myLocationListener = null; 

        public class MyLocationListener implements LocationListener { 

        @Override
        public void onLocationChanged(Location location) {
              if (location != null) {
                  myLocation = location;
                  mapController.setZoom(16);
                  addMarker();
                  locationManager.removeUpdates(myLocationListener);
              }
        } 

        @Override
        public void onProviderDisabled(String provider) {} 

        @Override
        public void onProviderEnabled(String provider) {} 

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

        @Override
        protected void onPause() {
             super.onPause();
        } 

        @Override
        protected void onResume() {
              super.onResume();
              myLocation = getLastKnowLocation(this);
              if(myLocation == null) {
                    if(this.bestProvider != null){
 locationManager.requestLocationUpdates(LocationManager.
                        GPS_PROVIDER, 1000, 0, myLocationListener);
                    }
               } else {
                    addMarker();
               }
         } 

         @Override
         protected void onDestroy() {
              super.onDestroy();
              locationManager.removeUpdates(myLocationListener);
         }

在地图上添加当前位置的图标

在地图上添加图标是地图应用时必不可少的功能,Google Map API 也为开发者提供了方便的接口在地图显示图标,本文还是以实例来说明如何将当前位置标示在地图上,效果如图 10 所示。

图 10. 当前位置图标


开发基于 Google Map 的 Android 应用

1.创建 MyOverlay 类,继承自 ItemizedOverlay 抽象类,在 MyOverlay 对象中包括所有要在地图上标注的对象列表 mItems。

2.重写 createItem 方法,将需要在地图上标注的点转化为 OverlayItem 对象,OverlayItem 对象对应于在地图上标注的每一个点,其包括经纬度信息、名称、标题、图标等属性,这些属性均可以通过其对象中提供的设置方法进行修改。

3.调用  addMarker () 方法,将获取的当前位置信息以图标方式显示在地图上。

4.在  myMapOverlay 类中重写 OnTap 方法,该方法会在图标点击事件触发时回调,传入参数为响应触击事件 overlayItem 对象在  mItems 中的位置。在我们的示例中,当图标点击事件触发时通过 toast 来显示当前位置信息。

清单 12. 在地图上添加图标

private void addMarker() {
      if (myOverlay == null && myLocation != null) {
           GeoPoint myGeoPoint = location2GeoPoint(myLocation);
           if (myGeoPoint != null) {
                   myOverlay = new MyMapOverlay(currLocMaker);
                   myOverlay.setItem(myGeoPoint);
                   mapView.getOverlays().add(myOverlay);
                   mapController.animateTo(myGeoPoint);
            }
      }
 } 

 public class MyMapOverlay extends ItemizedOverlay<OverlayItem> {
      private List<GeoPoint> mItems = new ArrayList<GeoPoint>(); 

      public MyMapOverlay(Drawable marker) {
      // 初始化默认图标,并设置其为底部中心对应显示点
            super(boundCenterBottom(marker));
      } 

      public void setItems(ArrayList<GeoPoint> items) {
            mItems = items;
            populate();
      } 

      public void setItem(GeoPoint item) {
            mItems.add(item);
            populate();
      } 

      @Override
      protected OverlayItem createItem(int i) {
           // 此处没有进行图标的修改,默认为使用父类的默认图标
           return new OverlayItem(mItems.get(i), null, null);
      } 

      @Override
      public int size() {
           return mItems.size();
      } 

      @Override
      protected boolean onTap(int i) {
           // 图标点击事件处理
           Toast.makeText(GoogleMapExampleActivity.this,
           "当前位置:\n "+ myLocation.getLatitude() + ", "+myLocation.getLongitude(),
           Toast.LENGTH_SHORT).show();
           return true;
      }
    }

结束语

本文通过实例介绍如何在 Android 系统上开发以及 Google Map 的简单应用程序,相信读者通过源代码实例以及文字介绍有了大致的了解。接下来我们还会对开发基于 Map 应用过程中一些常用的方法进行汇总,比如,如何自定制图标并添加文字,响应长按事件,zoom 事件,点击图标弹出气球框等。

 

参考资料

学习

●  Android 开发人员站点提供了教程、文档、下载、SDK 更新日志等。

● 随时关注 developerWorks  技术活动网络广播

● 访问 developerWorks  Open source 专区获得丰富的 how-to 信息、工具和项目更新以及 最受欢迎的文章和教程,帮助您用开放源码技术进行开发,并将它们与 IBM 产品结合使用。

讨论

● 加入  developerWorks 中文社区,developerWorks 社区是一个面向全球 IT 专业人员,可以提供博客、书签、wiki、群组、联系、共享和协作等社区功能的专业社交网络社区。

● 加入  IBM 软件下载与技术交流群组,参与在线交流。

相关文章

相关 [开发 google map] 推荐:

开发基于 Google Map 的 Android 应用

- - 博客 - 伯乐在线
简介: 随着移动互联网应用的迅速发展,利用智能手机提供的实时地理位置信息服务功能扩展出众多 LBS(Location Based Service) 应用,将实时地理位置信息与手机的便捷、移动特性结合,为人们提供多种多样的应用场景,比如实时定位、导航、搜索周围好友、基于地理位置的信息推荐等. 本文通过实例介绍如何开发基于 Google Map 的 Android 应用.

【转载】在Google Map上玩LEGO

- - HTML5研究小组
Google又放出了很帅又充满了Google式小清新风格的HTML5在线游戏,这次和LEGO合作——在Google Map上砌LEGO积木:. 这个游戏不知道是哪个和我一样买不起房的屌丝想出来的,不知道梦见几次在地球上某个有待开荒的土地上占一个山头盖属于自己的房子之后用满腔的热血把它做出来了. 不过貌似只能选择在大洋洲范围内的土地,估计开发者是那边的穷矮矬.

Google Labs:通过 HTML 5 网页显示分形图的 Julia Map

- Kevin - 谷奥——探寻谷歌的奥秘
感谢读者 xslidian 的提醒. Google Labs又有新成员:Julia Map. 它可显示出法国数学家加斯顿朱莉娅在上世纪20年代研究出的分形图案. 通过Google Maps API来提供缩放功能,而通过数百万浮点运算而生成的图形完全基于HTML 5 canvas,同时还利用到了HTML 5的Web workers,以调用电脑的所有核心来进行运算.

谷歌的工程师利用Google Map追求女友

- 小熊TONY - cnBeta.COM
感谢Cnpda智能手机论坛的投递. 一个名叫阿里吉尔德的谷歌工程师建议他的女朋友今天务必要使用Nexus One里的谷歌地图,因为他为女朋友的Nexus One建立了一个谷歌地图的自定义应用程序,可以利用谷歌地图,计划她的路线,她会在不同地点使用这个自定义的程序,并且找到早就为她安排好的玫瑰花.

Google Map API 调用次数限额调整方案确定

- 可可 - 谷奥——探寻谷歌的奥秘
今年4月Google宣布将在10月份对Google Maps API调用进行限制,现在已经有了初步方案:. 每个API最多25,000次调用/天. 最多2,500次自定义样式的api调用/天. Google近期会将Google Maps API加入  Google APIs Console ,届时开发者可以在里面查看详细调用数据,同时需要对自己的应用做出调整以保证不会超出限额.

Spring MVC+JQuery+Google Map打造IP位置查找应用(1)

- - 企业架构 - ITeye博客
All examples are simple, easy to read, and full source code available, and of course well tested in our development environment.. 在本文中,读者将学习到如何使用Spring MVC框架和jQuery及Google Map,制作一个简单的根据IP位置查找应用.

JavaScript Source Map 详解

- - 阮一峰的网络日志
上周, jQuery 1.9发布. 这是2.0版之前的最后一个新版本,有很多新功能,其中一个就是支持Source Map. 访问 http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js,打开压缩后的版本,滚动到底部,你可以看到最后一行是这样的:.

Hibernate调优之select new map()

- - CSDN博客架构设计推荐文章
        Hibernate调优不只是设置一下lazy,调整一下由谁来维护这个字段而已.         这次要说的是对查询语句进行优化——select new map().         select new map语句结果说明.         语句一:.         结果list中,每条记录对应一个object数组,object[]中每个元素为hql语句中列的序号(从0开始).

基于的Map/Reduce的ItemCF

- - M.J.
ItemCF为基于邻域的方法使用用户共同行为来对Item之间的相似度进行计算,从而利用k-近邻算法使用用户曾经有个行为的Item进行推荐. 好处是系统只需要存储Item x Item的相似度矩阵,对于Item数量远小于用户数量的应用来说,具有很高的性价比. ItemCF最核心的计算为item之间相似度矩阵的计算,同时还需要能够在短时间内响应Item变化情况(用户有行为之后就会造成相似度矩阵的重新计算,实际中不会全部重新计算而会使用增量计算的方式.

mapreduce中map个数的确定

- - CSDN博客云计算推荐文章
      在map阶段读取数据前,FileInputFormat会将输入文件分割成split. 影响map个数,即split个数的因素主要有:. 1)HDFS块的大小,即HDFS中dfs.block.size的值. 如果有一个输入文件为1024m,当块为. 256m时,会被划分为4个split;当块为128m时,会被划分为8个split.