场景基础配置项是用于承载地图本身和各子组件的模块，支持通过使用默认基底数据和空间数据项目两种方式添加多个城市基底子组件和数据映射子组件，支持配置城市场景地图的基础属性和快速样式。本文介绍城市三维场景构建器组件场景基础配置项的含义。

添加组件并使用默认基底数据方式选择场景范围区域

  1. 在组件栏内选择地图 > 城市三维场景构建器组件。
  2. 在选择创建方式对话框内选择默认基底数据，并单击创建。创建默认基地数据
  3. 在选择子组件对话框中选择一个或多个城市基底子组件；您也可以单击选中对话框右上角的全选按钮，选中所有的城市基底子组件。选择子组件
  4. 选择子组件后，单击对话框下方的下一步即可进入选择范围对话框；单击取消可以取消添加城市三维场景构建器组件。
  5. 单击选择范围对话框内的数据版本下拉列表，选择您需要的数据版本内容。数据版本
  6. 单击对话框左上角城市列表，在列表已有的城市选项中，选择您想展示的三维城市选项，地图即可快速定位导航到该城市区域。
    说明 城市定位后，绿色区域为可选范围，非绿色区域暂无城市数据，无法加载城市三维场景构建器场景内容。
  7. 单击对话框左侧的放大、缩小号或者通过鼠标滚动缩放地图可放大或者缩小当前地图区域，按住鼠标拖动地图可移动展示区域。
  8. 完成城市区域地图的适当移动和缩放后，可以通过以下三种方式选择场景范围：
    • 单击区域选择范围：单击选中已购买（授权）的某个区域，如果购买的为地级市行政区，单击后将下钻展示县级行政区，您可以继续单击选择该县级行政区。被选中后的区域会以蓝色显示。
      图 1. 单击区域展示样式
      单击区域展示样式
      图 2. 下钻到县级区域展示样式
      下钻到县级区域展示样式
    • 左侧框选工具选择区域：您可以单击系统左侧提供方形、圆形和多边形三种工具进行场景范围的框选。
      说明 多边形框选工具通过双击或单击已有的锚点结束框选范围的选择。
    • 数据输入框选择范围区域：单击左侧范围数据按钮打开场景范围数据输入框，您可以直接输入所需范围区域的GeoJSON格式文本，单击输入框下方确定后，地图上将展示您输入的GeoJSON范围区域。数据输入选择范围入口
    说明 通过以上任意一种方式选择的区域范围都将在场景范围数据文本输入框中展示，您可以从输入框内获取当前选择的范围数据。
  9. 您如果有算法参数配置的需求，可单击选择范围对话框右上角的高级配置，在不同的城市基底子组件参数编辑器内，修改子组件的算法参数内容。完成修改后单击确定完成参数配置。高级配置参数
  10. 单击选择范围对话框右下角的确定即可完成城市三维场景构建器组件的添加并加载组件框选的数据范围区域；单击上一步可以退回到选择子组件对话框，重新选择所需城市基底子组件；单击取消可以取消添加城市三维场景构建器组件。

添加组件并使用空间数据项目方式选择场景范围区域

  1. 在组件栏内选择地图 > 城市三维场景构建器组件。
  2. 在选择创建方式对话框内选择空间数据项目，并单击创建。创建空间数据项目
  3. 在选择空间数据项目对话框中，单击选中一个已有的空间项目。
    说明 如果在选择空间数据项目对话框内，没有任何已创建的空间数据项目，您可以单击对话框右上角的前往空间构建平台创建项目，进入空间构建平台自定义创建项目数据，具体创建项目详情请参见管理项目面板。
  4. 选中一个空间项目后，单击对话框下方的下一步即可进入添加图层对话框；单击取消可以取消添加城市三维场景构建器组件。选择项目
  5. 在进入某个空间数据项目的添加图层对话框内，可以自定义在城市基底数据和业务数据面板中二选一，选择您所需的城市基底数据或业务数据内容。
    • 城市基底数据：包括自定义空间项目中的环境和建筑模块的空间数据。若自定义空间数据项目中没有包括某个基底数据的内容，可以单击该暂无数据的基底数据内的空间构建平台或者单击添加图层对话框右上角的前往空间构建平台创建项目，进入平台内添加所需基底数据。

      如果您需要配置算法参数，可单击添加图层对话框右上角的高级配置，在不同的城市基底数据和业务数据的参数编辑器内，查看或修改对应数据算法参数内容。

      高级配置面板
    • 业务数据：您在空间项目中自定义设置的业务所需的点线面数据，及项目中的环境和建筑基底数据。单击某个业务数据后，选择该数据需要展现的一种业务效果，在页面右侧会自动弹出配置映射字段的面板，您可在配置面板中设置相关字段。业务数据面板

      具体创建空间项目的业务数据内容，请参见项目编辑器页面管理。

  6. 单击添加图层对话框右下角的确定即可完成城市三维场景构建器组件的添加并加载空间数据项目内的数据范围区域；单击上一步可以退回到选择空间数据项目对话框，重新选择所需项目；单击取消可以取消添加城市三维场景构建器组件。

配置

配置面板
  • 图表尺寸：包括组件的宽度和高度，单位为px。可单击锁定长宽比按键锁定组件的宽高比，等比例修改组件的宽高。再次单击进行解锁，解锁后宽高比不受限制。
  • 图表位置：包括组件的横坐标和纵坐标，单位为px。横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
  • 旋转角度：以组件的中心为中心点，进行旋转，单位为度（°）。
    • 手动输入角度值，控制组件的旋转角度。
    • 拖动圆圈旋转控制图标图标内的黑点，控制组件的旋转角度。
    • 单击左右翻转图标图标，控制组件左右翻转样式。
    • 单击上下翻转图标图标，控制组件上下翻转样式。
  • 透明度：取值范围为0~1。为0时，图表隐藏；为1时，图表全部显示。默认为1。
  • 进入场景编辑器：城市三维场景构建器城市组件父容器详细的配置参数，需单击进入场景编辑器后，在场景编辑器面板中配置，详情请参见父容器配置项说明。

数据

数据面板

城市三维场景构建器中城市组件父容器的详细数据配置，需通过进入场景编辑器面板后，在父容器配置面板中的数据内进行设置，详情请参见父容器配置项说明。

交互

该组件没有可以配置的交互事件。

蓝图编辑器交互配置

  1. 在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
  2. 单击页面左上角的蓝图图标图标。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的城市三维场景构建器组件，在画布中可以看到如下图所示的城市三维场景构建器组件的蓝图编辑器配置参数。蓝图参数说明
    • 事件
      事件 说明
      场景加载完成 场景加载完成，不需要抛出数据。
      定位锚点屏幕位置改变 定位锚点屏幕位置改变，不需要抛出数据。
    • 动作
      参数 说明
      播放当前场景动画 播放当前场景动画，不需要参数。
      暂停停当前场景动画 暂停当前场景动画，不需要参数。
      停止当前场景动画 停止当前场景动画，不需要参数。
      屏幕定位锚点开关 是否需要屏幕定位锚点，动作传入数据为object类型，参数示例如下所示。
      {
  "flag": true // 是否需要屏幕定位锚点
}
      添加屏幕定位锚点 添加三维空间定位锚点坐标值信息及锚点作用的对象ID，动作传入数据为object类型，参数示例如下所示。
      {
  "anchors": [      //三维空间定位锚点坐标值与关联ID
    {
      "lng": 1,     //经度
      "lat": 1,     //纬度
      "altitude": 1,//高程
      "id": ""      //锚点作用对象ID
    }
  ]
}
      更新组件配置 更新组件配置，不需要参数。
      显示 显示组件，参数示例如下所示。
         {
     "animation": {
     // 动画方式，可选fade，不填无动画。
     "animationType": "",
     // 显示延时，单位为ms。
     "animationDuration": 1000,
     // 显示动画函数，可选linear|easeInOutQuad|easeInOutExpo。
     "animationEasing": "linear"
     }
   }
      隐藏 隐藏组件，参数示例如下所示。
         {
     "animation": {
     // 动画方式，可选fade，不填无动画。
     "animationType": "",
     // 显示延时，单位为ms。
     "animationDuration": 1000,
     // 显示动画函数，可选linear|easeInOutQuad|easeInOutExpo。
     "animationEasing": "linear"
     }
   }
      切换显隐状态 切换组件显示或者隐藏。参数示例如下所示。
          {
      // 显示为true，隐藏为false。
      "status": true,
      // 显示动画。
      "animationIn": {
        // 动画方式，可选fade，不填无动画。
        "animationType": "fade",
        // 显示延时，单位为ms。
        "animationDuration": 1000,
        // 显示动画函数，可选linear|easeInOutQuad|easeInOutExpo。
        "animationEasing": "linear"
      },
      // 隐藏动画。
      "animationOut": {
        // 动画方式，可选fade，不填无动画。
        "animationType": "fade",
        // 隐藏延时，单位为ms。
        "animationDuration": 1000,
        // 隐藏动画函数，可选linear|easeInOutQuad|easeInOutExpo。
        "animationEasing": "linear"
      }
    }
      移动 将组件移动到指定位置。参数示例如下所示。 
          {
      // 移动方式。绝对定位：to，相对定位：by。默认值：to。
        "positionType": "to",
      // 指定位置。x坐标，y坐标。
      "attr": {
        "x": 0,
        "y": 0
      },
      // 动画方式。
      "animation": {
        "enable": false,
        // 动画延时。
        "animationDuration": 1000,
        // 动画曲线。可选值为：linear|easeInOutQuad|easeInOutExpo。
        "animationEasing": "linear"
      }
    }