說明

因?yàn)镚oogle Maps的API版本更新，之前的一些教程都是關(guān)于舊版本V1的，雖然Google說繼續(xù)提供服務(wù)，但是不再提供API Key的申請(qǐng)。

而新的V2版本貌似改動(dòng)還挺大。也沒搜到國(guó)內(nèi)有什么系統(tǒng)介紹的博客文章之類的（書肯定是來不及那么新了）。

斷斷續(xù)續(xù)折騰了大概半個(gè)月，因?yàn)閷?duì)Android也不是特別熟悉，所以碰到這樣那樣的問題。

終于在昨天看見模擬器上跑的地圖了。太感人了。

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

因?yàn)榭隙ㄓ袝r(shí)效性，所以打上一個(gè)時(shí)間戳：版本更新事件發(fā)生在2012年12月，而這篇博文目前的時(shí)間是2013年1月1日。

背景

一些相關(guān)的鏈接：

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是作為這個(gè)SDK的一部分發(fā)行的。

這個(gè)安裝是通過Android SDK Manager進(jìn)行，配置好之后的Eclipse上面應(yīng)該有Android SDK Manager的圖標(biāo)，一般的SDK版本安裝和更新都在這里進(jìn)行。

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

2.獲取API key

獲取Maps API key需要兩樣?xùn)|西：應(yīng)用的signing certificate和它的package name。

獲取這個(gè)key之后，把它加在應(yīng)用程序的AndroidManifest.xml文件里即可。

為應(yīng)用獲取一個(gè)key還是需要好幾個(gè)步驟的，下面詳細(xì)說明：

獲取數(shù)字證書（digital certificate）信息

數(shù)字證書有Debug和Release兩種，下面主要說Debug的。

要獲取一個(gè)叫做SHA-1 fingerprint的東西，作為數(shù)字證書的一個(gè)簡(jiǎn)短代表。

這個(gè)指紋（fingerprint）是通過一個(gè)哈希算法得到的字符串，為了得到你的證書的SHA-1 fingerprint，首先要找到你的debug keystore 文件，文件名叫debug.keystore。

默認(rèn)情況下它和虛擬機(jī)AVD存放在一起，win7下的路徑是：C:\Users\your_user_name\.android\，也可以通過Eclipse中的Windows > Prefs > Android > Build來查看這個(gè)路徑。

然后，在cmd命令行里運(yùn)行下列命令：

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

就顯示一大堆東西，其中就有證書指紋：

SHA1那一行就包含了證書的SHA-1 fingerprint，是二十段用冒號(hào)割開的數(shù)字段，每段是兩個(gè)十六進(jìn)制的數(shù)。

在Google APIs Console上創(chuàng)建API Project

在Google APIs Console上創(chuàng)建項(xiàng)目，并且注冊(cè)Maps API。

首先，去這個(gè)網(wǎng)址：https://code.google.com/apis/console/

用Gmail的賬戶登錄，如果是第一次的話，需要?jiǎng)?chuàng)建項(xiàng)目，默認(rèn)情況會(huì)創(chuàng)建一個(gè)叫做API Project的項(xiàng)目。

點(diǎn)擊左邊的Services，會(huì)在中間看到很多的APIs和Services，找到Google Maps Android API v2，然后把它設(shè)置成on，需要接受一些服務(wù)條款。

獲得API Key

在左邊的導(dǎo)航條中選擇API Access。

在出來的頁(yè)面中選擇Create New Android Key...就可以生成key了：

然后在對(duì)話框中填入：SHA-1 指紋， 分號(hào)隔開，然后是應(yīng)用的 package name.然后就會(huì)生成一個(gè)Key。

比如：

3.把API Key加入應(yīng)用程序

首先，建立虛擬設(shè)備AVD和應(yīng)用程序。

關(guān)于AVD，官方文檔并沒詳細(xì)介紹，我后面會(huì)有說明。

建立好應(yīng)用程序，注意包名應(yīng)該和申請(qǐng)key時(shí)候的包名一致。

之后修改AndroidManifest.xml文件：

3.1.在<application>元素中加入子標(biāo)簽

<meta-data 
 
    android:name="com.google.android.maps.v2.API_KEY" 
 
    android:value="your_api_key"/> 

3.2.加入一些許可信息

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

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

4. AndroidManifest.xml中的其他具體設(shè)置

許可設(shè)置

<uses-permission> 作為<manifest> 的子元素，需要加入下列一些：

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

OpenGL ES V2特性支持

    同樣也是作為<manifest> 的子元素。

<uses-feature  
  android:glEsVersion="0x00020000"  
  android:required="true"/> 

5.加上地圖

首先布局文件：

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

然后在MainActivity.java：

MainActivity.java 
 
package com.example.mapdemo;  
  
import android.app.Activity;  
import android.os.Bundle;  
  
public class MainActivity extends Activity {  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.main);  
    }  
} 

遇到的問題和解決的方法

程序編譯錯(cuò)誤，顯示找不到一些類

如圖：

解決這個(gè)問題，首先需要把Google Play services的類庫(kù)加載進(jìn)來：

　　在Eclipse里面選擇：File > Import > Android > Existing Android Code Into Workspace然后點(diǎn)擊Next.

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

第二步是添加對(duì)這個(gè)庫(kù)的引用：

　　在自己的項(xiàng)目上右鍵，選Properties，左邊選Android，然后在下面的Library里面Add剛才的google-play-services_lib。

之后程序就應(yīng)該能運(yùn)行了。

接著你可能會(huì)碰到下面的問題：

程序運(yùn)行成功，但是顯示This app won't run unless you update Google Play services.

如圖：

有傳言說V2不能在AVD上運(yùn)行，可能Google還會(huì)對(duì)此問題進(jìn)行更新。

經(jīng)過搜索，這個(gè)問題已經(jīng)在Stackoverflow上被討論過了，鏈接

所以看來在AVD上運(yùn)行的問題已經(jīng)被解決了。

解決的方法就是在AVD上安裝兩個(gè)包：vending.apk和gms.apk，（給一個(gè)網(wǎng)盤鏈接）

并且AVD就選擇普通的API 16就行，不需要是Google APIs。我選的是Android4.1 API16.

安裝時(shí)把那兩個(gè)包放在當(dāng)前目錄，用命令行安裝：

之后運(yùn)行程序，就出地圖了：