| 包: | dji.open.pilot.client.interfaces |
IMapWidgetManager
服务端地图操作接口。管理服务端地图控件、地图元素、图层及 AR 标注,支持添加、移除、更新、查询等操作。
描述:
addMapWidget
Since MSDK 5.20.1void addMapWidget(@NonNull |
添加地图控件到服务端。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widget | @NonNull | 地图控件。 |
removeMapWidget
Since MSDK 5.20.1void removeMapWidget(@NonNull |
移除地图控件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widget | @NonNull | 地图控件。 |
hideARAnnotations
Since MSDK 5.20.1void hideARAnnotations(boolean isHided, CommonCallbacks |
隐藏服务端 AR 标注。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
isHided | boolean | 是否隐藏。 |
callback | CommonCallbacks | 结果回调。 |
queryMapElement
Since MSDK 5.20.1void queryMapElement(@NonNull |
查询服务端地图元素。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 查询地图元素结果回调。 |
insertMapElement
Since MSDK 5.20.1void insertMapElement(@NonNull |
新增服务端地图元素。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
element | @NonNull | 地图元素,支持 AR。 |
callback | CommonCallbacks | 新增地图元素结果回调。 |
deleteMapElement
Since MSDK 5.20.1void deleteMapElement(@NonNull |
删除服务端地图元素。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
element | @NonNull | 地图元素,支持 AR。 |
callback | CommonCallbacks | 删除地图元素结果回调。 |
updateMapElement
Since MSDK 5.20.1void updateMapElement(@NonNull |
更新服务端地图元素。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
element | @NonNull | 地图元素,支持 AR。 |
callback | CommonCallbacks | 更新地图元素结果回调。 |
addMapStateListener
Since MSDK 5.20.1void addMapStateListener(@NonNull |
添加服务端地图状态监听。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 地图状态监听。 |
removeMapStateListener
Since MSDK 5.20.1void removeMapStateListener(@NonNull |
移除服务端地图状态监听。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | @NonNull | 地图状态监听。 |
addMapWidget
Since MSDK 5.20.1void addMapWidget(@NonNull |
添加地图控件到服务端(带结果回调)。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widget | @NonNull | 地图控件。 |
callback | CommonCallbacks | 结果回调。 |
removeMapWidget
Since MSDK 5.20.1void removeMapWidget(@NonNull |
移除地图控件(带结果回调)。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widget | @NonNull | 地图控件。 |
callback | CommonCallbacks | 结果回调。 |
updateMapWidgets
Since MSDK 5.20.1void updateMapWidgets(@NonNull |
批量更新地图控件。
按 id 匹配,对每个 widget 就地更新属性(不会产生视觉闪烁)。列表中任一 widget 的 id 不存在或试图修改不可变字段(id / source / layerId),整批更新失败,不会发起 IPC。
以下字段不可通过本方法修改,否则回调 WIDGET_FIELD_IMMUTABLE 错误:id(widget 唯一标识,不可变);source(来源包名,不可变);layerId(所属图层,如需将 widget 移动到其他图层,请先 removeMapWidgetsByIds 再重新 addMapWidgets)。
注意:受 Android Binder 传输限制,单次批量更新的数据总量不应超过 512KB。超限时回调 PAYLOAD_TOO_LARGE 错误。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widgets | @NonNull | 地图控件列表。 |
callback | CommonCallbacks | 结果回调。 |
queryMapWidgets
Since MSDK 5.20.1void queryMapWidgets(@NonNull |
查询当前插件添加的所有地图控件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 查询结果回调。 |
queryMapWidgetsByLayer
Since MSDK 5.20.1void queryMapWidgetsByLayer(@NonNull |
查询指定图层下的所有地图控件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
layerId | @NonNull | 图层 ID。 |
callback | @NonNull | 查询结果回调。 |
addMapWidgets
Since MSDK 5.20.1void addMapWidgets(@NonNull |
批量添加地图控件。
一次 IPC 调用完成多个控件的添加,适用于 GIS 数据批量同步场景。
注意:受 Android Binder 传输限制,单次批量添加的数据总量不应超过 512KB。建议单次不超过 500 个简单 Marker 控件,或 200 个含坐标列表的折线/多边形控件。超限时回调 PAYLOAD_TOO_LARGE 错误。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widgets | @NonNull | 地图控件列表。 |
callback | CommonCallbacks | 结果回调。 |
removeMapWidgetsByIds
Since MSDK 5.20.1void removeMapWidgetsByIds(@NonNull |
按 id 列表批量移除地图控件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
widgetIds | @NonNull | 要移除的地图控件 id 列表。 |
callback | CommonCallbacks | 结果回调。 |
addLayer
Since MSDK 5.20.1void addLayer(@NonNull |
添加图层。
图层是地图控件的逻辑分组容器,可按业务语义将 MapWidget 组织到不同图层中(如"火点层"、“人员层”),支持整层显隐、整层清空。一个图层可包含任意 DrawerType 的 MapWidget。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
layer | @NonNull | 图层。 |
callback | CommonCallbacks | 结果回调。 |
removeLayer
Since MSDK 5.20.1void removeLayer(@NonNull |
删除图层。
同时删除该图层下的所有地图控件。不能删除默认层(layerId 为空),否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
layerId | @NonNull | 图层 ID。 |
callback | CommonCallbacks | 结果回调。 |
setLayerVisible
Since MSDK 5.20.1void setLayerVisible(@NonNull |
设置图层可见性。
控制整个图层下所有地图控件的显示/隐藏。不能设置默认层(layerId 为空)的可见性,否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
layerId | @NonNull | 图层 ID。 |
visible | boolean | true 显示,false 隐藏。 |
callback | CommonCallbacks | 结果回调。 |
clearLayer
Since MSDK 5.20.1void clearLayer(@NonNull |
清空图层。
删除该图层下的所有地图控件,但保留图层本身。不能清空默认层(layerId 为空),否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
layerId | @NonNull | 图层 ID。 |
callback | CommonCallbacks | 结果回调。 |
Related:
MapCircleOptions
Since MSDK 5.20.1@Keep |
地图控件元素圆形配置。
MapDrawerType
Since MSDK 5.20.1地图控件绘制类型。
枚举成员
| 名称 | 说明 |
|---|---|
NONE | 无设置。 |
MARKER | 地图图标。 |
POLYLINE | 地图折线。 |
POLYGON | 地图多边形。 |
CIRCLE | 地图圆。 |
PIN | 地图 Pin 点。 |
MapElement
Since MSDK 5.20.1@Keep |
地图元素。
MapElementColor
Since MSDK 5.20.1地图元素的颜色。
枚举成员
| 名称 | 说明 |
|---|---|
BLUE | 半透明蓝。 |
GREEN | 半透明绿。 |
YELLOW | 半透明黄。 |
ORANGE | 半透明橘。 |
RED | 半透明红。 |
NAME_DEFAULT | 默认颜色。 |
MapMarkerOptions
Since MSDK 5.20.1@Keep |
地图控件元素标注配置。
MapPolygonOptions
Since MSDK 5.20.1@Keep |
地图控件元素多边形配置。
MapPolylineOptions
Since MSDK 5.20.1@Keep |
地图控件元素折线配置。
MapWidget
Since MSDK 5.20.1@Keep |
地图控件。
MapWidgetItem
Since MSDK 5.20.1@Keep |
地图控件元素,用于描述地图控件的自定义配置。
MapWidgetLayer
Since MSDK 5.20.1@Keep |
地图控件图层。