推荐上车点-Android 最后更新时间: 2021年01月22日

概述

乘客端选择上车位置中, 通过集成接入推荐上车点SDK, 进行实现推荐上车点功能.

使用流程

定位确定相关位置, 设置地图展示层级, 若定位精度差, 推荐提示乘客确定上车点位置
通过推荐上车点功能获得推荐附近可用上车点数据
推荐上车点SDK进行吸附到吸附范围内上车点
没有可吸附上车点, 会返回附近POI名称

接入使用

1、创建RecommendSpotManager

1）自定义推荐上车点样式

//初始化样式
RecommendSpotOptions recommendSpotOptions = new RecommendSpotOptions();
//圆点半径
recommendSpotOptions.circleRadius(5);
//上车点名称文字大小
recommendSpotOptions.textSize(10);

2）创建RecommendSpotManager

XML

//创建RecommendSpotManager
 RecommendSpotManager  recommendSpotManager = new RecommendSpotManager(MainActivity.this,mapView.getMap(),recommendSpotOptions);

2、添加大头针

XML

//在地图中心位置添加大头针Marker
recommendSpotManager.addCenterPin(540,1120,BitmapDescriptorFactory.fromResource(R.drawable.start_point));

3、查询附近上车点并展示

XML

//查询附近推荐上车点
recommendSpotManager.requestRecommendSport(new LatLng(22.325682,114.222237));

4、设置吸附监听

XML

//设置吸附到推荐上车点的回调监听
recommendSpotManager.setAttachRecommendSpotCallback(new RecommendSpotManager.AttachRecommendSpotCallback() {
    @Override
    public void attachedRecommendSpot(RecommendSpotInfo attachedSpot) {
        Log.e("MainActivity","返回上车点："+attachedSpot.getTitle());
    }
});

5、监听地图状态变化并通知RecommendSpotManager

XML

mAMap.setOnCameraChangeListener(new AMap.OnCameraChangeListener() {
    @Override
    public void onCameraChange(CameraPosition position) {
        //通知recommendSpotManager 调整推荐上车点样式
        recommendSpotManager.onCameraChange(position);
    }

    @Override
    public void onCameraChangeFinish(CameraPosition position) {
        //通知recommendSpotManager 触发吸附逻辑
        recommendSpotManager.onCameraChangeFinish(position);
    }
});

高级功能

功能1:设置上车点显示级别

XML

 /**
* 设置上车点显示的缩放级别，当大于该级别时才显示上车点Marker * @param zoom Level
* @since 1.0.0
*/
public void setZoom Level(int zoom Level)

功能2: 设置请求推荐上⻋点数量

XML

 /**
* 设置请求推荐上车点的个数 * @param spotCount
* @since 1.0.0
*/
public void setSpotCount(int spotCount)

功能3: 自定义上车点数据源

XML

/**
* 设置自定义上车点数据源
* @param provider 上车点数据源 * @since 1.2.0
*/
public void setRecom m endSpotProvider(IRecom m endSpotProvider provider)

IRecommendSpotProvider 自定义数据源

XML

/**
* 获取附近推荐上车点信息
* @param center 中心点
* @return 上车点信息列表 * @since 1.2.0
*/
List<Recom m endSpotInfo>
getRecom m endSpotInfos(LatLng
center)

注意事项

定位精度差的情况下, 推荐提示乘客二次确认上车点位置
自有上车点情况下, 支持使用自有数据源展示和吸附