Android地图中间件——如何去适配业务需求中的多种地图

GitHub链接：https://github.com/yellowgreatsun/MXMapAdapter

一、Android地图中间件介绍

Android地图中间件，是一套适配多种地图的中间层接口。
目前，GitHub上library库已经适配了高德地图、百度地图。
已经适配的接口，包括地图显示（MapView和MapFragment两种形式）、绘制Marker和Poyline、室内地图、手机定位等。
适配的地图厂商、地图接口，后续会不断完善。

二、应用场景

业务中需要支持多种地图厂商。
这时，业务流程中只需要调用中间件中接口即可。所有的适配工作交由中间件去处理。
如果你的业务中只需要支持一种地图厂商，那么不必集成中间件，直接调用该地图厂商的sdk接口即可。
而我们的业务重度依赖地图，并且由于业务需求先后集成了高德地图、百度地图、GoogleMap、Here地图、MapBox，就必须依靠中间件去完成对各种地图的适配。

三、设计思路

简洁一点，就是“抽象”，如何在复杂且多变的业务需求中，抽离出其技术模型，以更灵活、高效地实现业务需求。

具体一点，就是其技术模型，大致分为“业务层”、“业务实现层”和“服务层”。“业务层”是做什么，“业务实现层”是怎么做，“服务层”是为怎么做所提高的服务。举个例子，在Activity中添加一个地图Marker，那么，“业务层”就是一行addMarker代码（Activity中），“业务实现层”就是对addMarker的业务实现（util或者presenter中），“服务层”就是map中如何addMarker(library中)。

地图中间件，就是位于“服务层”的进一步抽离。如果没有集成多种地图厂商的需求，“服务层”其实也就是他们的地图SDK了。有了这种需求，就抽出一套适合我们自己的接口，并完成各种地图的适配，具体结构如下图：

Android地图中间件.png

代码结构如下图：

Android地图中间件代码结构.png

api包就是Map中间件接口，业务层调用的地图接口都来自这里。amapimpl和bdmapimpl分别是高德地图、百度地图的实现。
具体使用哪种地图，我添加了一个MXMapManager来进行管理，业务层调用它提供的接口来传入地图厂商。

四、调用示例

具体参考demo中实现。
比如初始化地图：

private void initMap(Bundle savedInstanceState) {
    mMXMapView = MXMapManager.getInstance().getMXMapView(Constant.MAP_PROVIDER); //传入地图厂商
    View mapView = mMXMapView.createMapView(this);
    mMXMapView.onCreate(this, savedInstanceState);
    mMXMapView.createMap(mxMap -> {
      this.mMXMap = mxMap;
    });
    llParent.addView(mapView);
}

五、中间件实现思路

1.设计api

设计api时，需要结合业务需求、各地图厂商的sdk。因为各地图厂商的sdk不同接口的实现方式不完全一致，因为需要我们提供的接口，方便对各种地图去做适配。下面会在获取地图实例时具体提到。
地图显示：地图sdk中提供了两种形式，即MapView和MapFragment，这里不去比较二者的优劣，但我们要和他们保持一致，api也提供这两种形式，也就是MXMapView和MXMapFragment。这里，我们获取地图实例，是通过回调实现的。为什么这样呢？如果你熟悉高德地图sdk、百度sdk的话，它俩都是直接调用类似于getMap的形式来获取的，为什么我要多此一举呢，因为GoogleMap中获取地图实例就是回调，我设计为通过回调这种形式，就可以满足适配三者的需求。

    void createMap(OnMapReadyCallback onMapReadyCallback);
    interface OnMapReadyCallback {
        void onMapReady(MXMap mxMap);
    }

地图功能：也就是地图操作类（地图设置、中心点、缩放、比例尺等）、添加Marker和Poyline，OK，我们也在MXMap中提供这些借口。
手机定位：也就是定位设置、开始定结束定位、定位回调这些。
地图工具：各地图厂商的sdk中均提供了计算距离、面积这些接口，恰好我们业务中也有需求，于是就在MXMapUtils中作添加。

2.api实现

这一步，就是调用各地图sdk的接口，把api中功能进行实现。

3.抽取bean

在api实现中，有部分接口，需要传参比较多，比如绘制Marker。并且，如果需求变更，我可能还需要增加参数。
这时，设计一层bean就有必要了。
我目前一共设计了5个bean：

Android地图中间件bean.png

4.manager管理

前文已经说了，主要就是传入究竟使用哪种地图。

Android地图中间件manager.png