用途:面向 ArcGIS Maps SDK for JavaScript,管理门户内容,包括保存 WebMap/WebScene、书签、幻灯片,以及门户项目、组、文件夹和用户信息。
主要能力:通过 ESM 或 CDN 动态导入 WebMap、WebScene、Portal、PortalItem、PortalQueryParams 等模块;从门户项目或从零创建 WebMap/WebScene;用 fromJSON 构建结构;支持全局与局部场景(含裁剪);保存新项目(saveAs)或更新已有项目(save);以编程方式创建书签并跳转;用 Slide.createFrom 生成幻灯片、applyTo 应用、remove 删除;加载、查询、更新门户项目;查询组及组内容;读取用户信息与文件夹。
使用方式:导入示例:import WebMap from "@arcgis/core/WebMap.js"; 动态导入:const WebMap = await $arcgis.import("@arcgis/core/WebMap.js"); 保存前需先 await map.updateFrom(view),再 await map.save() 或 saveAs({title, snippet, tags})。地图组件示例使用 <arcgis-map item-id="YOUR_WEBMAP_ID"> 与 viewOnReady()。
适用场景:需要将当前视图状态持久化到门户、配置 WebMap/WebScene 初始视图与图层、管理书签和演示幻灯片、按所有者或类型检索门户内容。
限制:保存需要用户认证,须先配置 OAuth;企业门户需显式指定 url;只能更新自己拥有的项目,否则用 saveAs 创建副本;幻灯片缩略图自动生成但渲染可能耗时;忘记 updateFrom 可能保存过期视点。相关技能包括 arcgis-authentication、arcgis-core-maps、arcgis-layers。