ArcGIS JS API 4.x：FeatureLayer重复请求同一要素的解决方法

问题背景 #

使用ArcGIS Javascript API 4.26创建最简FeatureLayer时，代码如下：

// 创建图层
var myLayer = new FeatureLayer({
    url: "https://...",
    renderer: {
               type: "simple",
               symbol: {
                        type: "simple-fill",
                        color: "yellow",
                        style: "solid",
                        outline: {
                                  color: "red",
                                  width: 1
                                 }
               }
              }
});

// 添加到地图
view.when(function () {
    view.map.add(myLayer);
});

实际仅返回单个要素，但Chrome网络面板显示向服务器发起了3次请求，每次响应内容相同，仅请求参数quantizationParameters中的xmin、ymin、xmax、ymax值不同。需要实现仅发起一次请求，解决以下问题：

1. ArcGIS 4.x中如何关闭quantize？（3.x的quantize: "false"参数无效）
2. 还有哪些方法可实现仅发起一次请求？

已尝试的无效方法 #

使用ArcGIS Javascript API 3.x的旧参数quantize: "false"，无效果，请求仍会携带quantizationParameters参数：

// 创建图层
var myLayer = new FeatureLayer({
    url: "https://...",
    quantize: "false",
    // 其他配置...
});

解决方案 #

1. 4.x中关闭quantize的方法 #

ArcGIS JS API 4.x已移除quantize参数，需通过以下方式禁用空间量化：

• 设置useViewGeometry为false：该参数控制图层是否根据当前视图的空间范围和空间参考调整查询请求，设置为false后，图层将使用服务默认的空间参考，不再生成不同的quantizationParameters，示例代码：

var myLayer = new FeatureLayer({
    url: "https://...",
    useViewGeometry: false, // 禁用视图空间参考适配，避免quantize参数变化
    renderer: { /* 渲染器配置 */ }
});

• 明确指定outSpatialReference：将其设置为与服务或视图一致的空间参考，固定请求的空间参数，避免因视图初始化过程中的范围调整生成不同请求：

var myLayer = new FeatureLayer({
    url: "https://...",
    outSpatialReference: view.spatialReference, // 固定输出空间参考
    renderer: { /* 渲染器配置 */ }
});

2. 其他实现单次请求的方法 #

• 提前加载客户端要素集：先通过queryFeatures获取目标要素，再基于客户端要素创建FeatureLayer，完全避免服务请求重复：

// 先查询要素
var query = new Query();
query.objectIds = [目标要素ID]; // 仅查询需要的单个要素
query.returnGeometry = true;

arcgisRest.queryFeatures({
    url: "https://.../query",
    query: query
}).then(function(response) {
    // 基于客户端要素创建图层
    var myLayer = new FeatureLayer({
        source: response.features,
        fields: response.fields,
        renderer: { /* 渲染器配置 */ }
    });
    view.map.add(myLayer);
});

• 稳定视图后再添加图层：视图初始化过程中可能会多次调整范围，导致图层发起多次请求，可等待视图完全稳定后再添加图层：

view.when(function () {
    // 等待视图的范围稳定事件
    view.watch("stationary", function(isStationary) {
        if (isStationary) {
            view.map.add(myLayer);
            // 取消监听，避免重复添加
            view.removeWatch("stationary");
        }
    });
});

• 设置固定过滤条件：通过definitionExpression指定唯一要素的过滤条件，确保无论视图范围如何，查询结果固定，服务端可缓存该请求：

var myLayer = new FeatureLayer({
    url: "https://...",
    definitionExpression: "objectid = 目标ID", // 固定过滤单个要素
    renderer: { /* 渲染器配置 */ }
});

• 启用图层缓存：若服务支持，设置cacheEnabled: true，让API缓存请求结果，避免重复发起相同请求：

var myLayer = new FeatureLayer({
    url: "https://...",
    cacheEnabled: true, // 启用客户端缓存
    renderer: { /* 渲染器配置 */ }
});

内容的提问来源于stack exchange，提问作者Robert Smith