Google Map API v2 步步为营（一） ----- 初见地图

官方文档：https://developers.google.com/maps/documentation/android/start?hl=zh-CN

先谷歌后百度。使用google的api基本上按照官网来就好了，开发过程中遇到各种各样的问题，其实仔细看官方文 都能找到解决方法的。这篇文主要是让自己回顾总结一下。

Google Map API v2 相对v1变化了不少，千万别拿着v1的攻略做v2。

 

step1  准备工作：

1，需要安装两个东西，Google Play services SDK 和 Google APIs。

打开Android SDK Manager，拖到最底下找到Extras文件夹，展开，找到Google Play services，安装。

Google Play services 将安装到android SDK path下，我的目录是~/develop/android-sdk-linux/extras/google/google_play_services/

我用的是API 15（4.0.3），到对应的目录下展开，安装Google APIs。

2，导入Google Play services

File > Import,  选择Android > Existing Android Code into Workspace，找到

~/develop/android-sdk-linux/extras/google/google_play_services/libproject/google-play-services_lib/。

导入之后在eclipse里就能看到google-play-services_lib工程，如果eclipse里设置了build automatically，就会自动编译，要确保gen目录下有生成com.google.android.gms这个包，否则后面的步骤会报错。

3，按正常步骤建立自己的android project，把google-play-services_lib加入到Dependencies的库中。

在左边的Package Expolorer视窗中找到自己的project，鼠标右键，选择Properties，左边导航栏选Android，右边子窗口里找到Library，点Add，打开project selection窗口，选择google-play-services_lib，点Ok。

 

 加入后

点OK。

回到工作区，包目录下可以看到多了两个dependence的包

4，调试环境

手机上需要安装Google服务包（com.google.android.gms.apk）和Google Play Store（com.android.vending.apk）。

我没装google服务的framework，play store其实是用不了的，但是并不影响Google Map的使用。

如果使用模拟器，创建AVD的时候 target选择对应API level的Google APIs就行了。

准备工作结束。

 

step 2 申请KEY

使用google的东西都必须申请一个KEY，这个KEY是和 APK的包名 及 打apk包时所用的证书 绑定的。

1，先安装keytool

eclipse->Help->Install New Software，点Add，Name填写Keytool，Loction填http://www.keytool.sourceforge.net/update ，安装完成重启eclipse，菜单栏上多了Keytool菜单。

2，找到证书的SHA1

调试阶段通过eclipse的run和debug打包的apk，都是使用默认的debug证书，这个证书的位置在home目录的.android目录下。

eclipse->Keytool->Open keystore，文件路径输入/home/用户名/.android/debug.keystore，密码是debug证书的默认密码android

打开后窗口底部出现keytool视窗，列出刚刚选择的keystore，展开，双击打开androiddebugkey，找到SHA1 Fingerprint 复制下来。

也可以通过命令行查看key，keytool的命令行操作参考http://docs.oracle.com/javase/6/docs/technotes/tools/windows/keytool.html

3， 登陆Google APIs Console，创建KEY

用gmail账号登陆https://code.google.com/apis/console/?noredirect，新建一个project，左边导航视窗中选择Services，第一次加载可能会比较慢。

加载完后，右边窗口会出现google提供的所有服务，找到Google Maps Android API v2，把后面的trigger设置成ON，然后出现的各种协议选择accept。

导航视窗中选择API Access。点击按钮Create Android Key，弹出窗口中填写 “SHA1;包名”，create成功，返回API Access窗口就能看到Key for Android apps，把API key栏的一串字符复制下来。

 

step 3 可以开始codding了

1，修改manifest

回到eclipse，打开AndroidManifest.xml，在<manifest>根节点中设置地图访问许可

<!-- google map needed -->
<permission
   android:name="com.xxx.xxx.permission.MAPS_RECEIVE"
   android:protectionLevel="signature"/> 
<uses-permission android:name="com.xxx.xxx.permission.MAPS_RECEIVE"/>
<!-- google map needed -->

com.xxx.xxx是包名，注意这两句要加在<application></application>外面

其他需要的许可

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> <!-- 精确位置服务 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <!-- 位置服务 -->
<uses-permission android:name="android.permission.INTERNET"/> <!-- 网络服务 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <!-- 查询网络状态 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <!-- 写sd卡 google地图会往sd卡上写缓存数据-->
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/> <!-- 允许访问google的web服务 -->

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

申明要使用OpenGL ES，这一项是为了让不支持OpenGL的机器访问play store的时候略过这个apk。不写这一项也不影响调试。

在<application></application>节点中增加两个元数据：

<meta-data android:name="com.google.android.gms.version" 
            android:value="@integer/google_play_services_version" />
        
<meta-data android:name="com.google.android.maps.v2.API_KEY"
            android:value="@string/GOOGLE_MAP_API_KEY"/>

res/values/config.xml

<?xml version="1.0" encoding="utf-8"?>

<resources>
    <string translatable="false" name="GOOGLE_MAP_API_KEY">上一步中复制出来的API KEY</string>
    
</resources>

GOOGLE_MAP_API_KEY 的值就是step 2.3中申请的key。

 

2，MapsActivity.java

layout/map.xml

<?xml version="1.0" encoding="utf-8"?>

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    >
    <fragment 
        android:id="@+id/map_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:name="com.google.android.gms.maps.MapFragment"/>

    <RelativeLayout android:id="@+id/debug"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        >
        
    <TextView android:id="@+id/debug_loc_marked"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#f00"
        android:text="debug_loc_marked"
        android:layout_marginTop="0dip" />
    
    <TextView android:id="@+id/debug_loc_my"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#f00"
        android:text="debug_loc_my"
        android:layout_below="@id/debug_loc_marked" />
    </RelativeLayout>
</FrameLayout>

重点在7~11行，v2的地图是用Fragment来显示的

13~31行是两个用于调试的textview，显示标记所在的经纬度，及当前位置经纬度。

 

MapsActivity.java

先给一个简化版

public class MapsActivity extends Activity{

  public void onCreate(Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    setContentView(R.layout.map);
  }
}

OK，run一下

 本篇结束。上图中mark和地址获取需要额外的代码，下一篇进阶篇中再继续整理。