Android-- 集成谷歌地图

引言

项目需求需要在谷歌地图：

地图展示，设备点聚合，设备站点，绘制点和区域等功能。

我只针对我涉及到的技术做一下总结，希望能帮到开始接触谷歌地图的伙伴们。

集成步骤

1、在项目的modle的build.gradle中添加依赖如下：

    implementation 'com.google.android.gms:play-services-maps:12.0.1'//    地图操作工具类，添加标记等implementation 'com.google.maps.android:android-maps-utils:0.5+'

2、集成完了后，需要展示地图，这里由于谷歌地图是已经被屏蔽，需要翻墙操作才能展示。

①首先我们要注册一个谷歌账号

②使用谷歌账号登录谷歌地图开发者平台（登录网站：https://cloud.google.com/maps-platform/?hl=zh-CN），点击控制台，如图

点击控制进入控制台进行如下操作，生成谷歌地图的appkey：

点击API秘钥，生成秘钥，在生成的秘钥界面上我们点击秘钥限制，设置成android ，点击确定就生成了我们所需的appkey。

将生成的API密钥复制并粘贴到您的Android应用程序的相应位置，通常在AndroidManifest.xml中的<application>标签内，如下所示：

<application><!-- 其他配置 --><meta-dataandroid:name="com.google.android.geo.API_KEY"android:value="YOUR_GOOGLE_MAPS_API_KEY"/><!-- 其他配置 -->
</application>

替换YOUR_GOOGLE_MAPS_API_KEY为您从Google Developers Console获得的API密钥。

请注意，您需要为调试和发布版本获取不同的密钥，并为每种版本使用正确的SHA-1证书指纹。

项目开发

地图展示

　向应用中添加Google Map组件有两种基本的方式:

1、一种是利用MapFragment（Fragment的子类，内部集成GoogleMap）

2、另一种是用MapView（View的子类，内部集成GoogleMap）。

一、MapFragment

1.地图展示：分为两加载地图：

一种是在activity中动态或者是静态加载我们的谷歌地图的fragment，进行显示。

静态加载

首先说一下在activity中静态加载地图的fragment。核心代码如下：

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"android:id="@+id/map"android:name="com.google.android.gms.maps.SupportMapFragment"android:layout_width="match_parent"android:layout_height="match_parent"tools:context="com.example.googlemapdemo.MapsMarkerActivity" />

class MapsMarkerActivity : AppCompatActivity() , OnMapReadyCallback {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment?mapFragment!!.getMapAsync(this)}override fun onMapReady(map : GoogleMap?) {}
}

这样一张谷歌地图就展示出来，显示的原因是通过mapFragment.getMapAsync()方法映射注册回调地图监听（因为谷歌地图被屏蔽了，所以需要翻墙才能看到地图，如果没有翻墙，是空白一片，并且android手机里面必须安装谷歌三件套，否则也不能显示）。

动态加载

布局：

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"android:id="@+id/my_container"android:layout_width="match_parent"android:layout_height="match_parent"tools:context="com.example.googlemapdemo.MapsMarkerActivity" />

activity 代码：

创建一个MapFragment对象，并利用FragmentTransaction动态添加到指定的容器中：

class MapsMarkerActivity : AppCompatActivity() , OnMapReadyCallback {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)//        val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment?
//        mapFragment!!.getMapAsync(this)val fragmentManager = supportFragmentManagerval mapFragment = SupportMapFragment.newInstance()fragmentManager.beginTransaction().replace(R.id.map_container, mapFragment as Fragment ).commit()mapFragment.getMapAsync(this)}override fun onMapReady(map : GoogleMap?) {}
}

二、MapView

MapView是View的子类，只需要在布局文件中引用com.google.android.gms.maps.MapView定义一个MapView，然后在Activity初始化MapView，与普通的TextView等组件用法类似。

xml:

    //layout文件中的定义<com.google.android.gms.maps.MapViewandroid:id="@+id/mymap"android:layout_width="match_parent"android:layout_height="match_parent"/>

activity :

    //Activity中的初始化myMap = (MapView)findViewById(R.id.mymap);myMap.getMapAsync(this);//getMapAsync这个与MapFragment相同

需要特别注意的是，MapView中生命周期的方法必须与Activity生命周期的方法同步，即必须在Activity中的生命周期中调用MapView的生命周期函数。

@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);```````//其他的一些初始化myMap.onCreate(savedInstanceState);}@Overrideprotected void onResume() {super.onResume();myMap.onResume();}@Overrideprotected void onPause() {super.onPause();myMap.onPause();}@Overrideprotected void onDestroy() {super.onDestroy();myMap.onDestroy();}@Overridepublic void onLowMemory() {super.onLowMemory();myMap.onLowMemory();}@Overrideprotected void onSaveInstanceState(Bundle outState) {super.onSaveInstanceState(outState);myMap.onSaveInstanceState(outState);}

onMapReady

onMapReady()是一个回调方法，用于在地图准备就绪后获取初始坐标。

当地图准备就绪时，系统会调用该方法，并传入一个GoogleMap对象作为参数，开发者可以通过该对象进行地图相关的操作。

  @Overridepublic void onMapReady(GoogleMap googleMap) {mMap = googleMap;// 获取当前位置的经纬度if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {// 请求权限ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1);} else {// 获取到位置权限后，获取当前位置经纬度mMap.setMyLocationEnabled(true);LatLng latLng = new LatLng(mMap.getMyLocation().getLatitude(), mMap.getMyLocation().getLongitude());mMap.addMarker(new MarkerOptions().position(latLng).title("当前位置"));mMap.moveCamera(CameraUpdateFactory.newLatLng(latLng));}}

在onMapReady回调中，我们首先检查定位权限，如果已经授予，我们就启用地图上的位置指示（通过调用setMyLocationEnabled(true)），然后可以获取当前的位置（通过调用getMyLocation()），并在地图上设置一个标记（通过调用addMarker()）以及移动相机到当前位置（通过调用moveCamera()）。如果没有定位权限，我们请求权限，并在权限被授予后执行上述操作。

三、组件的初始化

当需要初始化Map的一些状态时，可以在xml属性中设置，也可以在java代码中设置。
　　

1.xml属性初始化
　　
　　在fragment或者MapView的xml布局中，都可以添加一些属性来初始化Map的状态。

<fragment xmlns:android="http://schemas.android.com/apk/res/android"xmlns:map="http://schemas.android.com/apk/res-auto"android:name="com.google.android.gms.maps.SupportMapFragment"android:id="@+id/map"android:layout_width="match_parent"android:layout_height="match_parent"map:cameraBearing="112.5"map:cameraTargetLat="-33.796923"map:cameraTargetLng="150.922433"map:cameraTilt="30"map:cameraZoom="13"map:mapType="normal"map:uiCompass="false"map:uiRotateGestures="true"map:uiScrollGestures="false"map:uiTiltGestures="true"map:uiZoomControls="false"map:uiZoomGestures="true"/>

GoogleMapOptions options = new GoogleMapOptions();
options.mapType(GoogleMap.MAP_TYPE_SATELLITE).compassEnabled(false).rotateGesturesEnabled(false).tiltGesturesEnabled(false);
//在实例化一个MapFragment对象时
MapFragment.newInstance(GoogleMapOptions options);
//或者MapView的构造函数中
MapView(Context, GoogleMapOptions)