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

今天我们要说的，支付宝的“到位”功能。新版支付宝上方第四个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);

//显示位置图标的builder
MyLocationData 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));

//初始化数据搜索model
mSearchModel = 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(0x000000
4000
00);
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以下的数量。
最好不
9bf8
要开启效果显示Marker，因为Marker多了，会很卡，你可以针对某一个Marker去执行动画，具体有drop,grow。
切换城市等经纬度变化，也会使得地图的MapStatus的回调发生改变，这时候注意，不要因为触发了缩放移动地图的请求，你又主动发起了请求，从而同时产生两个请求哟。
如果使用百度定位，注意定位可能同时进入回调几次，注意不要因此发起好几次请求哟。
https://github.com/CarGuo