ArcGIS Maps SDK for JavaScript系列之三:在Vue3中使用ArcGIS API加载三维地球

2023-10-14 09:14:27 浏览数 (1)

要在Vue 3中使用ArcGIS API for JavaScript加载和展示三维地球,需要用到ArcGIS提供的SceneView类。SceneView类是ArcGIS API for JavaScript中用于呈现和操作3D场景的类。下面我们先来了解下SceneView类的常用属性和方法

SceneView类的常用属性

  1. container:设置场景视图的容器元素,比如一个div元素。
  2. map:设置或获取场景视图中使用的地图。
  3. spatialReference:获取或设置场景视图的空间参考。
  4. zoom:获取或设置场景视图的缩放级别。
  5. camera:获取或设置场景视图的相机位置和朝向。
  6. center:获取或设置场景视图的中心点。
  7. constraints:获取或设置一组约束条件,如缩放级别范围,相机倾角范围等。
  8. interacting:获取场景视图是否正在交互。
  9. navigating:是否正在导航视图(例如平移时)。
  10. navigation:用于配置视图导航行为的选项。
  11. Viewpoint:获取或设置场景视图的视图点,包括位置、缩放级别、相机朝向等信息。

SceneView类的常用方法

  1. when:在场景视图及其所有相关资源加载完成后执行一个回调函数。可以通过该方法来执行一些场景加载完成后的操作。
  2. goTo:移动视图到指定位置,可以指定target参数来指定位置,如经纬度坐标、图层范围等。
  3. hitTest:从给定的屏幕坐标处执行一次命中测试,以查找命中的图形或要素。
  4. toMap:将屏幕坐标转换为场景坐标系对应的地理坐标。
  5. toScreen:将场景坐标转换为屏幕坐标。
  6. takeScreenshot:获取当前场景视图的屏幕截图。

vue3中使用SceneView类创建三维地球

项目准备

创建Vue 3项目: 使用vite构建工具创建一个新的Vue项目,运行以下命令:

代码语言:javascript复制
npm create vite@latest

创建vite项目,输入项目名称vite-vue3-arcgis,选择vue框架,并选中JavaScript语音创建项目,创建成功后,进入vite-vue3-arcgis文件夹,并使用npm i 安装依赖

安装ArcGIS JS API依赖包: 在项目目录下,运行以下命令安装需要的依赖包:

代码语言:javascript复制
npm install @arcgis/core

引入ArcGIS API

在Vue组件中引入ArcGIS API for JavaScript模块:在需要使用地球的Vue组件中,使用import语句引入ArcGIS API:

代码语言:javascript复制
import Map from '@arcgis/core/Map.js'; 
import SceneView from "@arcgis/core/views/SceneView.js";

创建Vue组件

创建vue组件,在components文件夹下新建ArcGisMap.vue组件

准备三维地球展示的容器元素: 在ArcGisMap.vue组件的模板中,准备一个div元素作为地球的容器:

代码语言:javascript复制
<template>
  <div id="viewDiv"></div>
</template>

创建一个初始化函数initArcGisMap()用于创建Map实例和SceneView实例:

代码语言:javascript复制
const initArcGisMap = () => {
  const map = new Map({
    basemap: "topo-vector"
  });

  view = new SceneView({
    center: [-118.80500, 34.02700],
    zoom: 4,
    container: "viewDiv",
    map: map
  });
  view.ui.components = [];
}

在OnMounted中调用初始化函数initArcGisMap

引入vue的OnMounted生命周期函数,并在其中调用上面定义的initArcGisMap方法,

代码语言:javascript复制
import { onMounted } from 'vue'
onMounted(() => {
  initArcGisMap()
})

运行浏览器,可以看到三维地球已经呈现在了浏览器中

完整代码如下:

代码语言:javascript复制
<template>
  <div id="viewDiv">
  </div>
</template>

<script setup>
import { onMounted } from 'vue'
import Map from '@arcgis/core/Map.js'; 
import SceneView from "@arcgis/core/views/SceneView.js";
let view
onMounted(() => {
  initArcGisMap()
})

const initArcGisMap = () => {
  const map = new Map({
    basemap: "topo-vector"
  });

  view = new SceneView({
    center: [-118.80500, 34.02700],
    zoom: 4,
    container: "viewDiv",
    map: map
  });
  view.ui.components = [];
}
</script>
<style scoped>  #viewDiv {
    width: 100%;
    height: 100vh;
  }
</style>

创建Camera对象

在 SceneView 中,可以通过创建 Camera 对象并将其设置为 SceneView 的 camera 属性来定义相机。Camera 对象将定义要在 SceneView 中使用的相机属性,如位置、方向、投影方式等。

  • 引入Camera对象 要使用Camera对象,需要先引入Camera模块 import Camera from "@arcgis/core/Camera.js";
  • 创建Camera实例 通过new Camera()方法来创建Camera的实例
代码语言:javascript复制
  var camera = new Camera({
    position: { // 相机位置
      x: -123.12,
      y: 40.57,
      z: 2000 // 高度
    },
    tilt: 60, // 相机俯仰角
    heading: 0 // 相机偏航角
  });
  • 将SceneView实例的camera属性设置为上面的camera实例
代码语言:javascript复制
  view = new SceneView({
    center: [-118.80500, 34.02700],
    zoom: 4,
    container: "viewDiv",
    map: map,
    camera: camera // 设置相机
  });

运行浏览器,可以看到,地图视角已经按照camera设置的参数显示了

Camera的常用属性
  1. position:相机的位置,可以使用 xyz 坐标表示。例如:camera.position = { x: -118, y: 34, z: 5000 };
  2. heading:相机的偏航角,表示相机绕其位置的垂直轴旋转的角度。例如:camera.heading = 180;
  3. tilt:相机的俯仰角,表示相机绕其位置的水平轴旋转的角度。例如:camera.tilt = 45;
  4. fov:相机的视场角,表示可视范围的大小。例如:camera.fov = 60; 示例代码如下:
代码语言:javascript复制
 var camera = new Camera({
    position: {
      x: -118,
      y: 34,
      z: 5000
    },
    heading: 180,
    tilt: 45,
    fov: 60
  });
Camera的常用方法
  1. clone():创建相机的副本。例如:var clonedCamera = camera.clone();
  2. fromJSON() :根据传入的 JSON 对象,提取其中的属性值,并使用这些属性值创建一个新的 Camera 对象。这可以方便地将已存储的相机属性还原为 Camera 对象。
  3. toJSON():将相机属性转换为 JSON 对象。例如:var cameraJson = camera.toJSON();

下面的代码我们使用 fromJSON() 方法来初始化 Camera 对象:

代码语言:javascript复制
const initArcGisMap = () => {
  const map = new Map({
    basemap: "topo-vector"
  }); 
  var cameraJson = {
  "position": {
    "x": -118,
    "y": 34,
    "z": 5000
  },
  "heading": 180,
  "tilt": 45,
  "fov": 60,
  "near": 0.1,
  "far": 100000
}; 
// 使用 fromJSON() 方法创建一个新的 Camera 实例
var camera = Camera.fromJSON(cameraJson);
console.log(camera) 
  view = new SceneView({
    center: [-118.80500, 34.02700],
    zoom: 4,
    container: "viewDiv",
    map: map,
    camera: camera // 设置相机
  });
  view.ui.components = []; 
}

在上面的代码中,我们创建了一个包含相机信息的 JSON 对象 cameraJson,然后通过 fromJSON() 方法将其转换为 Camera 对象 camera。这样可以快速将已存储的相机信息还原为可操作的对象。

需要注意的是,fromJSON() 方法只能用于从 ArcGIS 产品生成的 JSON 对象初始化 Camera 对象。如果传入的 JSON 对象不符合相机属性的结构,则该方法可能会抛出错误。确保传入的 JSON 对象与相机属性的期望结构相匹配。

通过使用 fromJSON() 方法,可以轻松地将相机的状态从一个应用程序传递到另一个应用程序,或者将相机属性保存到持久存储中以备将来使用。

好啦,这节就先到这里吧,更多内容小伙伴们可以上ArcGIS的官网进行查看学习。

0 人点赞