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

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

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

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

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


本例对应官方的例子是:Query a SceneLayer's linked FeatureLayer

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

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

换个视角:

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

那我们就开始吧!


给出引用

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
}
});

map和view

对于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]又是什么?

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

通过查阅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得知:

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

继承自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()方法,各位看官请往上翻一翻啦~

ps:转载请注明出处。http://www.cnblogs.com/onsummer/p/6421503.html

上一篇:OUI-67076 : OracleHomeInventory was not able to create a lock file" in Unix


下一篇:ArcGIS API for JavaScript 4.2学习笔记[7] 鹰眼(缩略图的实现及异步处理、Promise、回调函数、监听的笔记)