百度地图SDK Android版开发 5 地图交互操作

前言

前文介绍了三个主题：创建显示地图；切换地图类型；显示定位。本文重点介绍地图交互操作及相关的类和接口。

• 百度地图支持多种地图交互操作，用户可以通过手势或控件进行地图操作，以实现更好的地图浏览体验。另一方面开发者通过代码实现特定业务场景的地图交互。

• 百度地图通过设定不同的地图状态，来改变地图视野。

• 最后是不属于地图操作的地图事件，但是也很重要。

  • 比如地图加载完成事件，一些特定接口需要在地图加载完成后才能调用（在显示定位和本文均有提及）。

控件

控件介绍

百度地图提供一些基础的地图控件，包括LOGO、指南针、比例尺和缩放按钮。

注意：地图Logo不允许遮挡，可通过设置地图上控件边距来避免遮挡。

注意：根据百度地图API使用条款您的应用不得删除或覆盖百度地图logo或版权声明。地图内边距允许您在必要时重新定位这些元素，若您需要在地图布局顶底部显示自定义UI，请设置内边距以保证百度地图logo和版权声明始终可见。

接口

MapView

MapView类中Logo、比例尺、缩放按钮的接口：

BaiduMap

BaiduMap类中指南针，地图上控件边距、地图UI控制器的接口：

UiSettings

UiSettings类中指南针的接口：

LogoPosition

Logo位置枚举，左下开始顺时针的6个位置：

示例代码

Logo

// 获取Logo位置
LogoPosition position = mapView.getLogoPosition();
// 设置Logo位置
mapView.setLogoPosition(LogoPosition.logoPostionRightBottom);
1
2
3
4

指南针

// 获取是否允许指南针
boolean enabled = uiSettings.isCompassEnabled();
// 设置是否允许指南针
uiSettings.setCompassEnabled(true);

// 设置指南针是否显示
map.setCompassEnable(true);
Point point = map.getCompassPosition();
// map.setCompassPosition(new Point(100, 100));
// map.setCompassIcon(icon);
1
2
3
4
5
6
7
8
9
10

比例尺

// 获取比例尺控件的宽度
int width = mapView.getScaleControlViewWidth();
// 获取比例尺控件的高度
int height = mapView.getScaleControlViewHeight();

// 获取比例尺控件是否显示
boolean isShow = mapView.isShowScaleControl();
// 设置是否显示比例尺控件
mapView.showScaleControl(isShow);

// 获取比例尺控件对应的屏幕位置
Point point = mapView.getScaleControlPosition();
// 设置比例尺控件的位置，在 onMapLoadFinish 后生效
// mapView.setScaleControlPosition(new Point(20, 20));
1
2
3
4
5
6
7
8
9
10
11
12
13
14

缩放按钮

mapView.showZoomControls(true);
Point point = mapView.getZoomControlsPosition();
// mapView.setZoomControlsPosition(new Point(0, 0));
1
2
3

地图上控件边距

// 设置地图上控件与地图边界的距离，包含比例尺、缩放控件、logo、指南针的位置。
// 只有在 OnMapLoadedCallback.onMapLoaded()之后设置才生效。
// 参数依次为左边距、上边距、右边距、下边距（单位为 pixel）
int left = 20;
int top = 0;
int right = 20;
int bottom = 0;
map.setViewPadding(left, top, right, bottom);
1
2
3
4
5
6
7
8

效果图

地图手势

提供了多种手势供 户与地图之间进行交互，如平移、缩放、旋转、滑动、倾斜。

地图手势默认开启，可以通过UiSetting类提供的接口来控制手势的开关。

地图手势方法说明

地图手势开关接口

UiSetting手势开关1

UiSetting手势开关2

地图手势事件

BaiduMap类地图手势事件监听接口：

地图单击事件监听接口

// 地图单击事件监听接口
public interface OnMapClickListener {
    /**
     * 地图单击事件回调函数
     * @param point 点击的地理坐标
     */
    void onMapClick(LatLng point);

    /**
     * 地图内 Poi 单击事件回调函数
     * @param mapPoi 点击的 poi 信息
     */
    void onMapPoiClick(MapPoi mapPoi);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

地图双击事件监听接口

// 地图双击事件监听接口
public interface OnMapDoubleClickListener {
    /**
     * 地图双击事件监听回调函数
     * @param point 双击的地理坐标
     */
    void onMapDoubleClick(LatLng point);
}
1
2
3
4
5
6
7
8

地图长按事件监听接口

// 地图长按事件监听接口
public interface OnMapLongClickListener {
    /**
     * 地图长按事件监听回调函数
     * @param point 长按的地理坐标
     */
    void onMapLongClick(LatLng point);
}
1
2
3
4
5
6
7
8

地图手势事件回调接口

// 地图手势事件回调接口
public interface onMapGestureListener {
    /**
     * 平移
     * @param start 平移手势开始屏幕坐标点
     * @param end   平移手势结束屏幕坐标点
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapScroll(Point start, Point end, MapStatus curStatus);

    /**
     * 双击放大
     * @param point 屏幕坐标点
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapDoubleTouch(Point point, MapStatus curStatus);

    /**
     * 双指点击缩小
     * @param p1 第一个屏幕坐标点
     * @param p2 第二个屏幕坐标点
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapTwoClick(Point p1, Point p2, MapStatus curStatus);

    /**
     * 捏合
     * @param p1 第一个屏幕坐标点
     * @param p2 第二个屏幕坐标点
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapKneading(Point p1, Point p2, MapStatus curStatus);

    /**
     * 俯视
     * @param p1 第一个屏幕坐标点
     * @param p2 第二个屏幕坐标点
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapOverLooking(Point p1, Point p2, MapStatus curStatus);

    /**
     * 惯性抛出手势
     * @param event 触摸事件
     * @param velocityX X轴上的移动速度，像素/秒
     * @param velocityY Y轴上的移动速度，像素/秒
     * @param curStatus 当前地图状态
     * @return 该手势事件是否由SDK消费
     */
    boolean onMapFling(MotionEvent event, float velocityX, float velocityY,
                       MapStatus curStatus);

    /**
     * 手势事件结束后地图状态
     * @param status 当前地图状态
     */
    void onMapStatusChangeFinish(MapStatus status);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

用户触摸地图时回调接口

// 用户触摸地图时回调接口
public interface OnMapTouchListener {
    /**
     * 当用户触摸地图时回调函数
     * @param motionEvent 触摸事件
     */
    void onTouch(MotionEvent motionEvent);
}
1
2
3
4
5
6
7
8

地图状态

地图状态类

MapStatus类定义了地图的状态，如中心点经纬度，旋转角度，俯视角度，缩放级别等。

地图状态更新类

MapStatusUpdate类描述地图状态将要发生的变化。

通过MapStatusUpdateFactory类构建地图缩放等级、地图显示范围，改变地图中心点等地图更新实例。

改变地图状态接口

BaiduMap类中改变地图状态和设置地图状态监听的接口：

地图状态改变接口

// 地图状态改变接口
public interface OnMapStatusChangeListener {
    int REASON_GESTURE = 1; // 用户手势触发导致的地图状态改变, 比如双击、拖拽、滑动底图
    int REASON_API_ANIMATION = 2; // SDK导致的地图状态改变, 比如点击缩放控件、指南针图标
    int REASON_DEVELOPER_ANIMATION = 3; // 开发者调用,导致的地图状态改变

    /**
     * 手势操作地图，设置地图状态等操作导致地图状态开始改变。
     * @param status 地图状态改变开始时的地图状态
     */
    void onMapStatusChangeStart(MapStatus status);

    /**
     * 手势操作地图，设置地图状态等操作导致地图状态开始改变。
     * @param status 地图状态改变开始时的地图状态
     * @param reason 地图状态改变的原因
     */
    void onMapStatusChangeStart(MapStatus status, int reason);

    /**
     * 地图状态变化中
     * @param status 当前地图状态
     */
    void onMapStatusChange(MapStatus status);

    /**
     * 地图状态改变结束
     * @param status 地图状态改变结束后的地图状态
     */
    void onMapStatusChangeFinish(MapStatus status);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

限制地图显示范围和缩放级别

BaiduMap类中限制地图显示范围和缩放级别的接口：

其它地图事件

BaiduMap类中加载完成和渲染完成的接口：

地图加载完成回调接口

// 地图加载完成回调接口
public interface OnMapLoadedCallback {
    /**
     * 地图加载完成回调函数
     */
    void onMapLoaded();
}
1
2
3
4
5
6
7

地图渲染完成回调接口

//  地图渲染完成回调接口
public interface OnMapRenderCallback {
    /**
     * 地图渲染完成回调函数
     */
    void onMapRenderFinished();
}
1
2
3
4
5
6
7