腾讯地图SDK Android版开发 7 覆盖物示例1
前言
文本介绍Marker的常用属性、交互和碰撞示例。
示例功能如下:
- 可设置Marker点击、拖拽、透明、旋转、可见、平贴、碰撞和POI碰撞属性状态;
- 在地图上创建多个满足上述属性状态的Marker;
- Marker点击事件和拖拽事件处理。
界面布局
- 布局文件
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MapMarkerActivity">
<com.tencent.tencentmap.mapsdk.maps.TextureMapView
android:id="@+id/mapview"
android:layout_width="match_parent"
android:layout_height="0dp"
app:layout_constraintBottom_toTopOf="@id/bottomView"
app:layout_constraintTop_toTopOf="parent" />
<androidx.appcompat.widget.LinearLayoutCompat
android:id="@+id/bottomView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintTop_toBottomOf="@id/mapview">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@android:color/background_dark"
android:gravity="center_horizontal"
android:orientation="horizontal"
android:paddingHorizontal="10dp">
<CheckBox
android:id="@+id/clickable"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:checked="true"
android:onClick="setMarkerFlag"
android:text="点击"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/draggable"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="拖拽"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/alpha"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="透明"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/rotate"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="旋转"
android:textColor="@color/white"
android:textStyle="bold" />
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_gravity="bottom|center"
android:background="@android:color/background_dark"
android:orientation="horizontal"
android:paddingHorizontal="10dp">
<CheckBox
android:id="@+id/visible"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:checked="true"
android:onClick="setMarkerFlag"
android:text="可见"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/flat"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="平贴"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/joinCollision"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="碰撞"
android:textColor="@color/white"
android:textStyle="bold" />
<CheckBox
android:id="@+id/poiCollided"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:onClick="setMarkerFlag"
android:text="POI碰撞"
android:textColor="@color/white"
android:textStyle="bold" />
</LinearLayout>
</androidx.appcompat.widget.LinearLayoutCompat>
</androidx.constraintlayout.widget.ConstraintLayout>
MapMarker类
以下是MapMarker
部分代码。
常量
static final String CLICKABLE = "Clickable";
static final String DRAGGABLE = "Draggable";
static final String ALPHA = "Alpha";
static final String ROTATE = "Rotate";
static final String VISIBLE = "Visible";
static final String FLAT = "Flat";
static final String JOIN_COLLISION = "JoinCollision";
static final String POI_COLLIDED = "PoiCollided";
成员变量
// 覆盖物列表
List<Removable> overlays = new ArrayList<>();
// 选中的状态
List<String> selectedFlags = new ArrayList<>();
// 坐标点集
List<LatLng> points = new ArrayList<>();
初始值
selectedFlags.add(CLICKABLE);
selectedFlags.add(VISIBLE);
points.add(new LatLng(39.97923, 116.357428));
points.add(new LatLng(39.94923, 116.397428));
points.add(new LatLng(39.97923, 116.437428));
points.add(new LatLng(39.92353, 116.490705));
Marker点击事件
// 当 Marker 被点击时回调接口
map.setOnMarkerClickListener(new TencentMap.OnMarkerClickListener() {
@Override
public boolean onMarkerClick(Marker marker) {
// 自定义Marker被点击
showToast("clickable marker");
return true;
}
});
Marker拖拽事件
// 当 Marker 被拖动时回调接口
map.setOnMarkerDragListener(new TencentMap.OnMarkerDragListener() {
@Override
public void onMarkerDragStart(Marker marker) {
// 当前手指按住Marker拖拽开始
}
@Override
public void onMarkerDrag(Marker marker) {
// 当前手指按住Marker拖拽中
}
@Override
public void onMarkerDragEnd(Marker marker) {
// 当前手指按住Marker拖拽结束
// 拖拽完成后更新位置
int index = overlays.indexOf(marker);
if (index != -1) {
LatLng latLng = marker.getPosition();
points.set(index, new LatLng(latLng.latitude, latLng.longitude));
}
}
});
创建覆盖物
public void addMarkers() {
int[] icons = BubbleIcons.Alphabet;
for (int i = 0; i < points.size(); ++i) {
// 构建Marker图标
BitmapDescriptor bitmap = BitmapDescriptorFactory.fromResource(icons[i]);
// 构建MarkerOption,用于在地图上添加Marker
MarkerOptions option = new MarkerOptions(points.get(i))
.icon(bitmap);
setOption(option, i, selectedFlags);
// 在地图上添加Marker,并显示
Marker marker = map.addMarker(option);
if (selectedFlags.contains(CLICKABLE))
marker.setClickable(true); // 设置Marker支持点击
else
marker.setClickable(false);
overlays.add(marker);
}
}
private void setOption(MarkerOptions option, int i, List<String> flags) {
if (flags.contains(DRAGGABLE))
option.draggable(true); // 设置标注是否可以被拖动
if (flags.contains(ALPHA))
option.alpha(0.5f + 0.1f * i); // 设置标注的透明度
if (flags.contains(ROTATE)) {
option.rotation(30 * i); // 设置标注的旋转角度
option.clockwise(false); // 旋转角度是否沿顺时针方向
}
if (flags.contains(VISIBLE))
option.visible(true); // 设置标注是否可见
else
option.visible(false);
if (flags.contains(FLAT))
option.flat(true); // 设置是不是3D标注,3D标注会随着地图倾斜面倾斜
// MarkerCollisionItem.NONE 不碰撞
// MarkerCollisionItem.MARKER 其他Marker 仅在设置OverlayLevel.OverlayLevelAboveLabels时生效
// MarkerCollisionItem.POI 底图POI
if (flags.contains(JOIN_COLLISION) && flags.contains(POI_COLLIDED)) {
option.collisionBy(MarkerCollisionItem.MARKER, MarkerCollisionItem.POI);
}
if (flags.contains(JOIN_COLLISION)) {
option.collisionBy(MarkerCollisionItem.MARKER);
}
if (flags.contains(POI_COLLIDED)) {
option.collisionBy(MarkerCollisionItem.POI);
}
}
移除覆盖物
// 清除地图上所有的标注类(Marker、Polyline、Polygon,TileOverlay除外)
map.clearAllOverlays();
// 从地图移除覆盖物
for (Removable overlay : overlays) {
if (!overlay.isRemoved())
overlay.remove();
}
overlays.clear();
设置属性
public void addFlag(String flag) {
if (!selectedFlags.contains(flag))
selectedFlags.add(flag);
removeOverlay();
addMarkers();
}
public void removeFlag(String flag) {
selectedFlags.remove(flag);
removeOverlay();
addMarkers();
}
MapMarkerActivity类
以下是MapMarkerActivity
部分代码。
控件响应事件
public void setMarkerFlag(View view) {
boolean checked = ((CheckBox) view).isChecked();
int id = view.getId();
String flag;
if (id == R.id.clickable)
flag = MapMarker.CLICKABLE;
else if (id == R.id.draggable)
flag = MapMarker.DRAGGABLE;
else if (id == R.id.alpha)
flag = MapMarker.ALPHA;
else if (id == R.id.rotate)
flag = MapMarker.ROTATE;
else if (id == R.id.visible)
flag = MapMarker.VISIBLE;
else if (id == R.id.flat)
flag = MapMarker.FLAT;
else if (id == R.id.joinCollision)
flag = MapMarker.JOIN_COLLISION;
else if (id == R.id.poiCollided)
flag = MapMarker.POI_COLLIDED;
else
return;
if (checked)
mapMarker.addFlag(flag);
else
mapMarker.removeFlag(flag);
}