发生了什么
换电是把使用者车上没电的电池取出来、换一颗满电电池。电柜是存放电池的设备,摆在点位上;系统里每台电柜有一条记录,记着编号和经纬度。换电地图把这些电柜按经纬度画成点位,使用者在地图上找柜子,核对一台柜子在哪个片区、周围有哪些路。
地图首页打开时,页面会拿当前地图中心的经纬度去请求一次周边电柜,接口按距离过滤,只返回中心 15 公里以内的电柜,页面把这些柜子画成点位。搜索框是另一条取数路径:输入编号或名称,系统在全部电柜里查,不受这个半径限制,所以能查到离当前视野很远的一台。正常搜索之后,地图应该跳到这台柜子的位置,让人一眼看到它在哪。
这次的问题是:搜索之后,地图停在原来的中心不动,页面上找不到这台柜子的位置。复核触发条件是搜索的柜子离地图中心超过 15 公里;不超过 15 公里时,搜同一台柜子能正常定位。确认的影响就是这一条:远处的柜子搜得到、定位不到,附近的不受影响;有多少使用者遇到、持续了多久,材料没有记。
记录里的处置是把搜索后的定位方式改掉:搜索命中后,在地图首页打开这台柜子的详情弹窗,用详情返回的经纬度把地图移过去,再按新的中心重新请求一次地图列表。具体什么时候上线、改完验证到什么程度,材料没有单独写。
本质
正常流程里,地图上有两套取数,范围本来就不一样:画点位用的周边列表按中心 15 公里过滤,搜索用的查询不按距离过滤。问题出在定位这一小步把两者混用了——它去周边列表里找搜索命中的那台柜子。
- 地图首页加载时,页面按当前中心的经纬度请求周边电柜,拿到的是中心 15 公里内的点位。
- 使用者输入编号搜索,搜索查询在全部电柜里匹配,命中的这台在 15 公里以外。
- 要把地图移过去,页面得先知道这台柜子的经纬度。当时取坐标用的是首页那份周边列表,按编号在里面找这条记录。
- 目标在 15 公里外,列表里根本没有它,按编号什么也取不到。移动地图这一步拿不到坐标,就没有执行。
- 页面上表现为搜索有结果、地图没反应,也不会提示"不在当前范围",使用者只能以为搜错了柜号。
为什么只在远处出现:15 公里以内,周边列表本来就包含这台柜子,按编号能命中,定位正常;超过半径就必然落空。所以只在地图中心附近试搜索,测不出这个问题。
搜索能查到,不等于地图能定位;定位要用的坐标必须来自不按视野过滤的数据,而不是从当前画着点位的列表里找。
记录给出的改法是:搜索命中后调用电柜详情,用详情返回的经纬度移动地图,再以新的中心重新取一次周边列表,让这台柜子进入新视野并被画出来。放到更一般的做法上,列表只负责画当前视野,定位、高亮、跳转这类动作都按目标自身的坐标执行,不从列表里反查。
下面两段 Java 代码是按上述机制写的教学示例,只对比定位时坐标从哪里取,不代表实际项目源码或已上线实现。
错误代码
// 地图页定位搜索命中的电柜(Java 教学示例)
public class SwapMapLocateService {
private static final double VIEW_RADIUS_KM = 15.0;
private final CabinetClient cabinetClient;
private final MapView mapView;
public void locate(String cabinetNo, double centerLng, double centerLat) {
// 为什么错:点位列表按中心 15 公里取,视野外的柜子不在里面
List<Cabinet> markers = cabinetClient.listNearby(centerLng, centerLat, VIEW_RADIUS_KM);
Cabinet target = markers.stream()
.filter(c -> cabinetNo.equals(c.getCabinetNo()))
.findFirst()
.orElse(null);
// 为什么错:找不到就静默返回,地图不动也不提示,使用者只看到没反应
if (target == null) {
return;
}
mapView.moveTo(target.getLng(), target.getLat());
}
}
修复代码示例
// 同一段定位逻辑:坐标改从详情取,再按新中心重取列表
public class SwapMapLocateService {
private static final double VIEW_RADIUS_KM = 15.0;
private final CabinetClient cabinetClient;
private final MapView mapView;
public void locate(String cabinetNo) {
// 详情按编号查询,不按地图中心过滤,远处柜子也能拿到坐标
CabinetDetail detail = cabinetClient.getDetail(cabinetNo);
if (detail == null) {
throw new BizException("电柜不存在,请核对编号");
}
mapView.moveTo(detail.getLng(), detail.getLat());
// 关键改动:用新中心重取周边列表,目标才会落进视野并被画出
mapView.refreshMarkers(cabinetClient.listNearby(
detail.getLng(), detail.getLat(), VIEW_RADIUS_KM));
}
}
下次遇到这些场景要警惕
- 做"搜索后定位/跳转"这类功能时:把搜索查询和页面渲染列表的过滤条件并排列出来,比对距离、权限、状态这几项是否一致;用一台在当前视野之外的记录做输入,观察地图或列表是否真的跳过去。
- 列表按中心点或视野取数时:定位、高亮、跳转需要的坐标从详情接口按编号取,不要先从列表里反查;列表只用来画当前视野,两件事分开。改完拿一台视野外的柜子走一遍,确认地图移动和点位画出同时到位。
- 移动地图之后:确认新视野的列表重新请求过,否则地图已经移过去,点位还是旧范围的数据,看起来像柜子不存在;再用略小于和略大于半径的柜子各搜一次,看边界两侧是否都能定位。
- 收到"搜到了但没反应"的反馈时:先比搜索接口和列表接口的过滤条件,再看定位是否依赖列表命中;两处取数范围不同时,问题通常不在搜索本身,而在定位那一步的取数来源。