重大更改

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

4.27

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

       

  1
  2
  3
  4
  5
  // 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)。例如，一些使用带有 geoscene-loader 的 Angular 的 SDK 应用程序可能会遇到运行时错误，需要从 AMD 模块迁移以使用 @geoscene/core ES 模块。
• 在不使用 RouteLayer 的情况下创建 Directions 微件的旧工作流已在 4.24 版本中弃用，并在 4.27 版本中移除。必须使用 RouteLayer 创建 Directions 微件，如 Directions 微件示例所示。
• SunLighting.ambientOcclusionEnabled 和 SunLighting.waterReflectionEnabled 属性在 4.27 版中已弃用，没有任何影响。环境遮蔽和反射现在由新的自适应渲染行为自动控制。

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

类/属性/方法/事件	备用选项	弃用版本
promiseUtils.create()	Promise	4.24
Directions.routeServiceUrl	来自 Directions.layer 的 url	4.24
Directions.routeSymbol	来自 Directions.layer 的 directionLines	4.24
Directions.stopSymbols	来自 Directions.layer 的 RouteStopSymbols	4.24
DirectionsViewModel.highlightSegment()	DirectionsViewModel.highlight()	4.24
DirectionsViewModel.routeServiceUrl	来自 DirectionsViewModel.layer 的 url	4.24
DirectionsViewModel.routeSymbol	来自 DirectionsViewModel.layer 的 directionLines	4.24
DirectionsViewModel.stops	来自 DirectionsViewModel.layer 的 stops	4.24
DirectionsViewModel.stopSymbols	来自 DirectionsViewModel.layer 的 RouteStopSymbols	4.24
geoscene/layers/support/ImageParameters	geoscene/rest/support/ImageParameters	4.24

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.fetchServiceDescription() 方法会返回一个 TravelMode 类型的 defaultTravelMode 属性对象，而不是字符串类型。

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

类/属性/方法/事件	备用选项	弃用版本
geoscene/widgets/Slice/SlicePlane	geoscene/analysis/SlicePlane	4.23

知识图谱 beta 版更改

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

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

属性	备用选项
KnowledgeGraph.dataModel	fetchKnowledgeGraph() 返回数据模型
GraphSearchStreaming.globalIdsFilter	idsFilter
GraphProperty.searchable	SearchIndex
RelationshipType.destinationEntityTypes 和 RelationshipType.originEntityTypes	RelationshipType.endpoints
RelationshipType.strictOrigin 和 RelationshipType.strictDestination	none

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 中移除：

类/属性/方法/事件	备用选项	弃用版本
geoscene/views/layers/support/FeatureEffect	改为使用 geoscene/layers/support/FeatureEffect	4.22
geoscene/views/layers/support/FeatureFilter	改为使用 geoscene/layers/support/FeatureFilter	4.22
BasemapToggle.toggle 和 BasemapToggleViewModel.toggle 事件	另请注意 activeBasemap 属性	4.22
CSVLayerView.effect	改为使用 CSVLayerView.featureEffect	4.22
FeatureLayerView.effect	改为使用 FeatureLayerView.featureEffect	4.22
GeoJSONLayerView.effect	改为使用 GeoJSONLayerView.featureEffect	4.22
OGCFeatureLayerView.effect	改为使用 OGCFeatureLayerView.featureEffect	4.22
PrintViewModel.scaleEnabled	改为使用 TemplateOptions.scaleEnabled 或 PrintTemplate.scalePreserved	4.22
SearchViewModel.defaultSymbol	改为使用 SearchViewModel.defaultSymbols	4.22
StreamLayerView.effect	改为使用 StreamLayerView.featureEffect	4.22
WFSLayerView.effect	改为使用 WFSLayerView.featureEffect	4.22

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 中移除：

类/属性/方法/事件	备用选项	弃用版本
FieldConfig.editorType	通过在 FeatureForm 模板的字段元素中设置的 TextAreaInput 或 TextBoxInput 类来设置编辑器类型。	4.16
Bookmark.extent	Bookmark.viewpoint	4.17
promiseUtils.reject	Promise.reject()	4.19
promiseUtils.resolve	Promise.resolve()	4.19
widget.renderable	现在，将自动跟踪所有属性，不需要使用此装饰器来装饰。	4.19
LocatorSearchSource.locator	LocatorSearchSource.url	4.22

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

已移除的任务	备用选项	弃用版本
geoscene/portal/Portal/createClosestFacilityTask	将 closestFacility 与 helperServices 一起使用	4.21
geoscene/portal/Portal/createGeometryService	将 geometryService 与 helperServices 一起使用	4.21
geoscene/portal/Portal/createPrintTask	将 print 与 helperServices 一起使用	4.21
geoscene/portal/Portal/createRouteTask	将 route 与 helperServices 一起使用	4.21
geoscene/portal/Portal/createServiceAreaTask	将 serviceArea 与 helperServices 一起使用	4.21
geoscene/tasks/ClosestFacilityTask	closestFacility	4.20
geoscene/tasks/FindTask	find	4.20
geoscene/tasks/GeometryService	geometryService	4.20
geoscene/tasks/Geoprocessor	geoprocessor	4.20
geoscene/tasks/IdentifyTask	identify	4.20
geoscene/tasks/ImageIdentifyTask	imageService	4.20
geoscene/tasks/ImageServiceIdentifyTask	imageService.identify	4.18
geoscene/tasks/Locator	locator	4.20
geoscene/tasks/PrintTask	print	4.20
geoscene/tasks/QueryTask	query	4.20
geoscene/tasks/RouteTask	route	4.20
geoscene/tasks/ServiceAreaTask	serviceArea	4.20
geoscene/tasks/Task	n/a	4.20
geoscene/tasks/supportAddressCandidate	AddressCandidate	4.20
geoscene/tasks/supportAlgorithmicColorRamp	AlgorithmicColorRamp	4.20
geoscene/tasks/supportAreasAndLengthsParameters	AreasAndLengthsParameters	4.20
geoscene/tasks/supportAttachmentQuery	AttachmentQuery	4.20
geoscene/tasks/supportBufferParameters	BufferParameters	4.20
geoscene/tasks/supportClosestFacilityParameters	ClosestFacilityParameters	4.20
geoscene/tasks/supportClosestFacilitySolveResult	ClosestFacilitySolveResult	4.20
geoscene/tasks/supportColorRamp	ColorRamp	4.20
geoscene/tasks/supportDataFile	DataFile	4.20
geoscene/tasks/supportDataLayer	DataLayer	4.20
geoscene/tasks/supportDensifyParameters	DensifyParameters	4.20
geoscene/tasks/supportDirectionsFeatureSet	DirectionsFeatureSet	4.20
geoscene/tasks/supportDistanceParameters	DistanceParameters	4.20
geoscene/tasks/supportFeatureSet	FeatureSet	4.20
geoscene/tasks/supportFindParameters	FindParameters	4.20
geoscene/tasks/supportFindResult	FindResult	4.20
geoscene/tasks/supportGeneralizeParameters	GeneralizeParameters	4.20
geoscene/tasks/supportGPMessage	GPMessage	4.20
geoscene/tasks/supportIdentifyParameters	IdentifyParameters	4.20
geoscene/tasks/supportIdentifyResult	IdentifyResult	4.20
geoscene/tasks/supportImageIdentifyParameters	ImageIdentifyParameters	4.20
geoscene/tasks/supportImageIdentifyResult	ImageIdentifyResult	4.20
geoscene/tasks/supportImageHistogramParameters	ImageHistogramParameters	4.20
geoscene/tasks/supportImageServiceIdentifyParameters	ImageServiceIdentifyParameters	4.18
geoscene/tasks/supportImageServiceIdentifyResult	ImageServiceIdentifyResult	4.18
geoscene/tasks/supportJobInfo	JobInfo	4.20
geoscene/tasks/supportLegendLayer	LegendLayer	4.20
geoscene/tasks/supportLengthsParameters	LengthsParameters	4.20
geoscene/tasks/supportLinearUnit	LinearUnit	4.20
geoscene/tasks/supportMultipartColorRamp	MultipartColorRamp	4.20
geoscene/tasks/supportNAMessage	NAMessage	4.20
geoscene/tasks/supportOffsetParameters	OffsetParameters	4.20
geoscene/tasks/supportParameterValue	ParameterValue	4.20
geoscene/tasks/supportPrintParameters	PrintParameters	4.20
geoscene/tasks/supportPrintTemplate	PrintTemplate	4.20
geoscene/tasks/supportProjectParameters	ProjectParameters	4.20
geoscene/tasks/supportQuery	Query	4.20
geoscene/tasks/supportRasterData	RasterData	4.20
geoscene/tasks/supportRelationParameters	RelationParameters	4.20
geoscene/tasks/supportRelationshipQuery	RelationshipQuery	4.20
geoscene/tasks/supportRouteParameters	RouteParameters	4.20
geoscene/tasks/supportRouteResult	RouteResult	4.20
geoscene/tasks/supportServiceAreaParameters	ServiceAreaParameters	4.20
geoscene/tasks/supportServiceAreaSolveResult	ServiceAreaSolveResult	4.20
geoscene/tasks/supportStatisticDefinition	StatisticDefinition	4.20
geoscene/tasks/supportTrimExtendParameters	TrimExtendParameters	4.20

4.23

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