Android:Google Map API

Android:Google Map API

开发基于谷歌地图的应用和普通的android应用差不多都要使用它提供给我们的类库,所不同的是google map的类库不是android平台的基本类库,是google api的一部分,所以建立项目时,SDK要选择Google APIs;本文转载自上海java培训官网。

还有一点,开发基于地图的应用时候需要使用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 debugkeystore的值便是debug.keystore的路径了。(默认位置: C:\Documents and Settings\Administrator\.android)

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了,

页面跳至https://accounts.google.com/ServiceLogin?service=androiddeveloper&passive=true&nui=1&continue=http://www.google.com/glm/mmap/a/api?fp%3D20%253AF1%253A0C%253AF4%253A37%253A11%253AF4%253AB9%253A34%253A31%253A4D%253A2E%253ADD%253ADB%253A01%253A1B&followup=http://www.google.com/glm/mmap/a/api?fp%3D20%253AF1%253A0C%253AF4%253A37%253A11%253AF4%253AB9%253A34%253A31%253A4D%253A2E%253ADD%253ADB%253A01%253A1B,注册或登录谷歌账户,

结果显示如下:

感谢您注册 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-libraryandroid:name="com.google.android.maps" />

由于需要从网络获取地图数据,所以需要访问网络的权限<uses-permissionandroid:name="android.permission.INTERNET"/>

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

例如:

AndroidManifest.xml

<?xmlversion="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" />
                <categoryandroid: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了。

main.xml

<?xmlversion="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)
     {
             ........
     }
}

综合上面的代码如下:

Activity01.java

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

 

补充案例:地理位置反编码(通过地名查找经纬度)

public GeoPoint getGeoPoint(String adr) {

 

       GeoPoint geo=null;

       if(!adr.equals(""))

       {

          

           try {

              //对中文地址,用uft-8进行编码

              String address=URLEncoder.encode(adr, "UTF-8");

              String url = "http://maps.google.com/maps/api/geocode/json?address="+address+"&sensor=false";

              HttpGet get = new HttpGet(url);

              HttpClient client = new DefaultHttpClient();

              HttpResponse response = client.execute(get);

              if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {

                  String result = EntityUtils.toString(response.getEntity());

   

                  Double lon = new Double(0);

                  Double lat = new Double(0);

   

                  JSONObject jsonObject = new JSONObject(result);

                  lon = ((JSONArray) jsonObject.get("results")).getJSONObject(0)

                         .getJSONObject("geometry").getJSONObject("location")

                         .getDouble("lng");

   

                  lat = ((JSONArray) jsonObject.get("results")).getJSONObject(0)

                         .getJSONObject("geometry").getJSONObject("location")

                         .getDouble("lat");

                 

                  geo=new GeoPoint((int) (lat * 1E6), (int) (lon * 1E6));

                  return geo;

              }            

   

           } catch (Exception e) {}       

       }

       return geo;

    }

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值