Google Maps Android API V2使用及问题解决

移动开发 Android
Google Maps Android API 在2012年12月更新,其V2版摒弃了MapActivity,而采用MapFragment,从而可以更好的在Android中使用地图组件。本文详细介绍了如何使用这一新特性。

说明

因为Google Maps的API版本更新,之前的一些教程都是关于旧版本V1的,虽然Google说继续提供服务,但是不再提供API Key的申请。

而新的V2版本貌似改动还挺大。也没搜到国内有什么系统介绍的博客文章之类的(书肯定是来不及那么新了)。

断断续续折腾了大概半个月,因为对Android也不是特别熟悉,所以碰到这样那样的问题。

终于在昨天看见模拟器上跑的地图了。太感人了。

下面就主要说说要成功做成这一件事的流程吧。

因为肯定有时效性,所以打上一个时间戳:版本更新事件发生在2012年12月,而这篇博文目前的时间是2013年1月1日。

背景

一些相关的链接:

Google Maps Android API V1的介绍:

https://developers.google.com/maps/documentation/android/v1/mapkey?hl=zh-CN

Google Maps Android API v2的初步介绍:

https://developers.google.com/maps/documentation/android/

Introduction

https://developers.google.com/maps/documentation/android/intro

Getting Started

(本部分参考https://developers.google.com/maps/documentation/android/start

1.首先安装Google Play services SDK

Google Maps Android API是作为这个SDK的一部分发行的。

这个安装是通过Android SDK Manager进行,配置好之后的Eclipse上面应该有Android SDK Manager的图标,一般的SDK版本安装和更新都在这里进行。

安装和更新Extras下的Google Play services即可。

2.获取API key

获取Maps API key需要两样东西:应用的signing certificate和它的package name。

获取这个key之后,把它加在应用程序的AndroidManifest.xml文件里即可。

为应用获取一个key还是需要好几个步骤的,下面详细说明:

获取数字证书(digital certificate)信息

数字证书有Debug和Release两种,下面主要说Debug的。

要获取一个叫做SHA-1 fingerprint的东西,作为数字证书的一个简短代表。

这个指纹(fingerprint)是通过一个哈希算法得到的字符串,为了得到你的证书的SHA-1 fingerprint,首先要找到你的debug keystore 文件,文件名叫debug.keystore。

默认情况下它和虚拟机AVD存放在一起,win7下的路径是:C:\Users\your_user_name\.android\,也可以通过Eclipse中的Windows > Prefs > Android > Build来查看这个路径。

然后,在cmd命令行里运行下列命令:

keytool -list -v -keystore "C:\Users\your_user_name\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

就显示一大堆东西,其中就有证书指纹:

SHA1那一行就包含了证书的SHA-1 fingerprint,是二十段用冒号割开的数字段,每段是两个十六进制的数。

在Google APIs Console上创建API Project

在Google APIs Console上创建项目,并且注册Maps API。

首先,去这个网址:https://code.google.com/apis/console/

用Gmail的账户登录,如果是第一次的话,需要创建项目,默认情况会创建一个叫做API Project的项目。

点击左边的Services,会在中间看到很多的APIs和Services,找到Google Maps Android API v2,然后把它设置成on,需要接受一些服务条款。

获得API Key

在左边的导航条中选择API Access。

在出来的页面中选择Create New Android Key...就可以生成key了:

Google Maps Android API V2使用及问题解决

然后在对话框中填入:SHA-1 指纹, 分号隔开,然后是应用的 package name.然后就会生成一个Key。

比如:

Google Maps Android API V2使用及问题解决

3.把API Key加入应用程序

首先,建立虚拟设备AVD和应用程序。

关于AVD,官方文档并没详细介绍,我后面会有说明。

建立好应用程序,注意包名应该和申请key时候的包名一致。

之后修改AndroidManifest.xml文件:

3.1.在<application>元素中加入子标签

  1. <meta-data 
  2.  
  3.     android:name="com.google.android.maps.v2.API_KEY" 
  4.  
  5.     android:value="your_api_key"/> 

3.2.加入一些许可信息

  1. <permission 
  2.           android:name="com.example.mapdemo.permission.MAPS_RECEIVE" 
  3.           android:protectionLevel="signature"/> 
  4.         <uses-permission android:name="com.example.mapdemo.permission.MAPS_RECEIVE"/> 

其中com.example.mapdemo换成自己的包名。

 

4. AndroidManifest.xml中的其他具体设置

许可设置

<uses-permission> 作为<manifest> 的子元素,需要加入下列一些:

  1. <uses-permission android:name="android.permission.INTERNET"/> 
  2. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 
  3. <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/> 
  4. <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> 
  5. <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> 

OpenGL ES V2特性支持

    同样也是作为<manifest> 的子元素。

  1. <uses-feature  
  2.   android:glEsVersion="0x00020000"  
  3.   android:required="true"/> 

5.加上地图

首先布局文件:

  1. <?xml version="1.0" encoding="utf-8"?> 
  2. <fragment xmlns:android="http://schemas.android.com/apk/res/android" 
  3.   android:id="@+id/map" 
  4.   android:layout_width="match_parent" 
  5.   android:layout_height="match_parent" 
  6.   class="com.google.android.gms.maps.MapFragment"/> 

然后在MainActivity.java:

  1. MainActivity.java 
  2.  
  3. package com.example.mapdemo;  
  4.   
  5. import android.app.Activity;  
  6. import android.os.Bundle;  
  7.   
  8. public class MainActivity extends Activity {  
  9.   
  10.     @Override  
  11.     protected void onCreate(Bundle savedInstanceState) {  
  12.         super.onCreate(savedInstanceState);  
  13.         setContentView(R.layout.main);  
  14.     }  

遇到的问题和解决的方法

程序编译错误,显示找不到一些类

如图:

Google Maps Android API V2使用及问题解决

解决这个问题,首先需要把Google Play services的类库加载进来:

  在Eclipse里面选择:File > Import > Android > Existing Android Code Into Workspace然后点击Next.

  之后Browse..., 找到路径下的<android-sdk-folder>/extras/google/google_play_services /libproject/google-play-services_lib, 然后选择Finish。

第二步是添加对这个库的引用:

  在自己的项目上右键,选Properties,左边选Android,然后在下面的Library里面Add刚才的google-play-services_lib。

之后程序就应该能运行了。

接着你可能会碰到下面的问题:

程序运行成功,但是显示This app won't run unless you update Google Play services.

如图:

有传言说V2不能在AVD上运行,可能Google还会对此问题进行更新。

经过搜索,这个问题已经在Stackoverflow上被讨论过了,链接

所以看来在AVD上运行的问题已经被解决了。

解决的方法就是在AVD上安装两个包:vending.apk和gms.apk,(给一个网盘链接

并且AVD就选择普通的API 16就行,不需要是Google APIs。我选的是Android4.1 API16.

安装时把那两个包放在当前目录,用命令行安装:

之后运行程序,就出地图了:

责任编辑:徐川 来源: cnblogs
相关推荐

2013-08-13 10:59:03

Android Stu启动

2011-09-06 09:26:03

2010-06-12 13:49:50

Ubuntu 10.0

2011-02-23 13:48:05

Web

2013-03-04 14:24:58

Google Maps

2013-02-28 13:35:02

Google Maps

2011-08-18 18:46:24

SQL Server

2011-06-27 16:44:59

Qmake

2011-06-13 16:16:32

Qt 中文问题

2011-03-23 16:38:28

LAMP

2010-04-28 18:01:15

Unix系统

2010-06-17 11:35:24

Ubuntu 修复Gr

2011-08-03 11:07:01

布线管理软件

2011-09-05 18:57:36

MTKJ2ME

2010-05-05 10:25:24

Unix操作系统

2011-11-28 22:45:19

Nginxsession

2009-12-28 10:56:45

WPF Image

2012-05-09 10:08:41

跨机房

2010-05-05 14:20:46

AIX CDE

2011-01-21 14:13:10

点赞
收藏

51CTO技术栈公众号