高德地图SDK Android版开发 6 显示覆盖物

高德地图SDK Android版开发 6 显示覆盖物

• 前言
• 地图类中覆盖物的接口
• 覆盖物类
• • Marker示例
  • Polyline示例
  • Polygon示例
  • Arc示例
  • Circle示例
  • 移除示例
  • 效果图
• Marker的更多属性
• • 常用属性
  • 交互
  • 动画
  • 其它属性
• 折线的更多属性
• • 常用属性
  • 其它属性
• 多边形的更多属性
• • 常用属性
  • 其它属性
• Arc的更多属性
• Circle的更多属性
• Text的更多属性

前言

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

地图类中覆盖物的接口

• AMap类中添加Overlay的接口：

• AMap类中删除Overlay的接口：

覆盖物类

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()
        .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()
        .strokeColor(Color.RED)
        .strokeWidth(10)
        .point(p1, p2, p3);

// 在地图上显示弧线
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，circle，polyline 等对象），
// 但myLocationOverlay（内置定位覆盖物）除外。
boolean isKeepMyLocationOverlay = true;
map.clear(isKeepMyLocationOverlay);

效果图

Marker的更多属性

Marker有如下属性：

• 锚点：图标摆放在地图上的基准点。默认情况下，锚点是从图片下沿的中间处。
• 位置：Marker是通过经纬度的值来标注在地图上的。
• 标题：当点击Marker显示在信息窗口的文字，随时可以更改。
• 片段：除了标题外其他的文字，随时可以更改。
• 图标：Marker显示的图标。如果未设置图标，API 将使用默认的图标，高德为默认图标提供了10 种颜色备选。默认情况下，Marker 是可见的。可随时更改Marker 的可见性。

常用属性

交互

启用允许拖拽时，在拖拽Marker时，会回调AMap.OnMarkerDragListener。

动画

• SDK提供了给Marker增加帧动画的功能，通过MarkerOptions类来设置，一次传入一个Icon列表，通过period设定刷新的帧间隔。
• 自地图 SDK V4.0.0 版本起，SDK 提供了给 Marker 设置动画的方法。通过Marker类setAnimation方法设置。

其它属性

折线的更多属性

地图线段覆盖物。一个线段是多个连贯点的集合线段。它拥有以下属性：

• 顶点：线段是由两个顶点之间连贯的点构成的。如果两个顶点相同，则一个线段将闭合。
• 宽度：宽度是单位是像素。宽度是可视区域的缩放级别无关。默认为10。
• 颜色：线段的颜色是ARGB格式，颜色格式可以参考 Color。默认是黑色(0xff000000)。
• Z轴：Z轴是控制地图覆盖物之间的绘制层次的参数。这个参数能够控制Circles、Polygons、Polyline的绘制层次，但不会影响Marker。 Z轴数值越大的覆盖物将会绘制在更上层。如果两个及两个以上覆盖物的Z轴数值相同，则最后的绘制结果是随机的。 覆盖物的Z轴默认为0。
• 可见：这个属性表示了线段是否可以显示在地图上。如果设置为不可见，则绘制地图时不会绘制此线段，但其他属性不受影响。默认为可见。

常用属性

其它属性

多边形的更多属性

多边形覆盖物。一个多边形可以凸面体，也可是凹面体。它有以下属性:

• 边框：一个多边开的边框由一系列的顺时针或逆时针顶点组成。边框不需要声明起点和终点一致。如果边框的起点与终点不一致，API会自动将它封闭。
• 边框宽度：边框的宽度以像素为单位，不会受可视区域缩放级别的影响。默认为10。
• 边框颜色：边框颜色是一个ARGB格式，ARGB请参考android.graphics.Color。默认为黑色。
• 填充颜色：填充颜色是一个ARGB格式，ARGB格式可参考android.graphics.Color。默认是透明的。如果多边形的几何图形不正确，则填充颜色不会被绘制。
• Z轴：Z轴是控制覆盖物重复区域的绘制顺序的值。Z轴较大的覆盖物会在绘制在Z轴较小的覆盖物上面。如果两个覆盖物的Z轴数值相同，则覆盖情况将随机。默认为0。
• 可见性：标示多边形是否可见。如果可见性为否，则不会被绘制。

多边形方法必须在主线程中调用，否则会抛出IllegalStateException。

常用属性

其它属性

Arc的更多属性

弧形的类。它有以下属性:

• 边框宽度：弧形边框的宽度。这个值设置后不会受到可视区域缩放级别的影响。默认为10。
• 边框颜色：边框颜色是一个ARGB格式，ARGB请参考android.graphics.Color。默认为黑色。
• Z轴：Z轴是控制覆盖物重复区域的绘制顺序的值。Z轴较大的覆盖物会绘制在Z轴较小的覆盖物上面。如果两个覆盖物的Z轴数值相同，则覆盖情况将随机。默认值为0。
• 可见性：标示弧形是否可见。如果可见性为否，则不会被绘制。

弧形方法必须在主线程中调用，否则会抛出IllegalStateException。

Circle的更多属性

圆对象有以下属性：

• 圆心 ：圆心的经纬度。
• 半径： 圆的半径，单位：米。这个值应该大于等于0。
• 边框宽度： 圆的边框宽度。这个值设置后不会受到可视区域缩放级别的影响。默认为10。
• 边框颜色：圆的边框颜色，ARGB格式。默认为黑色。
• 填充颜色：圆的填充颜色，ARGB格式。默认为透明。
• Z轴：Z轴是控制覆盖物重复区域的绘制顺序的值。Z轴较大的覆盖物会绘制在Z轴较小的覆盖物上面。如果两个覆盖物的Z轴数值相同，则覆盖情况将随机。默认值为0。
• 可见属性：标识多边形是否可见。如果可见性为否，则不会被绘制。

圆形方法必须在主线程中调用，否则会抛出IllegalStateException。

Text的更多属性