SuperAPI AI 工具集

build-with-arcgis-rest-js

编程与开发

查看项目

更新于 11-16 16:13

技能介绍

用途:该技能用于在浏览器、Node.js 或服务端环境中,通过 ArcGIS REST JS 以模块化的包式 API 访问 ArcGIS REST 资源与操作,从而替代手动拼接 REST 请求,并管理认证对象、请求对象和错误对象。"ArcGIS REST JS" 在本技能中与 "REST JS" 同义。

主要能力与包选择:核心请求与认证使用 @esri/arcgis-rest-request;要素图层查询与编辑使用 @esri/arcgis-rest-feature-service;地理编码、地址查找、批量地理编码、逆地理编码与自动建议使用 @esri/arcgis-rest-geocoding;兴趣点、附近搜索、边界框搜索、地点详情与类别搜索使用 @esri/arcgis-rest-places;路径规划、导航、服务区、最近设施、出行成本矩阵、车队路径与吸附道路使用 @esri/arcgis-rest-routing;GeoEnrichment 与人口统计使用 @esri/arcgis-rest-demographics;门户成员、群组、内容、共享与组织设置使用 @esri/arcgis-rest-portal;API 密钥与开发者凭据的程序化管理使用 @esri/arcgis-rest-developer-credentials;底图会话与令牌使用 @esri/arcgis-rest-basemap-sessions。技能要求按功能需求逐个论证包的选择,不默认导入全部包。

使用方式:需求不明确时,可先用 gather-arcgis-application-requirements 技能澄清关键未知项。身份验证需参考 follow-arcgis-authentication-patterns 技能;若不可用,则查找项目中已有的认证模式,或查询 Esri MCP 服务器文档。安装与初始化可通过 MCP 或文档查询获取;优先使用 ESM 而非 CommonJS,适用时采用 CDN。Node.js 或打包器环境使用 NPM 安装:npm install @esri/arcgis-rest-js,并按需导入模块,例如 import { request } from "@esri/arcgis-rest-js"。浏览器无打包器时,可用 CDN 配合 import map 加载模块,也可用 script 标签,加载的包会作为 globalThis.arcgisRest 的属性。对于现有应用,需确认已安装版本兼容性,并参考发布说明与迁移文档处理破坏性变更。

文档查询:建议配置 Esri 开发者文档 MCP 服务器 https://developers-mcp.arcgis.com/mcp,使用 search_esri_developer_docs(focus_area 为 arcgis-rest-js)与 fetch_esri_developer_docs。若不可用,再查阅官方文档链接,包括介绍、API 参考、GitHub 仓库、身份验证、安装、创建 API 密钥、发布说明与迁移、系统要求、错误处理、要素服务查询、地理编码、路径规划、地点、数据丰富、高程与空间分析等页面。文档冲突时优先 API 参考,其次最新官方文档,并明确注明冲突。

适用场景与前提:开发者需具备 ArcGIS Location Platform(免费)、ArcGIS Online 或 ArcGIS Enterprise 账号,且用户类型为 Creator、Professional 或 Professional Plus;账号的用户类型、角色与权限决定可访问的资源与操作。实施前应收集运行时、目标 ArcGIS 产品、认证模式、所需包、部署约束与用户目标。

安全与限制:不得在可提交的源码或提示中硬编码或暴露密钥,密钥应放在本地并被 .gitignore 覆盖;服务端凭据需隔离在服务端环境,不暴露给浏览器;多用户应用应建模每用户会话与令牌刷新;公共 API 密钥/访问令牌建议设置最小权限与 referrer 限制;日志中不得包含令牌与敏感头;需显式处理分页与服务限制。常见问题包括 ArcGIS Online 与 Enterprise 基础 URL 不匹配、令牌受众不匹配、服务最大记录数限制、空间参考不匹配、组织策略差异、令牌过期、浏览器 CORS 与 referrer 限制。验证过程包括确认包选择、认证安全、参数与类型符合 API 参考、网络策略、端点正确、代表性请求成功、错误处理与手动步骤说明。