前言

在地图应用中，Overlay（覆盖层）是指在地图图层之上叠加显示的额外信息层。这些覆盖层可以用来展示各种数据，如交通状况、用户位置、兴趣点（POI）等。在腾讯地图SDK中，可以使用多种类型的覆盖层来增强地图的功能和视觉效果。文本介绍简单的点线面覆盖物使用方法和属性。

地图类中覆盖物的接口

• TencentMap类中添加Overlay的接口：

• TencentMap类中删除Overlay的接口：

• 覆盖物类移除接口Removable：

覆盖物类

Marker示例

// 定义Maker坐标点
LatLng point = new LatLng(39.963175, 116.400244);
// 构建Marker图标
BitmapDescriptor bitmap = BitmapDescriptorFactory
        .fromResource(R.drawable.icon_mark_a);
// 构建MarkerOption，用于在地图上添加Marker
MarkerOptions option = new MarkerOptions(point)
        .position(point)
        .icon(bitmap);
// 在地图上添加Marker，并显示
Marker marker = map.addMarker(option);

Polyline示例

// 构建折线点坐标
LatLng p1 = new LatLng(39.97923, 116.357428);
LatLng p2 = new LatLng(39.94923, 116.397428);
LatLng p3 = new LatLng(39.97923, 116.437428);
List<LatLng> points = new ArrayList<>();
points.add(p1);
points.add(p2);
points.add(p3);

// 设置折线的属性
PolylineOptions polylineOptions = new PolylineOptions()
        .width(10)
        .color(0xAA00FF00)
        .addAll(points);
// 在地图上绘制折线
Polyline polyline = map.addPolyline(polylineOptions);

Polygon示例

// 多边形顶点位置
List<LatLng> points = new ArrayList<>();
points.add(new LatLng(39.93923, 116.357428));
points.add(new LatLng(39.91923, 116.327428));
points.add(new LatLng(39.89923, 116.347428));
points.add(new LatLng(39.89923, 116.367428));
points.add(new LatLng(39.91923, 116.387428));

// 构造PolygonOptions
PolygonOptions polygonOptions = new PolygonOptions()
        .addAll(points)
        .fillColor(0xAAFFFF00) // 填充颜色
        .strokeColor(0xAA00FF00) // 边框颜色
        .strokeWidth(5); // 边框宽度

// 在地图上显示多边形
Polygon polygon = map.addPolygon(polygonOptions);

Arc示例

// 添加弧线坐标数据
LatLng p1 = new LatLng(39.97923, 116.357428); // 起点
LatLng p2 = new LatLng(40.00923, 116.397428); // 中间点
LatLng p3 = new LatLng(39.97923, 116.437428); // 终点

// 构造ArcOptions对象
ArcOptions arcOptions = new ArcOptions()
        .color(Color.RED)
        .width(10)
        .points(p1, p3)
        .pass(p2);

// 在地图上显示弧线
Arc arc = map.addArc(arcOptions);

Circle示例

// 圆心位置
LatLng center = new LatLng(39.90923, 116.447428);

// 构造CircleOptions对象
CircleOptions circleOptions = new CircleOptions()
        .center(center)
        .radius(1400)
        .fillColor(0xAAFFFF00) // 填充颜色
        .strokeColor(0xAA00ff00) // 边框颜色
        .strokeWidth(5); // 边框宽度

// 在地图上显示圆
Circle circle = map.addCircle(circleOptions);

移除示例

// 清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
map.clearAllOverlays();

marker.remove();
polyline.remove();
polygon.remove();
arc.remove();
circle.remove();

效果图

覆盖物.png

Marker的更多属性

点标记，是在地图上用来标记一个经纬度坐标的覆盖物，包括点图标和浮在点之上的信息窗（常称之为InfoWindow）。腾讯地图SDK为点标记提供了丰富的样式和场景使用。

腾讯地图SDK提供很多默认的Marker样式，通过TencentMap添加Marker接口，即可添一个默认样式的Marker。

Marker marker = mTencentMap.addMarker(new MarkerOptions(position));

开发者如果想自定义Marker的样式属性，可以通过两个阶段进行修改：

1. 创建Marker对象之前，可以通过修改MarkerOptions选项来初始化Marker
2. 创建Marker对象之后，可以通过Marker对象，来修改属性

常用属性

交互

• 启用可点击时，在点击Marker时，会回调TencentMap.OnMarkerClickListener。
• 启用允许拖拽时，在拖拽Marker时，会回调TencentMap.OnMarkerDragListener。

碰撞

腾讯地图SDK4.4.1版本起，支持点标记与地图POI元素的碰撞功能，当开启碰撞功能时，与点标记重合的POI元素将会被隐藏。

动画

• Marke支持轮播的功能，通过Marker类setIconLooper方法来传入轮播图数组，并通过MarkerOptions类iconLooper设定轮播模式。
• Marker还支持Animation动画，目前支持平移、缩放、旋转、渐变四种。通过Marker类setAnimation方法设置。

其它属性

折线的更多属性

线是由一组经纬度点按照一定的顺序连接而成，在地图上绘制线由 Polyline 类定义实现。通常用来表示一段路、轨迹等线型场景。

常用属性

交互

其它属性

多边形的更多属性

多边形是由 Polygon 类定义的一组在地图上的封闭线段组成的图形，它由一组 LatLng 点按顺序连接而成。可以设置多边形顶点、描边的宽度和颜色、多边形的填充色、层级关系、可见性、可点击性等属性。

常用属性

交互

其它属性

Arc的更多属性

弧线是由一组经纬度点和夹角角度绘制而成，在地图上绘制弧线由 Arc类定义实现。

• 基础圆弧途径点必须在起终点有效坐标范围内，否则不能生成正确的弧线，同时设置夹角角度时，以夹角角度为准。
• 如果使用的是起终点绘制弧线，一定要添加夹角角度。

Circle的更多属性

圆形是由 Circle 类定义的封闭曲线，在腾讯地图构造一个圆形需要确定它的圆心和半径。可以设置圆心坐标、半径、描边的宽度和颜色、圆的填充颜色、层级、可见性、可点击性等属性。