利用百度地图实现支付宝“到位”功能（地图模式）

今天我们要说的，支付宝的“到位”功能。新版支付宝上方第四个tab，传闻丈母娘足不出户，同城招女婿的神兵利器。反正上面那些一块钱看看花、逛逛街、喝喝酒的服务好单纯好不做作<(￣ˇ￣)/。
我是DEMO： https://github.com/CarGuo/LbsMap 用力戳♂起来。
到位的主要特色是地图加LBS功能，搜索周边的服务和帮忙，既然是地图，我们就站在百度的肩膀来开车吧：
百度地图的基本功能：地图，Marker，聚合。
百度地图的LBS功能。
图片Icon的下载与Marker更新。
1、基础地图功能
首先你得有个KEY，在百度地图API上注册为开发者后，你就可以创建一个应用，记得选Android类型，因为默认是服务器类型。
之后在AndroidManifest上加上下面这些（网络、定位权限的就不需要列出了吧），最后在APPlication中初始化SDKInitializer.initialize(this);，这样你的的MapView就可以跑起来啦！
<service    android:name="com.baidu.location.f"    android:enabled="true"    android:process=":remote" /><meta-data    android:name="api_key"    android:value="CirU5l4MGVbE59tOduYDCO6TDX27CPzV" /><meta-data    android:name="com.baidu.lbsapi.API_KEY"    android:value="CirU5l4MGVbE59tOduYDCO6TDX27CPzV" />
2、初始化地图
虽然用的是MapView，但是实际上操作的，是MapView里面的BaiduMap。
下方长♂代码走起，流程是：比例尺；不要倾角；不要旋转；设置最大和最小的缩放层级；初始化聚合管理器（后面都是他的事情）；Marker（地图上对应的item）管理器；设置显示位置的图标； 初始化我们需要的搜索Model（经纬度，半径，表id）用与保存搜索状态。是不是很简单，哇塞，我有一个地图了。
mBaiduMap = mBaiduMapView.getMap();// 比例尺控件mBaiduMapView.showScaleControl(true);// 缩放控件mBaiduMapView.showZoomControls(false);// 百度地图LoGo -> 正式版切记不能这么做，本人只是觉得logo丑了mBaiduMapView.removeViewAt(1);//不倾斜mBaiduMap.getUiSettings().setOverlookingGesturesEnabled(false);//不旋转mBaiduMap.getUiSettings().setRotateGesturesEnabled(false);//设置缩放层级mBaiduMap.setMaxAndMinZoomLevel(19, 12);//图标管理器mMarkerManager = new MarkerManager(mBaiduMap);//聚合与渲染管理器mClusterManager = new ClusterManager<>(this, mBaiduMap, mMarkerManager);mBaiduMap.setOnMapStatusChangeListener(mClusterManager);mBaiduMap.setOnMapLoadedCallback(this);mBaiduMap.setMyLocationEnabled(true);Bitmap bitmap = CommonUtil.getImageFromAssetsFile(DemoApplication.getApplication(), "current_location.png");//调整位置图片，类似百度地图的小蓝点float scale = 0.80f;Matrix matrix = new Matrix();matrix.postScale(scale, scale);mCLBitmap = Bitmap.createBitmap(bitmap, 0, 0, bitmap.getWidth(), bitmap.getHeight(), matrix, true);bitmap.recycle();BitmapDescriptor bitmapDescriptor = BitmapDescriptorFactory.fromBitmap(mCLBitmap);MyLocationConfiguration myLocationConfiguration = new MyLocationConfiguration(MyLocationConfiguration.LocationMode.NORMAL, false, bitmapDescriptor);mBaiduMap.setMyLocationConfigeration(myLocationConfiguration);//显示位置图标的builderMyLocationData locData = new MyLocationData.Builder()        .accuracy(0)        .direction(0).latitude(llat)        .longitude(llng).build();//显示位置图标-珠海mBaiduMap.setMyLocationData(locData);//显示等级-转换：初始化为mDefaultRadius半径的层级用于显示float level = LocationLevelUtils.returnCurZoom(mDefaultRadius);//当前地图状态mCurrentMapStatus = new MapStatus.Builder().target(new LatLng(llat, llng)).zoom(level).build();mBaiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(mCurrentMapStatus));//初始化数据搜索modelmSearchModel = new SearchModel();mSearchModel.setGps(llng + "," + llat);mSearchModel.setRadius(mDefaultRadius);mSearchModel.setLevel(level);mSearchModel.setTableId(DemoApplication.TABLE_ID());    
2、修改百度地图demo源码
初始化好地图，那么我们需要的是，在地图上显示图标，并且将临近的点聚合起来。百度地图的DEMO已经实现了这一点，但是还不够我们的需求，这是时候我们要修改Demo下，clusterutil路径下的类，针对聚合与Marker的显示做自定义处理。
1）、ClusterItem
这个接口代表着地图上一个item，但是的百度Demo还不够，所以在里面加入新接口，用于显示我们的自定图标，然后实现ClusterBaiduItem继承ClusterItem，将需要显示的经纬度和图标信息，保存在Item里。
/** * 网络的单个marker的实例 */BitmapDescriptor getUrlMarkerIconBitmapDescriptor(boolean select);/** * 网络的单个marker的icon路径 */String getUrlLocalMarkerIconPath();/** * 网络的单个聚合的icon路径 */String getUrlClusterIconPath();
2）、ClusterManager
这是聚合marker的管理器，内部有渲染类，将ICON渲染到地图上，同时也包含了地图状态变化的接口，这里我们把地图的状态变化接口回调出来，方便我们监听地图的移动和缩放。
同时对渲染类DefaultClusterRenderer也增加get接口，因为后面我们需要，在外部动态改变Marker的图标。地图上渲染出来的Marker在Render渲染类中，会以ClusterItem为KEY，缓存在MAP中。
//add myself 修改了地图状态变化的回调public BaiduMap.OnMapStatusChangeListener onMapStatusChangeListener;/** * add myself */public DefaultClusterRenderer<T> getDefaultClusterRenderer() {    return (DefaultClusterRenderer) mRenderer;}
3）、NonHierarchicalDistanceBasedAlgorithm
这个类主要关注MAX_DISTANCE_AT_ZOOM，它代表着多远的距离可以聚合，这里个人修改为200，反正我就不喜欢堆在一起╮(╯_╰)╭。
4）、DefaultClusterRenderer
这是大头，很大的头，默认渲染类，当然你可以自己实现，但是秉承着快速（懒）开发的原则，我是直接在上面修改的：
修改 makeClusterBackground方法，把其中的聚合背景效果，替换为我们自定义的背景效果 。
修改makeSquareTextView方法， 让聚合ICON显示的我们自己的数字文本。
修改getClusterText方法， 显示我们需要的数字逻辑。
onBeforeClusterRendered 聚合图标的渲染在这里开始，我们可以修改成我们的逻辑。
perform 这是展示地图上Marker的方法，在这里修改加载逻辑，让Marker支持显示我们的动态图标。
显示Marker的修改，是将原本只显示drawable的功能，扩展到支持加载本地图标的支持，后面我们只需要，把对应的Marker的图标下载下来，就可以显示不同的网络ICON啦。下方继续长长长代码(。・・)ノ。
//聚合背景修改为我们要的效果private LayerDrawable makeClusterBackground() {    //读取聚合图标    InputStream inputStream;    inputStream = context.getResources().openRawResource(R.raw.cluster);    BitmapDrawable drawable = new BitmapDrawable(inputStream);    mColoredCircleBackground = drawable;    //将外部的圈圈去掉    ShapeDrawable outline = new ShapeDrawable(new RoundRectShape(mOuterCircle, mInsertCircle, null));    outline.getPaint().setColor(0x00000000);    LayerDrawable background = new LayerDrawable(new Drawable[]{outline, mColoredCircleBackground});    //修改padding    int strokeWidth = (int) (mDensity * 3);    background.setLayerInset(1, strokeWidth, strokeWidth, strokeWidth, strokeWidth);    return background;}/** * 设置文本的样式,修改为使用了TextView，不用百度的SquareTextView */private TextView makeSquareTextView(Context context) {    TextView squareTextView =            new TextView(context);    ViewGroup.LayoutParams layoutParams = new ViewGroup.LayoutParams((int) (54 * mDensity), (int) (54 * mDensity));    squareTextView.setLayoutParams(layoutParams);    squareTextView.setId(R.id.text);    squareTextView.setGravity(Gravity.CENTER);    return squareTextView;}/** * 设置文本的数字显示 */protected String getClusterText(int bucket) {    if (bucket < BUCKETS[0]) {        return String.valueOf(bucket);    }    if (bucket > 999) {        bucket = 999;        return String.valueOf(bucket) + "+";    }    return String.valueOf(bucket);}//显示渲染图标，修改注释部分代码private void perform(MarkerModifier markerModifier) {    if (!shouldRenderAsCluster(cluster)) {        /**如果此处没有需要聚合的**/        for (T item : cluster.getItems()) {            Marker marker = mMarkerCache.get(item);            MarkerWithPosition markerWithPosition;            if (marker == null) {                MarkerOptions markerOptions = new MarkerOptions();                //markerOptions.animateType(MarkerOptions.MarkerAnimateType.grow);                /**                 * 下面就是marker的显示                 */                BitmapDescriptor bitmapDescriptor;                //如果有需要显示的url icon的话，就显示已下载的url Icon                if (!TextUtils.isEmpty(item.getUrlLocalMarkerIconPath()) && new File(item.getUrlLocalMarkerIconPath()).exists()) {                    bitmapDescriptor = item.getUrlMarkerIconBitmapDescriptor(false);                    if (bitmapDescriptor == null) {                        bitmapDescriptor = item.getBitmapDescriptor();                    }                } else {                    bitmapDescriptor = item.getBitmapDescriptor();                }                ···                onBeforeClusterItemRendered(item, markerOptions);                marker = mClusterManager.getMarkerCollection().addMarker(markerOptions);                markerWithPosition = new MarkerWithPosition(marker);                //根据 item 缓存marker                mMarkerCache.put(item, marker);                               ···               /**显示聚合之前完善图片信息**/               onBeforeClusterRendered(cluster, markerOptions);         ····}
5）、IconGenerator
这个类主要是对应聚合Marker的，这里修改了聚合图标的大小，背景，文本样式等等。其中setTextAppearance配置文本的样式，如颜色，大小等，目前百度自带Bubble.TextAppearance.Light和Bubble.TextAppearance.Dark，你也可以自己配置你需要的。
3、LBS数据请求
首先，你还是得有个女朋·····我呸，得是有个KEY，同样是在百度地图API，这次选择的是服务端，创建应用后，最底部可以选择sn加密或者的ip白名单。
既然叫服务端，一般这种工作都是服务器去做的，客户端只需要从服务端拿数据就好。但是有时候服务端没空理你（没错，就是不被理会的我），你就需要直接从百度服务器扣了。
这里采用的是sn加密，就是根据url，通过申请到的ak和sk，还有各种请求参数，进行utf8转化和md5加密，具体有兴趣可以看看DEMO，虽然在客户端这样加密是没有意义的。
那么那我们就开始请求数据啦：
http://api.map.baidu.com/geosearch/v3/nearby?ak=r3sHA6uyjCwDvE838WGfvnPSpghTxi93&geotable_id=158714&page_index=1&page_size=20&location=113.583087,22.276012&radius=5000&sn=7e1dd255849414916373e9fe9856d555
上方式一次请求中完整的url，其中：
geosearch/v3/nearby 代表中附近检索模式，其他的还有支持区域（城市，全国，区）和矩形检索模式。
ak 代表的就是你的服务端申请的对应数据ak
geotable_id 对应的是lbs数据的表名，你可以通过数据管理后台直接加数据。
page_index 页数，从0开始。
page_size 每页返回数据，每页最多50。
location 检索的中心点。
radiud 检索的半径。
sn 加密后的sn。
其他的还有 有关键字q，标签tag，排序sort，过滤等：
q 的检索和热词分词，具体能检索到：设置的检索字段，地址，title等。
tag 对应百度的tag字段，全匹配，可以设置逗号，空格分开。
（以上两个结合的话就是and关系哟，不是or关系）
sort排序只能排序int或者double的字段
filter可以将检索到的数据再过滤一遍，支持离线和区间。
还有其他的就在百度官网了，再说下去真的就废话了。
请求到数据后，lbs对应返回我们需要的json，我们映射成需要的model，组装ClusterBaiduItem并设置图标，用于ClusterManager渲染。
但是！！！百度地图Ｍarker不支持url！这就尴尬了，所以我们还是乖乖自己下载吧┑(￣Д ￣)┍。
4、下载图标
下载逻辑具体可看demo中的 ICONJob（真的好懒），主要的逻辑是：
根据URL生成对应md5的文件名字，如果文件存在，就通知marker更新。
文件不存在，下载（MD5+tmp）名字的文件。
下载完之后判断文件是否为图片，是图片的话就转为需要大小的bitmp，然后保存大图（文件名为MD5 + BIG）和小图（文件名为MD5），大图用来做点击高亮，小图用于正常显示。
按照上面逻辑一张一张顺序的下载ICON到本地。
这里主要是动态更新Marker的图标逻辑：
根据下载成功的ICON对应的id，找到对应的ClusterBaiduItem，通过ClusterBaiduItem，在ClusterManager的DefaultClusterRenderer中拿到marker，修改marker的图标，为我们下载成功的图片，对应的一一更新，哇塞，好简单。
for (ClusterBaiduItem clusterBaiduItem : mClusterBaiduItems) {    LBSModel lbsModel = clusterBaiduItem.getLBAModel();    //此处根据id设置对应的图片    if (lbsModel.getUid() == e.geteId()) {        BitmapDescriptor bitmapDescriptor;        if (!TextUtils.isEmpty(clusterBaiduItem.getUrlLocalMarkerIconPath()) &&                new File(clusterBaiduItem.getUrlLocalMarkerIconPath()).exists()) {            bitmapDescriptor = clusterBaiduItem.getUrlMarkerIconBitmapDescriptor(false);            if (bitmapDescriptor == null) {                bitmapDescriptor = clusterBaiduItem.getBitmapDescriptor();            }        } else {            bitmapDescriptor = clusterBaiduItem.getBitmapDescriptor();        }        //从聚合管理器里面拿到marker，动态改变它        Marker marker = mClusterManager.getDefaultClusterRenderer().getMarker(clusterBaiduItem);        if (marker != null) {            marker.setIcon(bitmapDescriptor);        }        //刷新        mClusterManager.cluster();        return;    }}
GIF效果
5、根据地图状态更新数据
在地图移动和缩放的时候，因为地理信息改变了，需要更新数据，这时候可以通过setOnMapStatusChangeListener来监听地图的变化。
首先如果没有移动过，在移动开始的时候，就保存当前最初状态MapStatus，用来和后面的新的Status作对比。
在状态改变停止的时候，判断是移动还是缩放。
如果是缩放，或者移动操作设定好的距离参数，就进入等待请求数据，将保存的Status清空。
移动和缩放可能是连续性的，进入等待请求网络会设定一个1秒多的延时。
如果一秒多没有动作，就真正开始请求。
如果又发生了变化，那么就取消执行请求，重新发起请求的等待。
每个请求会设置一个UUID作为请求的TAG，在数据返回的时候，判断这一波数据对应的TAG，是不是当前页面最后发起的，如果是的话，就接受，如果不是，我要你何用╮(╯_╰)╭。
mClusterManager.setOnMapStatusChangeListener(new BaiduMap.OnMapStatusChangeListener() {    //记住变化前的上一个状态    private MapStatus mFrontMapStatus;    @Override    public void onMapStatusChangeStart(MapStatus mapStatus) {        if (mFrontMapStatus == null) {            mFrontMapStatus = mapStatus;        }    }    @Override    public void onMapStatusChangeFinish(MapStatus mapStatus) {        //此处需要注意，如果是进入的时候重新定位了地址，或者进入后在改变地图状态，可能也会进入这里        if (mHadRequest) {            if (StatusChangeLogic(mFrontMapStatus, mapStatus)) {//处理移动与放大                mFrontMapStatus = null;            }        }        mCurrentMapStatus = mapStatus;    }});/** * 地图因为操作而发生了状态改变 */private boolean StatusChangeLogic(MapStatus frontMapStatus, MapStatus mapStatus) {    //重新确定搜索半径的中心图标    mSearchModel.setGps(mapStatus.bound.getCenter().longitude + "," + mapStatus.bound.getCenter().latitude);    //重新确定层级    mSearchModel.setLevel(mapStatus.zoom);    if (frontMapStatus == null)        return false;    //得到屏幕的距离大小    double areaLength1 = DistanceUtil.getDistance(mapStatus.bound.northeast, mapStatus.bound.southwest);    //计算屏幕的大小半径    int radius = (int) areaLength1 / 2;    //重新确定搜索的半径    mSearchModel.setRadius(radius);    if (frontMapStatus.zoom == mapStatus.zoom) {        if (frontMapStatus.bound == null)            return false;        //如果是移动了，得到距离        double moveLenght = DistanceUtil.getDistance(frontMapStatus.bound.getCenter(), mapStatus.bound.getCenter());        //如果移动距离大于屏幕的检索半径，请求数据        if (moveLenght >= radius) {            RequestNewDataLogic(true, true);            return true;        }        //如果经纬度发生变化了，一般都是切换的城市之类的        if (mChangeStatus != null && (mapStatus.target.latitude) != (int) (mChangeStatus.target.latitude)                && (int) (mapStatus.target.longitude) != (int) (mChangeStatus.target.longitude) && mIsChangeCity) {            RequestNewDataLogic(true, true);            mIsChangeCity = false;            return true;        }        return false;    } else {        //如果是缩放的话，地图层级发生改变，重新请求数据        RequestNewDataLogic(true, true);        return true;    }}
5、点击放大Marker
效果：

点击放大，其实也是动态改变marker的图标，根据ClusterBiaduItem拿到对应的marker，设置为大图选中的Bitmap，废话不说，下方撸码。
//恢复上一个点击为正常状态if (mPreClickItem != null) {    mPreClickItem.setBitmapId(R.drawable.default_map_icon);    BitmapDescriptor bitmapDescriptor;    //是否已经下载了ICON    if (!TextUtils.isEmpty(mPreClickItem.getUrlLocalMarkerIconPath()) &&            new File(mPreClickItem.getUrlLocalMarkerIconPath()).exists()) {        bitmapDescriptor = mPreClickItem.getUrlMarkerIconBitmapDescriptor(false);        if (bitmapDescriptor == null) {            bitmapDescriptor = mPreClickItem.getBitmapDescriptor();        }    } else {        bitmapDescriptor = mPreClickItem.getBitmapDescriptor();    }    //从聚合管理器里面拿到marker，动态改变它    Marker marker = mClusterManager.getDefaultClusterRenderer().getMarker(mPreClickItem);    if (marker != null) {        marker.setIcon(bitmapDescriptor);    }}//设置新的点击为大图状态if (clusterBaiduItem != null) {    clusterBaiduItem.setBitmapId(R.drawable.default_map_icon_big);    BitmapDescriptor bitmapDescriptor;    //是否已经下载了ICON    if (!TextUtils.isEmpty(clusterBaiduItem.getUrlLocalMarkerIconPath()) &&            new File(clusterBaiduItem.getUrlLocalMarkerIconPath()).exists()) {        bitmapDescriptor = clusterBaiduItem.getUrlMarkerIconBitmapDescriptor(true);        if (bitmapDescriptor == null) {            bitmapDescriptor = clusterBaiduItem.getBitmapDescriptor();        }    } else {        bitmapDescriptor = clusterBaiduItem.getBitmapDescriptor();    }    //从聚合管理器里面拿到marker，动态改变它    Marker marker = mClusterManager.getDefaultClusterRenderer().getMarker(clusterBaiduItem);    if (marker != null) {        marker.setIcon(bitmapDescriptor);    }    //刷新    mClusterManager.cluster();}mPreClickItem = clusterBaiduItem;
6、点击聚合Marker，展开聚合到屏幕大小图层
效果：

点击聚合展开，其实很简单！<(￣︶￣)>，将聚合的ClusterBaiduItem，用LatLngBounds.Builder ,将经纬度收集起来，之后通过MapStatusUpdateFactory生成新的mapstatus，BiaduMap使用animateMapStatus即可展开咯。
if (mBaiduMap == null) {    return;}if (clusterBaiduItems.getItems().size() > 0) {    LatLngBounds.Builder builder = new LatLngBounds.Builder();    for (ClusterBaiduItem clusterBaiduItem : clusterBaiduItems.getItems()) {        builder.include(clusterBaiduItem.getPosition());    }    mBaiduMap.animateMapStatus(MapStatusUpdateFactory            .newLatLngBounds(builder.build()));}
这里大致上就是实现到位图标的粗糙逻辑，最后还是通过DEMO撸起来，会更有感觉<(￣ˇ￣)/。
我是DEMO： https://github.com/CarGuo/LbsMap 用户戳♂起来。
最后
需要注意的，sn校验的时候，需要注意请求参数的tag，q，filter中的逗号，‘&’，‘|’，‘/’d，空格等分割特殊符号的处理，不然很容易检验失败。
数据的返回，不一定是你要50就返回50，因为有增量更新的同步问题，所以有时候数据被删除后，可能会导致某一页只返回49等50以下的数量。
最好不要开启效果显示Marker，因为Marker多了，会很卡，你可以针对某一个Marker去执行动画，具体有drop,grow。
切换城市等经纬度变化，也会使得地图的MapStatus的回调发生改变，这时候注意，不要因为触发了缩放移动地图的请求，你又主动发起了请求，从而同时产生两个请求哟。
如果使用百度定位，注意定位可能同时进入回调几次，注意不要因此发起好几次请求哟。
https://github.com/CarGuo