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