第一部分(在本节中)将介绍包括:
1.MapView对象的使用
2.使用MD5密文获取一个谷歌地图API密钥
3.实现一个地点监听器,以获得你的当前位置
第二部分将包括:
1.在应用程序中使用外部库类
2.创建显示出你的当前位置和周边的信息点
现在让我们开始吧!
步骤1:创建一个新的Android项目
启动Eclipse IDE并创建一个新的Android项目。
File > Create > New Android Project
使用以下设置创建新的项目:
项目名称:MallFinder
生成目标:Google APIs Platform–2.1 API Level 7
应用程序名:Mall Finder
包名称:com.shawnbe.mallfinder
创建Activity:MallFinderActivity
最低SDK版本:7
Android 的 Mapview & Location 使用教程
设置完成后,点击完成。
步骤2:在谷歌上注册获取API密钥
因为MapView对象使用谷歌地图,你需要在谷歌注册一个API密钥,并同意服务条款,然后才可以使用他们。注册过程相当简单。想要了解更多关于获得地图API密钥信息,请查看此链接。
要对你的应用程序进行签名就必须要用到的MD5密文生成的API秘钥,听起来很令人困惑,但它并不难,因为你会发现它像当我们之前的几个步骤 。而不是上面的链接所述,使用命令行的方式得到你的MD5密文,我们将使用keytool的一个Eclipse插件 。想要了解更多有关keytool的插件信息,请查看此链接。
步骤3:安装keytool插件
在Eclipse IDE中,导航到 Help > Install New Software。
Android 的 Mapview & Location 使用教程
当新的窗口弹出,在窗口的顶部点击“Add”按钮。
在“Name”栏输入“keytool”(不含引号),
在“Location”栏输入“http://www.keytool.sourceforge.net/update”
Android 的 Mapview & Location 使用教程
点击“OK”。
经过短暂的加载时间,窗口将出现一个标有“keytool”的复选框。选中该复选框并单击“下一步”。同意协议的条款,然后单击“下一步”完成。
注意:在安装过程中,可能会提示您确定是否信任安全证书。如果你确定,就选中复选框并单击“确定”继续安装。
Android 的 Mapview & Location 使用教程
安装完成后,将会提示重新启动Eclipse。
步骤4:获取MD5密文
Eclipse重新启动之后,你应该看到一个新的菜单项“keytool”,它旁边有一个小钥匙图标。
Android 的 Mapview & Location 使用教程
我们现在要打开调试的keystore。
注意:由于操作系统的位置可能会有所不同。各种操作系统的默认位置:
Windows Vista : C:\Users\ \.android\debug.keystore
Windows XP : C:\Documents and Settings\ \.android\debug.keystore
OS X and Linux : ~/.android/debug.keystore
点击keytool菜单项>打开密钥库。
点击位于“文件名”文本框右侧的“浏览”按钮,并找到keystore的位置(上述为默认位置),并选择debug.keystore文件。
单击“打开”,选择类型“android”(不带引号),这是默认的调试密码,然后单击“Load”。
Android 的 Mapview & Location 使用教程
现在应该在屏幕底部的面板可见一个新的keytool的标签(如果你没有看到它,导航到“Window > Open Perspective > Java Browsing”)。
Android 的 Mapview & Location 使用教程
点击debug.keystore路径左侧的小箭头将显示androiddebugkey。
双击androiddubugkey并复制MD5密文。
打开Web浏览器,进入以下网址。 http://code.google.com/android/maps-api-signup.html
阅读并同意条款,在文本框中输入MD5密文,并点击“Generate API Key”。请注意保存好你的API密钥,因为使用MapView的时候需要它。
步骤5:在布局中添加MapView
在这一步,我们将添加一个MapView到布局文件。
打开位于MallFinder > res > layout> main.xml中的main.xml文件,并修改该文件如下所示,包括一个FrameLayout和MapView:
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
android:layout_height="fill_parent"
android:orientation="vertical" >
android:layout_height="fill_parent">
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true"
android:apiKey="PUT YOUR API KEY HERE"/>
上述布局在整个可用的屏幕空间创建一个MapView。在当前状态下运行的应用程序,将导致在强制关闭。我们还需要完成多个步骤。
步骤6:设置权限,并导入所需的库
由于我们的应用程序将会从Google Maps下载数据,同时需要从手机的GPS或其他定位服务访问信息,所以我们需要在AndroidManifest文件中的声明必要的权限来使用这些服务。
要做到这一点,打开位于MallFinder > AndroidManifest.xml中的AndroidManifest.xml文件。
在关闭应用程序标记()后面,和在闭幕清单标记()之前添加以下几行。
?
1
2
3
4
在这个例子中,我不需要FINE_LOCATION,但我已经包含在此,我想你可能要调整你的代码来测试各种提供商,如果你想获得更准确的位置,你将需要FINE_LOCATION权限。通常任何生产中的应用程序都不应该声明不需要的权限。如你要求更多的权限,这是一个非常糟糕的做法,使用户警惕你的应用程序。如果你不打算使用更准确的供应商,你可以不声明android.permission.ACCESS_COARSE_LOCATION。
为了在我们的MapView中使用谷歌地图,我们需要在Manifest文件中声明该库,这样我们要在关闭活动标记和关闭应用程序标记代码之间加入下面的标签:
?
1
我们可以把标题栏去掉,因为我觉得这是不必要的。它使用了太多我们有限的屏幕空间。在应用程序删除标题栏添加下面代码:
?
1
android:theme="@android:style/Theme.NoTitleBar"
现在我们完整的Manifest文件看起来像这样:
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
android:versionCode="1"
android:versionName="1.0" >
android:label="@string/app_name"
android:theme="@android:style/Theme.NoTitleBar">
android:name=".MallFinderActivity" >
步骤7:设置MapView
在我们运行MapView之前,我们还需要做一些MallFinderActivity类的调整。
打开的主要活动类(MallFinderActivity.java),这是位于:MallFinder > src > com.shawnbe.mallfinder > MallFinderActivity.java
在我们的应用程序中,我们需要将这个类继承“MapActivity”,而不是“Activity”。
修改行:
?
1
public class MallFinderActivity extends Activity {
改成:
?
1
public class MallFinderActivity extends MapActivity {
继承MapActivity类时,我们需要实现isRouteDisplayed()方法,所以我们需要添加下面的方法 :
?
1
2
3
4
5
@Override
protected boolean isRouteDisplayed() {
// TODO Auto-generated method stub
return false;
}
这时,我们可以启动应用程序并显示MapView,但我们的没有设置选项,如缩放级别和可见图层。我们开始在onCreate方法中声明以下变量:
?
1
2
private MapController mapController;
private MapView mapView;
在onCreate方法中添加以下几行代码:
?
1
2
3
4
5
6
mapView = (MapView)findViewById(R.id.mapView);
mapView.setBuiltInZoomControls(true);
mapView.setSatellite(false);
mapView.setStreetView(true);
mapController = mapView.getController();
mapController.setZoom(13);
上面的代码只显示街层并隐藏的卫星层。我个人喜好选择它,因为我觉得在这种情况下更容易读。正如你喜欢用布尔值false和true来随意调整一样。此外,缩放级别设置为13,你也可以调整到1作为整个世界视图来看和20最大变焦。
最后,我们可以继续启动应用程序,以确保一切运行像预期一样。
有几种方法来运行应用程序,首先:
在Package Explorer window中右键单击项目 > Run as > Android Application
或者
从菜单上,单击Run > Run
step7
然后选择你的手机或模拟器。你应该可以看到一个地图覆盖整个屏幕,除了在屏幕上方的通知栏,而且可以滚动并使用缩放。