浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
显示与样式控制
下载开发文档
地图边距设置

司乘同显乘客端SDK支持设置地图上的覆盖物等元素距离地图四周的内边距,用于将自定义标注和路线等覆盖物根据设置的内边距调整到最佳视野范围。

具体代码使用如下:

// 设置地图上子View距离地图View(布局)的边距
mDisplayOptions.setMapViewPadding(200, 300, 200, 300);
刷新时间间隔控制

司乘同显SDK支持自定义司机位置刷新时间间隔。设置车辆位置刷新时间间隔;

具体方法使用如下:

// 设置司机位置刷新频率设置,刷新频率,单位是秒,默认2s,取值范围为[1, 30]
mSyncDisplayManager.setDriverPositionFreshFrequency(3);
视野自适应的时间间隔控制

司乘同显SDK支持自定义最佳视野范围的调整间隔时间。用户没有操作时,随着剩余距离的减少,SDK将保证剩余路线、小车和终点及其infoWindow处于最佳视野范围,SDK将自动调整地图显示区域。通过设置setUnOperatedMapFrozenInterval(10)方法,来自定义自动调整的时间间隔,如果没有到达下一个时间调整节点,即使当前有需要显示的标注已经超出屏幕范围之外,也不会自动调整地图显示区域。用户手动操作地图之后,如果需要经过一段时间之后,才允许SDK自动调整地图的显示区域,则可以通过设置setOperatedMapFrozenInterval(10) 方法,将SDK自动调整地图视野范围的时间冻结。每次用户操作之后,都会等待该方法设置的时间间隔之后,SDK才会自动调整地图的最佳视野范围。

// 设置在地图未被操作状态下,缩放冻结时间,地图缩放禁止间隔,默认值为5s。地图未操作状态下,取值范围为[10, 20]s
mSyncDisplayManager.setUnOperatedMapFrozenInterval(10);
// 设置在地图被操作状态下,缩放冻结时间,地图缩放禁止间隔,默认值为5s。地图被操作状态下,取值范围为[10, 30]s;
mSyncDisplayManager.setOperatedMapFrozenInterval(10);
最佳视野适配

用户在使用乘客APP时可能会手动调整地图,如果想立即调整到视野最佳视野范围可以写个控件调用adjustVisibleSpanByUser()方法来调整, 也可以通过自定义padding方式调整到最佳范围。

默认最佳视野方法使用如下:

// 使用已经设置的(或默认的)Padding值进行最佳视野立即适配
mSyncDisplayManager.adjustVisibleSpanByUser();

通过padding方式调整最佳视野如下:

// 指定新的Padding值进行最佳视野立即适配
mSyncDisplayManager.adjustVisibleSpanByUser(200, 300, 200, 500);
标注与路线的显示样式设置

通过DisplayOptions对象设置标注与路线的显示样式。包括小车、起终点的图片,路线宽度,路况纹理等。

SDK均提供默认值,没有特殊需求,可以不设置。更多设置可以参考DisplayOptions类参考说明。

注意:如果使用SDK提供的默认绘制样式,则直接使用默认构造函数即可。但是如果自定义,传入参数为null,则会抛出参数异常。

自定义InfoWindow

订单起点InfoWindow,订单终点InfoWindow,小车InfoWindow SDK均不提供默认样式,乘客端APP自行设置不同订单状态下InfoWindow的弹出框。小车InfoWindow 可随小车在地图上平滑移动。

订单起点InfoWindow具体的方法如下:

// 设置展示起点气泡信息
Button startInfo = new Button(this);
startInfo.setText("请在这里上车");
startInfo.setBackgroundResource(R.drawable.infowindow);
// 设置订单起点infoWindow的View控件
mDisplayOptions.setStartPositionInfoWindowView(startInfo);
// 设置订单起点InfoWindow是否显示在地图上,默认是true
mDisplayOptions.showStartPositionInfoWindow(true);

订单终点InfoWindow具体的方法如下:

//设置订单终点infoWindow的View控件
mDisplayOptions.setEndPositionInfoWindowView(infoWindowView);

小车InfoWindow具体的方法如下:

// 设置订单终点infoWindow的View控件
mDisplayOptions.setCarInfoWindowView(startInfo);
日志调试开关

开发者在调试时可以通过以下接口开启日志开关,方便调试。

// 打开日志默认是关闭的
SynchronizationUtil.setDebugEnable(true);

上一篇

订单管理

下一篇

历史轨迹查询

本篇文章对您是否有帮助?