ArcGIS API for JavaScript 4.2学习笔记[21] 对3D场景上的3D要素进行点击查询【Query类学习】

ArcGIS API for JavaScript 4.x：
从3.x版本升级到4.x，变化比较大，学习、开发体验也会不一样。

本系列是转载至博客园原创作者-秋意正寒-致敬!

原地址：https://www.cnblogs.com/onsummer/p/6421503.html

---

有人问我怎么这个系列没有写自己做的东西呢？

大哥大姐，这是“学习笔记”啊！当然主要以解读和笔记为主咯。

也有人找我要实例代码（不是示例），我表示AJS尚未成熟，现在数据编辑功能才简略地在AJS 4.3中出现，4.2是没有的，widget和分析功能也不是很完善，还是再等等吧，先学着基础，其他的以后再说。

本节我会紧随这个例子学习一下Query这个类，作为图层查询方法的重要参数，它起了传递查询用的信息的作用。

---

本例对应官方的例子是：Query a SceneLayer’s linked FeatureLayer

这个例子操作起来很简单，等地图加载完成后，点击对应的3D白色模型，会出现一个popupTemplate弹窗，显示一个表格，为这个大楼的信息。如下图：

换个视角：

那我们就开始吧！

---

给出引用

require([
  "esri/Map",
  "esri/views/SceneView",
  "esri/layers/SceneLayer",
  "esri/layers/FeatureLayer",
  "esri/tasks/support/Query",
  "dojo/domReady!"
  ],
   function(Map, SceneView, SceneLayer, FeatureLayer, Query){
    ...
    }
)

数据方面，用到了场景图层和要素图层；

查询方面，用到了Query模块。

函数参数

function(Map, SceneView, SceneLayer, FeatureLayer, Query){
    var map = new Map({...});
    var view = new SceneView({...});
    var sceneLayer = new SceneLayer({...});
    map.add(sceneLayer);
    var featureLayer = new FeatureLayer({...});
    featureLayer.load().then(attributesReady);
    function attributesReady(){
      ...  
    }
}

套路，先把大骨架弄出来，然后逐个击破。

多了一个场景图层，多了一个要素图层，在要素图层加载完成后进行一个异步操作attributesReady()。

还算简单，先把map和view的代码看看（太基础了对于看到这里的人来说，我就缩起来了）

var map = new Map({
  basemap: "dark-gray",
  ground: "world-elevation"
});
var view = new SceneView({
  container: "viewDiv",
  map: map,
  camera: {
    position: {
      x: -8241580,
      y: 4964925,
      z: 2311,
      spatialReference: 3857
    },
    heading: 32.5,
    tilt: 64.9
  }
});

对于view，可以看到除了camera属性外还多了两个属性，这里不作为重点，可以参考API。

看看两个layer：

var sceneLayer = new SceneLayer({
  url: "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/New_York_LoD2_3D_Buildings/SceneServer/layers/0",
  popupEnabled: false
});

map.add(sceneLayer);

var featureLayer = new FeatureLayer({
  url: "https://services2.arcgis.com/z2tnIkrLQ2BRzr6P/arcgis/rest/services/New_York_OBJECTID/FeatureServer/0",
  outFields: ["*"],
  popupTemplate: {
    title: "...",
    content: [{type: "fields"}],
    fieldInfos: [{...}, {...}, {...}, {...}]
  }
});

在我的理解中，sceneLayer应该是绿色的圆锥体，而featureLayer则是用于支持空间查询的数据图层。看得出这里都是使用了ArcGIS Server上的服务。

featureLayer的弹窗模板较为复杂，不是这里讨论的内容，我就把源代码换成了省略号以精简页面，大概意思就是从featureLayer中获取fields作为弹窗的content，而fieldInfos则是对应字段的输出格式。

重点应该是下面这个方法体：

featureLayer.load().then(attributesReady);

function attributesReady() {
    view.on("click", function(event){
        var screenPoint = {...};
        view.hitTest(screenPoint)        .then(function(response){...})
        .then(function(graphic){...})
        .then(function(results){...})
        .otherwise(function(err){...})
    })
}

逐个击破，首先是的view的click事件，触发该事件后立刻获取当前点击的点screenPoint，并将点传递到hitTest方法中，紧接着就是四层异步操作。

第一层：

.then(function(response) {
      var result = response.results[0];
      if (result && result.graphic) {
          return result.graphic;
      }
})

似乎是获取results[0]后判断其是否为空或者其几何属性是否为空，如果不是空，返回其几何属性。

这里就要查一下了，这个response 是什么东西？而results[0]又是什么？

通过查阅SceneView的hitTest()方法，可以得知results[0]也就是result变量就是hitTest的返回值。

该result变量拥有两个属性，一个是mapPoint，为Point类型；

另一个是graphic，为Graphic类型。

前一个属性代表了点击的那个点位置，后面则为点击的要素的几何体。

如果都不为空，返回几何体，传入下一个then：

.then(function(graphic) {
  var objectid = graphic.attributes.objectid;
  var query = new Query();
  //设置query的参数
  query.where = "objectid = " + objectid;
  query.returnGeometry = false;
  query.outFields = ["NAME", "CNSTRCT_YR", "LSTMODDATE",
    "LSTSTATYPE", "NUM_FLOORS"
  ];
  //执行查询
  return featureLayer.queryFeatures(query);
})

传入的graphic，获取其objectid属性

然后实例化一个Query对象名为query，设置好where查询语句（应该是SQL语句吧）、是否返回几何体（否）、输出字段信息，就可以执行查询。

featureLayer的queryFeatures()方法接受Query对象，返回一个类型为FeatureSet的Promise对象。

这个FeatureSet对象传递给下一个then：

.then(function(results) {
  if (results && results.features.length > 0) {
    view.popup.open({
      features: results.features,
      location: event.mapPoint
    });
  }
})
.otherwise(function(err) {

  console.error(err);

});

不要放弃啊！

因为马上后面就没有代码了~那个otherwise只是Promise对象除了then之外的另一个而已~出错了就用otherwise来处理异常~

这个then，如果传入的FeatureSet不为空或者FeatureSet里面的features个数>0

那么就按照featureLayer里写好的格式弹窗显示信息~完事。

---

总结一下

这个例子就是获取点击点——使用query对象进行空间查询——返回FeatureSet——输出其预置好的Popup即可~

没有上一个那么难了吧~~~

文章的最后，我来对Query这个对象进行学习：

Query对象的学习

查询API得知：

继承自Accessor，分类在esri/tasks/support/Query下。

需要注意的是，使用Query类需要在ArcGIS Online或者ArcGIS Server服务的支持下进行。

翻译官方的解释，意思就是：

Query对象是一些空间查询的参数，它作用于layer对象，通过参数的设置，可以筛选出layer中需要的要素。

可以使用QueryTask类的excute()方法进行空间查询，也可以在图层实例的queryFeatures()方法中使用Query对象。

使用它，通常返回结果是FeatureSet对象。

Query类拥有非常多的参数，方法只有一个toJSON()，这个方法是将这个类的实例序列化成JSON而存在的，不做重点介绍。

参数就摘几个吧：

distance（Number类型）、geometry（Geometry类型）、num（Geometry类型）、outFields（String[]）、outSpatialReference（SpatialReference）、returnGeometry（Boolean）、units（String）、where（String）

distance是缓冲区分析的距离；

geometry是用于空间查询用的几何体；

num是查询得到的要素个数；

outFields是查询结果要素集的字段信息；

outSpatialReference是查询结果要素集的空间参考信息；

returnGeometry是一个布尔变量，如果为真，那么返回的要素集中每一个要素就会包含几何体；

units是缓冲区分析的单位；

where是空间查询用的SQL语句。如:query.where = “NAME = ‘“ + stateName + “‘“;

如何用它呢？

给个简单的例子，使用QueryTask的（接下来几篇博文会用到这个）：

require(["esri/tasks/QueryTask", "esri/tasks/support/Query"], function(QueryTask, Query){
  //用URL实例化一个QueryTask，应该是一个服务类型
  var queryCitiesTask = new QueryTask({
    url: "..."  
  });
  //实例化一个Query对象
  var query = new Query();
  query.geometry = mapPoint; 
  query.distance = 100;
  query.units = "miles";
  query.spatialRelationship = "intersects";
  queryCitiesTask.execute(query).then(function(result){
      //对返回的FeatureSet进行操作
  });
});

如果是图层的queryFeatures()方法，各位看官请往上翻一翻啦~