Android Google Map API 开发基础知识

最新推荐文章于 2022-06-07 17:44:52 发布

RaleighLuo

最新推荐文章于 2022-06-07 17:44:52 发布

阅读量598

点赞数

分类专栏：地图

地图专栏收录该内容

5 篇文章 0 订阅

订阅专栏

开发基于谷歌地图的应用和普通的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.

打开浏览器，输入网址：http://code.google.com/android/maps-api-signup.html，填入你的认证指纹(MD5)即可获得apiKey了,结果显示如下：

感谢您注册 Android 地图 API 密钥！
您的密钥是：
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
我IE打开的时候是乱码，不知道是不是自己电脑有问题。后来改用了chrome就正常显示了。

到此，我们就完成了API Key的申请了，记录下Key值，在后续开发中使用。（放在layout中加入的MapView中）

二.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：这是一个包含经纬度位置的对象。

三.实例开发

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"/>

可能还需要添加其他权限。

例如：

 
 
  
  <?
  
  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
  
  >

3.创建MapView

要显示地图，需要创建一个MapView，在Xml文件中的布局如下。其中的android：apiKey的值就是我们第一步申请的Key了。

   
   
    
    <?
    
    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
    
    >

当然，可以在程序中通过如下代码来创建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方法设置地图是否支持缩放。

5.MapController的使用

如果需要设置地图显示的地点以及放大倍数等，就需要使用MapController来控制地图。可以通过如下代码获得MapController对象：

mMapController = mMapView.getController();

要定位地点，需要构造一个GeoPoint来表示地点的经纬度，然后使用animateTo方法将地图定位到指定的GeoPoint上，代码如下：

  
  
   
   //
   
   设置起点为成都
   
   

   
   mGeoPoint 
   
   =
   
    
   
   new
   
    GeoPoint((
   
   int
   
   ) (
   
   30.659259
   
    
   
   *
   
    
   
   1000000
   
   ), (
   
   int
   
   ) (
   
   104.065762
   
    
   
   *
   
    
   
   1000000
   
   ));

   
   //
   
   定位到成都
   
   

   
   mMapController.animateTo(mGeoPoint);

6.Ovelay的使用

如果需要在地图上标注一些图标文字等信息，就需要使用Overlay。这里我们首先要将地图上的经度和纬度转换成屏幕上的实际坐标，才能将信息绘制上去。Map API中提供了Projection.toPixels(GeoPoint in，GeoPoint out)方法，可以将经度和纬度转换成屏幕上的坐标。

首先需要实现OverLay中的draw方法才能在地图上绘制信息，代码如下：

  
  
   
   class
   
    MyLocationOverlay 
   
   extends
   
    Overlay
{
     @Override
     
   
   public
   
    
   
   boolean
   
    draw(Canvas canvas, MapView mapView, 
   
   boolean
   
    shadow, 
   
   long
   
    when)
     {
             ........
     }
}

综合上面的代码如下

 
 
  
  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
  
  ;
        }
    }
}

RaleighLuo

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Android Google Map API 开发基础知识

开发基于谷歌地图的应用和普通的android应用差不多都要使用它提供给我们的类库，所不同的是google map的类库不是android平台的基本类库，是google api的一部分，所以建立项目时，SDK要选择Google APIs；还有一点，开发基于地图的应用时候需要使用google map的APIkey，必须先申请key，然后才能开发基于地图的应用。下边分步骤记录下，整个过程：
复制链接

扫一扫