DJI Mobile SDK Documentation
      包:dji.open.pilot.client.interfaces
      classSince MSDK 5.20.1

      IMapWidgetManager

      服务端地图操作接口。管理服务端地图控件、地图元素、图层及 AR 标注,支持添加、移除、更新、查询等操作。

      Package dji.open.pilot.client.interfacesAndroid · Java / Kotlin

      服务端地图操作接口。管理服务端地图控件、地图元素、图层及 AR 标注,支持添加、移除、更新、查询等操作。

      MSDK 5.20.1开始支持

      成员

      31 个成员

      监听

      2

      方法

      18

      枚举

      3

      Class

      8
      method

      addMapWidget

      Since MSDK 5.20.1
      void addMapWidget(@NonNull MapWidget widget)

      添加地图控件到服务端。

      参数

      名称类型说明
      widget@NonNull MapWidget 地图控件。
      method

      removeMapWidget

      Since MSDK 5.20.1
      void removeMapWidget(@NonNull MapWidget widget)

      移除地图控件。

      参数

      名称类型说明
      widget@NonNull MapWidget 地图控件。
      method

      hideARAnnotations

      Since MSDK 5.20.1
      void hideARAnnotations(boolean isHided, CommonCallbacks.CompletionCallback callback)

      隐藏服务端 AR 标注。

      参数

      名称类型说明
      isHidedboolean 是否隐藏。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      queryMapElement

      Since MSDK 5.20.1
      void queryMapElement(@NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapElement>> callback)

      查询服务端地图元素。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapElement>> 查询地图元素结果回调。
      method

      insertMapElement

      Since MSDK 5.20.1
      void insertMapElement(@NonNull MapElement element, CommonCallbacks.CompletionCallbackWithParam<UUID> callback)

      新增服务端地图元素。

      参数

      名称类型说明
      element@NonNull MapElement 地图元素,支持 AR。
      callbackCommonCallbacks.CompletionCallbackWithParam<UUID> 新增地图元素结果回调。
      method

      deleteMapElement

      Since MSDK 5.20.1
      void deleteMapElement(@NonNull MapElement element, CommonCallbacks.CompletionCallback callback)

      删除服务端地图元素。

      参数

      名称类型说明
      element@NonNull MapElement 地图元素,支持 AR。
      callbackCommonCallbacks.CompletionCallback 删除地图元素结果回调。
      method

      updateMapElement

      Since MSDK 5.20.1
      void updateMapElement(@NonNull MapElement element, CommonCallbacks.CompletionCallback callback)

      更新服务端地图元素。

      参数

      名称类型说明
      element@NonNull MapElement 地图元素,支持 AR。
      callbackCommonCallbacks.CompletionCallback 更新地图元素结果回调。
      method

      addMapStateListener

      Since MSDK 5.20.1
      void addMapStateListener(@NonNull IMapStateListener listener)

      添加服务端地图状态监听。

      参数

      名称类型说明
      listener@NonNull IMapStateListener 地图状态监听。
      method

      removeMapStateListener

      Since MSDK 5.20.1
      void removeMapStateListener(@NonNull IMapStateListener listener)

      移除服务端地图状态监听。

      参数

      名称类型说明
      listener@NonNull IMapStateListener 地图状态监听。
      method

      addMapWidget

      Since MSDK 5.20.1
      void addMapWidget(@NonNull MapWidget widget, CommonCallbacks.CompletionCallback callback)

      添加地图控件到服务端(带结果回调)。

      参数

      名称类型说明
      widget@NonNull MapWidget 地图控件。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      removeMapWidget

      Since MSDK 5.20.1
      void removeMapWidget(@NonNull MapWidget widget, CommonCallbacks.CompletionCallback callback)

      移除地图控件(带结果回调)。

      参数

      名称类型说明
      widget@NonNull MapWidget 地图控件。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      updateMapWidgets

      Since MSDK 5.20.1
      void updateMapWidgets(@NonNull List<MapWidget> widgets, CommonCallbacks.CompletionCallback callback)

      批量更新地图控件。

      按 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 List<MapWidget> 地图控件列表。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      queryMapWidgets

      Since MSDK 5.20.1
      void queryMapWidgets(@NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapWidget>> callback)

      查询当前插件添加的所有地图控件。

      参数

      名称类型说明
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapWidget>> 查询结果回调。
      method

      queryMapWidgetsByLayer

      Since MSDK 5.20.1
      void queryMapWidgetsByLayer(@NonNull String layerId,
      @NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapWidget>> callback)

      查询指定图层下的所有地图控件。

      参数

      名称类型说明
      layerId@NonNull String 图层 ID。
      callback@NonNull CommonCallbacks.CompletionCallbackWithParam<List<MapWidget>> 查询结果回调。
      method

      addMapWidgets

      Since MSDK 5.20.1
      void addMapWidgets(@NonNull List<MapWidget> widgets, CommonCallbacks.CompletionCallback callback)

      批量添加地图控件。

      一次 IPC 调用完成多个控件的添加,适用于 GIS 数据批量同步场景。

      注意:受 Android Binder 传输限制,单次批量添加的数据总量不应超过 512KB。建议单次不超过 500 个简单 Marker 控件,或 200 个含坐标列表的折线/多边形控件。超限时回调 PAYLOAD_TOO_LARGE 错误。

      参数

      名称类型说明
      widgets@NonNull List<MapWidget> 地图控件列表。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      removeMapWidgetsByIds

      Since MSDK 5.20.1
      void removeMapWidgetsByIds(@NonNull List<String> widgetIds, CommonCallbacks.CompletionCallback callback)

      按 id 列表批量移除地图控件。

      参数

      名称类型说明
      widgetIds@NonNull List<String> 要移除的地图控件 id 列表。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method
      method

      addLayer

      Since MSDK 5.20.1
      void addLayer(@NonNull MapWidgetLayer layer, CommonCallbacks.CompletionCallback callback)

      添加图层。

      图层是地图控件的逻辑分组容器,可按业务语义将 MapWidget 组织到不同图层中(如"火点层"、“人员层”),支持整层显隐、整层清空。一个图层可包含任意 DrawerType 的 MapWidget。

      参数

      名称类型说明
      layer@NonNull MapWidgetLayer 图层。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      removeLayer

      Since MSDK 5.20.1
      void removeLayer(@NonNull String layerId, CommonCallbacks.CompletionCallback callback)

      删除图层。

      同时删除该图层下的所有地图控件。不能删除默认层(layerId 为空),否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。

      参数

      名称类型说明
      layerId@NonNull String 图层 ID。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      setLayerVisible

      Since MSDK 5.20.1
      void setLayerVisible(@NonNull String layerId, boolean visible, CommonCallbacks.CompletionCallback callback)

      设置图层可见性。

      控制整个图层下所有地图控件的显示/隐藏。不能设置默认层(layerId 为空)的可见性,否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。

      参数

      名称类型说明
      layerId@NonNull String 图层 ID。
      visibleboolean true 显示,false 隐藏。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      method

      clearLayer

      Since MSDK 5.20.1
      void clearLayer(@NonNull String layerId, CommonCallbacks.CompletionCallback callback)

      清空图层。

      删除该图层下的所有地图控件,但保留图层本身。不能清空默认层(layerId 为空),否则回调 LAYER_READONLY 错误。图层不存在时回调 LAYER_NOT_FOUND 错误。

      参数

      名称类型说明
      layerId@NonNull String 图层 ID。
      callbackCommonCallbacks.CompletionCallback 结果回调。
      class

      MapCircleOptions

      Since MSDK 5.20.1
      @Keep
      class MapCircleOptions implements Parcelable

      地图控件元素圆形配置。

      enum

      MapDrawerType

      Since MSDK 5.20.1

      地图控件绘制类型。

      枚举成员

      名称说明
      NONE无设置。
      MARKER地图图标。
      POLYLINE地图折线。
      POLYGON地图多边形。
      CIRCLE地图圆。
      PIN地图 Pin 点。
      class

      MapElement

      Since MSDK 5.20.1
      @Keep
      class MapElement implements Parcelable

      地图元素。

      enum

      MapElementColor

      Since MSDK 5.20.1

      地图元素的颜色。

      枚举成员

      名称说明
      BLUE半透明蓝。
      GREEN半透明绿。
      YELLOW半透明黄。
      ORANGE半透明橘。
      RED半透明红。
      NAME_DEFAULT默认颜色。
      class

      MapMarkerOptions

      Since MSDK 5.20.1
      @Keep
      class MapMarkerOptions implements Parcelable

      地图控件元素标注配置。

      class

      MapPolygonOptions

      Since MSDK 5.20.1
      @Keep
      class MapPolygonOptions implements Parcelable

      地图控件元素多边形配置。

      class

      MapPolylineOptions

      Since MSDK 5.20.1
      @Keep
      class MapPolylineOptions implements Parcelable

      地图控件元素折线配置。

      class

      MapWidget

      Since MSDK 5.20.1
      @Keep
      class MapWidget implements Parcelable

      地图控件。

      class

      MapWidgetItem

      Since MSDK 5.20.1
      @Keep
      class MapWidgetItem implements Parcelable

      地图控件元素,用于描述地图控件的自定义配置。

      enum

      MapWidgetItemType

      Since MSDK 5.20.1

      地图控件元素类型。

      枚举成员

      名称说明
      DIALOG对话框。
      NONE无设置。
      class

      MapWidgetLayer

      Since MSDK 5.20.1
      @Keep
      class MapWidgetLayer implements Parcelable

      地图控件图层。