重大更改

GeoScene Maps SDK for JavaScript 所有重大更改的综合指南，按发布版本排序。本指南有助于用户在其应用中升级 API 版本。

4.29 ​

• 在版本 4.29 中，仅启用 WebGL2 的浏览器支持 2D 和 3D。有关详细信息，请参阅系统要求。

• 对于本地构建，不建议在 4.29 中使用 5.84.0 之前的 Webpack 版本。这与 Webpack 中的错误修复有关。

• MapView 上的 hitTest() 方法不再在 VectorTileLayer 所返回图形的属性中包含 layerId 和 layerIndex。要获取此信息，请改用图形的原点属性。有关详细信息，请参阅 VectorTileLayer hitTest 部分。

• 在 VectorTileLayer 的命中测试结果中返回的图形的图层属性现在为 null。 使用 origin.layer 属性访问图形源自哪个 VectorTileLayer。

• 在版本 4.29 中，ListItemPanel 不包含任何内边距。

• FeatureLayer 无法再使用 labelExpression 进行标记， labelExpression 仅与 MapImageLayer 一起使用。请改为使用 labelExpressionInfo。

• WFSLayer 现在在从服务中获取要素时使用分页，这意味着将发送多个请求来检索要素，而不仅仅是一个请求。要匹配前面的行为，请设置 maxPageCount: 1 并增加 maxRecordCount 的值。

• 编辑器的视图模型不再创建 FeatureFormViewModel 和 SketchViewModel 的单个实例。在此版本之前，如果给定 EditorViewModel 的实例，则其 featureFormViewModel 和 sketchViewModel 属性在整个 EditorViewModel 生命周期中始终引用其各自视图模型类的同一单个实例。这意味着使用这些视图模型的某些操作可以运行一次，并且对所有后续编辑工作流仍然有效 (例如，设置属性或在其上安装事件侦听器)。从版本 4.29 开始，FeatureFormViewModel 和 SketchViewModel 的新实例将用于每个编辑工作流。如果没有活动的编辑工作流，则 FeatureFormViewModel 和 SketchViewModel 属性为 null。编辑工作流开始时，这些属性将具有值，但对它们所做的任何更改或事件处理程序仅适用于该工作流的持续时间。

• MeshGeoreferencedRelativeVertexSpace 已移除。请改用带有原点的 MeshGeoreferencedVertexSpace。如果未指定原点，则地理配准的顶点空间将被视为绝对顶点空间。

• 通过 create 函数 (如 createSphere) 创建的网格现在始终使用相对顶点空间创建，其中网格坐标将偏移到创建网格的位置。以前，网格坐标始终是绝对的。如果未将顶点空间类型提供为 create 函数的选项，则根据空间参考选择顶点空间。如果是地理或 WebMercator，则使用 MeshLocalVertexSpace，否则使用 MeshGeoreferencedVertexSpace。

• 现在，网格 centerAt 将使网格相对于网格顶点空间的原点居中。以前，使用 createSphere 在某个位置创建一个球体，然后调用 centerAt (以相同位置作为参数)，可移动球体，使球体中心与该位置对齐。现在，使用创建网格的同一位置调用 centerAt 不会有任何效果。请使用偏移或通过 mesh.extent.height/2 来调整 centerAt 位置。

• 在此版本中，Popup 类中的 FetchPopupFeaturesResult 类型定义从 API 中删除了以下属性：

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

4.28 ​

移除 watchUtils ​

watchUtils 类自版本 4.24 起已弃用，并已从此版本的 API 中移除。这是一个重大更改，应用程序需改用 reactiveUtils，它提供了显著改进的实用程序和便利功能，用于监视从 Accessor 继承的属性。

TypeScript 重大更改 ​

• IPromise 4.28 中移除了 TypeScript 定义。请改为使用本机 Promise。

• 在 4.28 中移除了 *Constructor TypeScript 定义的所有实例。将 __geoscene.ModuleConstructor 的用法更新为 typeof __geoscene.Module，或从 typings 中 import 模块并将类型赋值改为 typeof Module，例如：

// Type definitions at 4.27 and earlier
type IGeoSceneDeps = [
 __geoscene.MapConstructor,
 __geoscene.MapViewConstructor
];

// Type definitions at 4.28 and later
type IGeoSceneDeps = [
 typeof __geoscene.Map,
 typeof __geoscene.MapView
];

其他重大更改 ​

• 经过身份验证的用户是图层所有者、管理员或具有完全编辑权限的用户，其提升的用户权限将应用于编辑行为和数据中可用的行为。要选择退出，请将 geosceneConfig.userPrivilegesApplied 设置为 false。

• OAuthInfo.flowType 的 auto 和 authorization-code 值不再检查 popup 属性是否设置为 true 或 false。此更改会影响使用 auto flowType 并将 popup 属性设置为 true 的应用程序。需要更新正在使用的回调页面，以支持双因素身份验证。为此，我们更新了默认的 oauth-callback.html 以支持两步方法，但如果使用一步流程，它仍然有效。

• 在 Popup、Features 或 Feature 微件中，date 字段的默认格式现在是 short-date-short-time，而不是 long-month-day-year。例如，以前显示为 December 30, 1997 的日期现在将显示为 12/30/1997 6:00 PM。

• VoxelLayer.popupEnabled 的默认值已从 true 更改为 false。

• MapView.goTo 和 MapView.toScreen 的默认行为已更改为根据视图中心自动规范化。将 GoToOptions2D 或 ToScreenOptions2D 中的 pickClosestTarget 设为 false 可禁用此行为。

• 由于 Popup 微件重构为使用 Calcite 组件，因此移除了该微件上的 maxInlineActions 属性。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

4.27 ​

• Popup 微件的加载会被延迟，直到视图准备就绪且已完成更新，并且仅当 View.popupEnabled 设置为 true (默认值)、调用 View.openPopup() 或某些微件 (如 Search) 需要弹出窗口时，才会加载该微件。在大多数情况下，应用程序无需更新，可以继续运行。但是，如果试图在实例化之前访问 view.popup 属性，可能会出现一些问题。有关如何更新应用程序以利用这些改进性能的详细信息，请参阅加载弹出窗口。或者，您也可以在实例化视图时简单创建一个新的弹出窗口实例，如以下代码片段所示。注意：此代码未利用延迟加载。

// Create a new MapView
const view = new MapView({
 // set the popup property to a new instance of Popup
 popup: new Popup(...)
});

• 自 4.27 版起，已移除 AMD 模块中实现的兼容性 (在运行时不支持 async/await)。

• 在不使用 RouteLayer 的情况下创建 Directions 微件的旧工作流已在 4.24 版本中弃用，并在 4.27 版本中移除。必须使用 RouteLayer 创建 Directions 微件。

• SunLighting.ambientOcclusionEnabled 和 SunLighting.waterReflectionEnabled 属性在 4.27 版中已弃用，没有任何影响。环境遮蔽和反射现在由新的自适应渲染行为自动控制。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

4.26 ​

• 现在，ImageryTileLayer 的默认标题可像其他图层一样从其 URL 创建，而不是从服务根资源的 name 属性进行创建。

• 将 Editor.layerInfos updateEnabled 设置为 false 不会禁用 delete 功能。在此版本之前，将 updateEnabled 设置为 false 将阻止更新和删除某个要素。现在，如果要执行删除操作，还需将 deleteEnabled 设置为 true。

• VoxelIsosurface.colorLocked 的默认值已从 true 更改为 false。

• Editor 微件的 UI 已进行细微更新，以使用 accordion 组件而不是 popover 显示捕捉设置。

• GraphSearchStreaming 的 globalIdsFilter 属性已替换为 idsFilter。

• 现在，networkService.fetchServiceDescrip 方法会返回一个 TravelMode 类型的 defaultTravelMode 属性对象，而不是字符串类型。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

知识图谱 beta 版更改 ​

knowledgeGraphService 仍处于测试阶段。仅 GeoScene Enterprise 4.1 及更高版本才支持 4.26 版本中的功能。要在 GeoScene Enterprise 4.0 及更早版本中访问 knowledgeGraphService，请使用版本 4.25。

在 4.26/Enterprise 4.1 中，更新了知识图谱服务的数据模型和服务定义。除 GraphSearchStreaming.globalIdsFilter 外，此更改不会破坏使用 knowledgeGraphService 方法编写的客户端代码。下表列出了本次版本中移除的知识图谱属性：

4.25 ​

• AggregateField 已退出测试版，不再具有 outStatistic 属性。聚合字段现在使用 onStatisticField 和 onStatisticExpression 进行定义。

• MapNotesLayer.listMode 的默认值已从 show 更改为 hide-children。

• VectorTileLayer.setSpriteSource() 方法现在接受 SpriteSourceUrlInfo 或 SpriteSourceImageInfo 对象，而不是 sprite 源的 URL 字符串。

• ClosestFacilitySolveResult.facilities、incidents、pointBarriers 和 ServiceAreaSolveResult.facilities、pointBarriers 已从 Point[] 类型更改为 FeatureSet 类型。

• ClosestFacilitySolveResult.polygonBarriers 和 ServiceAreaSolveResult.polygonBarriers 已从 Polygon[] 类型更改为 FeatureSet 类型。

• ClosestFacilitySolveResult.polylineBarriers 和 ServiceAreaSolveResult.polylineBarriers 已从 Polyline[] 类型更改为 FeatureSet 类型。

• ClosestFacilitySolveResult.routes、ServiceAreaSolveResult.serviceAreaPolygons 和 ServiceAreaSolveResult.serviceAreaPolylines 已从 Graphic[] 类型更改为 FeatureSet 类型。

• PopupTemplate.relatedRecordsInfo 属性已移除。在弹出窗口中处理相关记录时，使用 RelationshipContent.orderByFields 属性控制排序选项。

• RasterShadedReliefRenderer.hillshadeType 默认值已从 multi-directional 更改为 traditional。

• 来自 WebMap 的 TimeSlider 设置将不再在初始化时自动应用于 TimeSlider 微件。请改用 getPropertiesFromWebMap 方法。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

4.24 ​

• 自 4.20 起，任务已弃用。它们在 4.24 中已被移除。可改为使用 geoscene/rest 文件夹中的类和模块。这将使您的代码更易融入到更模块化的应用程序设计中，并减少不必要的依赖性（您只需导入所需内容即可）。新的 rest 模块是不需要构造函数的函数，因此您可立即使用它们的方法。请参阅以下 Complete list of removed tasks 下拉列表中已移除任务模块的完整列表。

• 如果应用程序支持从右到左，则 MapView 或 SceneView 中的默认微件 UI 的位置将不再更改。

• API 现在默认使用 WebGL2，并且会根据浏览器的不同回退到 WebGL1。使用仅 WebGL1 扩展的自定义 WebGL 图层需要更新以检测存在哪个上下文并使用正确的扩展/本机 WebGL2 功能。

• 属性 date 和 displayUTCOffset 已从 VirtualLighting 中移除，因为此照明类型不依赖于日期和时间。但这意味着 view.environment.lighting 属性并不总是具有 date 或 displayUTCOffset 属性。对于某些假定此属性始终存在的应用程序，这可能是重大更改。

• MapView.hitTest 和 SceneView.hitTest 命中测试结果现在返回一个数组，包括 GraphicHit、MediaHit 和 RouteHit 结果。应更新使用 hitTest() 方法的现有应用程序以检查结果类型。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：

以下任务已在至少 3 个版本中弃用，现已从 API 中移除：

4.23 ​

• AnimatedFlowRenderer，在 4.22 的测试版中发布，在此版本中已重命名为 FlowRenderer。

• 使用默认版本的弹出窗口现在会将附件显示为缩略图，而不是列出的链接。

• Directions.lastRoute 和 DirectionsViewModel.lastRoute 现在返回 RouteLayerSolveResult 类型的值。

• Directions.getDirections() 和 DirectionsViewModel.getDirections() 现在返回一个解析为 RouteLayerSolveResult 的承诺。

• 使用 add() 或 addMany() 添加到 DirectionsViewModel.stops 的停靠点必须为 Stop 类型，而非 Graphic 类型。

• SliceViewModel.clear() 现在仅清除切片的 SliceViewModel.shape，而不会影响 SliceViewModel.excludedLayers 和 SliceViewModel.excludeGroundSurface。如果需要，应手动清除这些属性。

• 在 SceneView 中，标注外部使用的 TextSymbol 或 TextSymbol3DLayer 的默认垂直对齐方式已从 middle 更改为 baseline。若要恢复到早期版本的对齐行为，请将文本符号的 verticalAlignment 设置为 middle。

以下类、方法、属性和事件已在至少两个版本中弃用，现已从 API 中移除：