Google Maps Android API v2 (3)- 地图添加到Android应用程序

添加地图的基本步骤是：

1. （一旦）按照以下步骤[入门] [开始]，获得API，获取密钥所需的属性，并添加到您的Android清单。
2. 添加一个碎片对象 要处理地图的活动。做到这一点最简单的方法是增加一个 <fragment>元素的布局文件的活动
3. 在活动对象 的onCreate（） 方法，得到了手柄在MapFragment的GoogleMap的对象的 。GoogleMap的对象是地图本身的内部表示，设置地图视图选项，您可以修改其GoogleMap的对象。
4. 最后一步是添加到您的应用程序的清单，权限和其他设置AndroidManifest.xml文件。

一旦你已经按照这些步骤，你可以设置GoogleMap的对象的初步方案 。的的 自动MapFragment显示地图的onCreate（） 方法完成 。

添加一个片段

要定义一个片段对象在一个活动的布局文件，添加一个<fragment>元素。在这个元素，设置的Android版 ​​本：名称属性为“com.google.android.gms.maps.MapFragment”的。自动一个MapFragment附加 活动。

例如，下面的布局文件包含一个<fragment>的元素：

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

您也可以一个MapFragment添加到 代码活动。要做到这一点，创建一个新MapFragment 实例，然后调用 FragmentTransaction.add（）的片段添加到当前的 活动

 mMapFragment =MapFragment.newInstance();
 FragmentTransaction fragmentTransaction =
         getFragmentManager().beginTransaction();
 fragmentTransaction.add(R.id.my_container, mMapFragment);
 fragmentTransaction.commit();

添加地图代码

在你的代码中要使用的地图，开始通过设置布局文件内容的活动。例如，如果布局文件的名称main.xml中，使用此代码：

publicvoid onCreate(Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

接下来，获得一个句柄地图调用 FragmentManager.findFragmentById（） ，传递给它的资源ID的<fragment>你在上一步中添加的元素。返回值转换到 GoogleMap的。例如，以下行提出的句柄变量MMAP地图：

privateGoogleMap mMap;
...
mMap =((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();

，资源ID R.id.map的通知会自动加入到Android项目时，您构建的布局文件。

为MapFragment的GoogleMap的对象的 手柄，你可以设置地图的初步方案。

验证地图的可用性

之前，你可以互动与GoogleMap的对象，你需要确认一个对象可以被实例化，和谷歌播放服务组件是否正确安装在目标设备上。可以验证，GoogleMap的是可通过调用MapFragment.getMap（）或 MapView.getMap（）方法，并检查返回的对象是不是null。

一个测试，以确定可用的一个GoogleMap的一个例子如下所示。此方法可以被调用的onCreate（）和onResume（） 阶段，以确保在地图总是可用的。

privatevoid setUpMapIfNeeded(){
    // Do a null check to confirm that we have not already instantiated the map.
    if(mMap ==null){
        mMap =((MapFragment) getFragmentManager().findFragmentById(R.id.map))
                            .getMap();
        // Check if we were successful in obtaining the map.
        if(mMap !=null){
            // The Map is verified. It is now safe to manipulate the map.

        }
    }
}