重大更改

GeoScene Maps SDK for JavaScript 所有重大更改的综合指南，按发布版本排序。本指南有助于用户在其应用中升级 API 版本。向下滚动以查找正在使用的 API 的当前版本，然后追踪更改直至最新版本，并进行相关更新。

要查看所有最新功能和改进，请参阅发行说明。要查看所有版本中添加的所有功能和改进，请参阅早期版本发行说明部分。

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。

以下类、方法、属性和事件已在至少两个版本中被弃用，现已从 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

这是 4x API 的第一个正式版本。由于之前的 4x 版本在 beta 中，因此此处不考虑它们。