Android Google Map API 开发基础知识

楼主^#

更多发布于：2012-09-12 09:48

开发基于谷歌地图的应用和普通的android应用差不多都要使用它提供给我们的类库，所不同的是google
map的类库不是android平台的基本类库，是google api的一部分，所以建立项目时，SDK要选择Google APIs；
还有一点，开发基于地图的应用时候需要使用google map的APIkey，必须先申请key，然后才能开发基于地图的应用。
下边分步骤记录下，整个过程：
 一、申请google Maps API key（用于开发和debug）
为了能顺利的申请Android Map API
Key,必须要准备google的账号和系统的证明书。一般Google发布Key都需要Google账号，Google账号是通用的，Gmail的账号就可以。当一个程序发布时必须要证明书，证明书其实就是MD5.我们这里并不是发布，而只是为了开发测试，可以使用Debug版的证明书，下面我们就来学习如何申请Debug版的Key：
1.找到你的debug.keystore文件
在Eclipse工具下，选择windows-->Preference-->Android-->Build,其中Default
debug keystore的值便是debug.keystore的路径了。
2.取得debug.keystore的MD5值
首先cmd命令行进入debug.keystore文件所在的路径，执行命令：keytool
-list -keystore
debug.keystore，这时可能会提示你输入密码，这里默认的密码是“android",这样即可取得MD5值。
3.申请Android Map 的API Key.
打开浏览器，输入网址：<a href="http://code.google.com/android/maps-api-signup.html">http://code.google.com/android/maps-api-signup.html</a>，填入你的认证指纹(MD5)即可获得apiKey了,结果显示如下： 
感谢您注册 Android 地图 API
密钥！ 您的密钥是： XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 我IE打开的时候是乱码，不知道是不是自己电脑有问题。后来改用了chrome就正常显示了。
到此，我们就完成了API Key的申请了，记录下Key值，在后续开发中使用。（放在layout中加入的MapView中）

喜欢0 评分0

GIS麦田守望者，期待与您交流。

举报回复

gis

管理员

注册日期2003-07-16
发帖数15951
QQ
铜币25345枚
威望15368点
贡献值0点
银元0个

加关注写私信

1楼^#

发布于：2012-09-12 09:49

二.Google Map API的使用
Android中定义了一个名为com.google.android.map的包，其中包含了一系列用于在google
map上显示、控制和叠层信息的功能类，以下是该包中最重要的几个类：
1.MapActivity：这个类是用于显示Google
Map的Activity类，它需要连接底层网络。MapActivity是一个抽象类，任何想要显示MapView的activity都需要派生自MapActivity，并且在其派生类的onCreate（）中，都要创建一个MapView实例。
2.MapView：MapView是用于显示地图的View组件。它派生自android.view.ViewGroup。它必须和MapActivity配合使用，而且只能被MapActivity创建，这是因为MapView需要通过后台的线程来连接网络或者文件系统，而这些线程需要有MapActivity来管理。
3.MapController：MapController用于控制地图的移动、缩放等。
4.OverLay:这是一个可显示于地图之上的可绘制的对象。
5.GeoPoint：这是一个包含经纬度位置的对象。

GIS麦田守望者，期待与您交流。

举报回复喜欢评分

gis

管理员

注册日期2003-07-16
发帖数15951
QQ
铜币25345枚
威望15368点
贡献值0点
银元0个

加关注写私信

2楼^#

发布于：2012-09-12 09:49

三.实例开发
1.创建工程，注意SDK旋转为"Goolge APIs”
2.修改AndroidManifest.xml文件
由于使用Google Map API，所以必须添加<uses-library
android:name="com.google.android.maps" />
由于需要从网络获取地图数据，所以需要访问网络的权限<uses-permission
android:name="android.permission.INTERNET"/>
可能还需要添加其他权限。
例如：
<div class="cnblogs_code"><img id="code_img_closed_0288e3e5-6938-4b0c-8cbd-0329ea78eba4" class="code_img_closed" src="http://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif"/><img style="display: none;" id="code_img_opened_0288e3e5-6938-4b0c-8cbd-0329ea78eba4" class="code_img_opened" src="http://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif"/>AndroidManifest.xml
<div id="cnblogs_code_open_0288e3e5-6938-4b0c-8cbd-0329ea78eba4" class="cnblogs_code_hide"><pre><div><?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.yarin.android.Examples_09_03" android:versionCode="1" android:versionName="1.0"> <application android:icon="@drawable/icon" android:label="@string/app_name"> <uses-library android:name="com.google.android.maps" /> <activity android:name=".Activity01" 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> <uses-permission android:name="android.permission.INTERNET" /> <uses-sdk android:minSdkVersion="5" /> </manifest> </div></pre></div></div>
3.创建MapView
要显示地图，需要创建一个MapView，在Xml文件中的布局如下。其中的android：apiKey的值就是我们第一步申请的Key了。
<div class="cnblogs_code"><img id="code_img_closed_3550069a-a772-41db-bbb8-593c9417e65a" class="code_img_closed" src="http://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif"/><img style="display: none;" id="code_img_opened_3550069a-a772-41db-bbb8-593c9417e65a" class="code_img_opened" src="http://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif"/>main.xml
<div id="cnblogs_code_open_3550069a-a772-41db-bbb8-593c9417e65a" class="cnblogs_code_hide"><pre><div><?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" > <com.google.android.maps.MapView android:id="@+id/MapView01" android:layout_width="fill_parent" android:layout_height="fill_parent" android:apiKey="0AubmfALdupLSlQkE67OTXgcQgWtyhXcO7uhsIQ"/> </RelativeLayout> </div></pre></div></div>
当然，可以在程序中通过如下代码来创建MapView：
MapView map = new MapView( this, "(android maps api key)");
4.实现MapActivity
MapView需要由MapActivity来管理，所以程序部分应该继承自MapActivity类，必须实现isRouteDisplay方法。
MapView提供了3中模式的地图，分别可以通过以下方式设置采用什么模式来显示地图。
 mMapView.setTraffic(true); //设置为交通模式 
 
 mMapView.setSatellite(true); //设置为卫星模式// 
 mMapView.setStreetView(false)； //设置为街景模式
通过setBuiltZoomControls方法设置地图是否支持缩放。

GIS麦田守望者，期待与您交流。

举报回复喜欢评分

gis

管理员

注册日期2003-07-16
发帖数15951
QQ
铜币25345枚
威望15368点
贡献值0点
银元0个

加关注写私信

3楼^#

发布于：2012-09-12 09:50

5.MapController的使用
如果需要设置地图显示的地点以及放大倍数等，就需要使用MapController来控制地图。可以通过如下代码获得MapController对象：
mMapController = mMapView.getController(); 
要定位地点，需要构造一个GeoPoint来表示地点的经纬度，然后使用animateTo方法将地图定位到指定的GeoPoint上，代码如下：
<div class="cnblogs_code"><pre><div>//设置起点为成都 mGeoPoint = new GeoPoint((int) (30.659259 * 1000000), (int) (104.065762 * 1000000)); //定位到成都 mMapController.animateTo(mGeoPoint); </div></pre></div>
6.Ovelay的使用
如果需要在地图上标注一些图标文字等信息，就需要使用Overlay。这里我们首先要将地图上的经度和纬度转换成屏幕上的实际坐标，才能将信息绘制上去。Map
API中提供了Projection.toPixels(GeoPoint in，GeoPoint out)方法，可以将经度和纬度转换成屏幕上的坐标。
首先需要实现OverLay中的draw方法才能在地图上绘制信息，代码如下：
<div class="cnblogs_code">
<div class="cnblogs_code_toolbar"><a title="复制代码" href="javascript:void(0);"><img alt="复制代码" src="http://common.cnblogs.com/images/copycode.gif"/></a></div><pre><div>class MyLocationOverlay extends Overlay { @Override public boolean draw(Canvas canvas, MapView mapView, boolean shadow, long when) { ........ } }</div></pre>
<div class="cnblogs_code_toolbar"><a title="复制代码" href="javascript:void(0);"><img alt="复制代码" src="http://common.cnblogs.com/images/copycode.gif"/></a></div></div>
综合上面的代码如下
<div class="cnblogs_code"><img style="display: none;" id="code_img_closed_aaf5680f-5043-4830-a078-34709a85dd77" class="code_img_closed" src="http://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif" jquery170732355308663331="2"/><img id="code_img_opened_aaf5680f-5043-4830-a078-34709a85dd77" class="code_img_opened" src="http://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif"/>Activity01.java
<div style="display: block;" id="cnblogs_code_open_aaf5680f-5043-4830-a078-34709a85dd77" class="cnblogs_code_hide" jquery170732355308663331="1">
<div class="cnblogs_code_toolbar"><a title="复制代码" href="javascript:void(0);"><img alt="复制代码" src="http://common.cnblogs.com/images/copycode.gif"/></a></div><pre><div>import java.util.List; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.graphics.Canvas; import android.graphics.Paint; import android.graphics.Point; import android.os.Bundle; 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.Overlay; public class Activity01 extends MapActivity { private MapView mMapView; private MapController mMapController; private GeoPoint mGeoPoint; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); mMapView = (MapView) findViewById(R.id.MapView01); //设置为交通模式 // mMapView.setTraffic(true); //设置为卫星模式 // mMapView.setSatellite(true); //设置为街景模式 mMapView.setStreetView(false); //取得MapController对象(控制MapView) mMapController = mMapView.getController(); mMapView.setEnabled(true); mMapView.setClickable(true); //设置地图支持缩放 mMapView.setBuiltInZoomControls(true); //设置起点为成都 mGeoPoint = new GeoPoint((int) (30.659259 * 1000000), (int) (104.065762 * 1000000)); //定位到成都 mMapController.animateTo(mGeoPoint); //设置倍数(1-21) mMapController.setZoom(15); //添加Overlay，用于显示标注信息 MyLocationOverlay myLocationOverlay = new MyLocationOverlay(); List<Overlay> list = mMapView.getOverlays(); list.add(myLocationOverlay); } protected boolean isRouteDisplayed() { return false; } class MyLocationOverlay extends Overlay { @Override public boolean draw(Canvas canvas, MapView mapView, boolean shadow, long when) { super.draw(canvas, mapView, shadow); Paint paint = new Paint(); Point myScreenCoords = new Point(); // 将经纬度转换成实际屏幕坐标 mapView.getProjection().toPixels(mGeoPoint, myScreenCoords); paint.setStrokeWidth(1); paint.setARGB(255, 255, 0, 0); paint.setStyle(Paint.Style.STROKE); Bitmap bmp = BitmapFactory.decodeResource(getResources(), R.drawable.home); canvas.drawBitmap(bmp, myScreenCoords.x, myScreenCoords.y, paint); canvas.drawText("天府广场", myScreenCoords.x, myScreenCoords.y, paint); return true; } } }</div></pre></div></div>

GIS麦田守望者，期待与您交流。

举报回复喜欢评分

niuniu88 路人甲注册日期2012-12-11 发帖数1 QQ 铜币102枚威望0点贡献值0点银元0个加关注写私信	4楼^# 发布于：2012-12-11 17:00 不错，有用
	举报回复(0) 喜欢(0) 评分

您需要登录后才可以回帖，登录或者注册

Android Google Map API 开发基础知识

最新喜欢：