使用手册 · 完整指南

AgentGIS 完整使用指南

从快速入门到高级功能，帮助您全面掌握 AgentGIS

AgentGIS 使用手册

完整使用指南

从快速入门到高级功能，帮助您全面掌握 AgentGIS

快速入门

系统要求

• 现代浏览器（Chrome 90+、Firefox 90+、Edge 90+、Safari 15+）
• 推荐屏幕分辨率 1920×1080 或更高
• 稳定的网络连接（建议带宽 ≥ 10Mbps）
• 支持 WebGL 2.0 的显卡

访问方式

在线访问（推荐）

直接访问 https://www.g5bk.com 使用最新版本。

本地部署

下载源码后，在项目根目录执行 pnpm install && pnpm dev 即可启动本地开发环境。详细部署文档请参考项目 README。

基本操作流程

打开应用

在浏览器中打开 AgentGIS，即可看到 3D 地球加载

探索地球

鼠标拖拽旋转、滚轮缩放，自由探索任意区域

AI 对话

点击右下角 AI 图标，用自然语言提问或下达指令

3D 地球操作

基本操作

操作	鼠标	触控板
旋转视角	左键拖拽	单指拖拽
缩放	滚轮	双指捏合
平移	右键拖拽	双指拖拽
倾斜	Ctrl + 左键拖拽	三指拖拽
定位到坐标	双击地球任意位置	双击任意位置

搜索与定位

点击地球界面顶部的搜索框
输入地名（如"北京天安门"、"上海"、"Tokyo"等）
系统会自动进行地理编码并定位到目标位置
支持中英文混合输入，模糊匹配

小贴士

使用 Ctrl+点击（Cmd+点击）可以在地球上快速添加标记点。右键点击标记点可以查看详情或编辑属性。

AI 助手使用

开启 AI 对话

点击地球界面右下角的 AI 图标（机器人头像）
在弹出的对话面板中输入您的问题或指令
按 Enter 发送，AI 助手会自动处理并回复
支持连续多轮对话，上下文自动保持

常用指令示例

Q: 帮我找到北京周边的加油站

A: 系统会在地图上标出北京周边加油站位置

Q: 显示从天安门到机场的路线

A: 自动规划路径并在地图上高亮显示

Q: 这个区域在过去 24 小时有哪些航班经过

A: 查询航班数据，在 3D 地球展示轨迹

Q: 统计上海市的 POI 分布情况

A: 聚合分析 POI 数据，生成分布报告

Q: 帮我在这片区域添加一个资产标记

A: 引导创建资产，自动获取当前位置坐标

模型切换

在 AI 对话面板的顶部，您可以切换不同的底层大语言模型：

GPT-4oClaude 3.5文心一言DeepSeek通义千问

资产管理

资产创建

打开资产管理面板（地球界面左侧工具栏）
点击「创建资产」按钮
填写资产信息：编码、名称、类型、描述
选择图标和生命周期状态（计划/部署/使用/维修/报废）
设置位置：输入经纬度或在地图上点击选择
添加标签、图片、视频等附件（可选）
确认无误后点击「保存」

资产分类

家庭常用资产

门锁家电水电表安防摄像头网关/路由器烟感/报警照明灯具空调/新风门禁对讲水阀/燃阀充电桩

工厂常用资产

生产设备机械臂工业传感器叉车锅炉/压力设备数控/CNC输送线行车/吊车泵与管道立库/货架AGV/移动机器人

资产追踪

所有资产的位置变更历史会自动记录，您可以：

查看单个资产的完整位置历史轨迹
按时间范围筛选位置变更记录
在地图上播放资产位置变化动画
查看任意时间点的资产分布快照

图层管理

内置图层

AgentGIS 提供丰富的内置数据图层，可在图层管理面板中一键开启/关闭：

天气图层

实时天气雷达、云图、温度分布

可切换

AIS 船舶

全球船舶实时位置与航线

可切换

地震数据

最近 7 天全球地震事件

可切换

新闻热点

地理标签化的实时新闻

可切换

航班追踪

全球航班实时位置与状态

可切换

World Monitor

伽马辐照、管道、光缆等专业图层

可切换

自定义图层

支持通过 API 或界面上传自定义 GeoJSON、KML、CZML 等格式的空间数据，在 3D 地球上叠加展示。支持自定义样式（颜色、透明度、线宽等）。

API 示例：添加自定义图层

POST /api/layers
{
  "name": "我的图层",
  "type": "geojson",
  "data": { "type": "FeatureCollection", "features": [...] },
  "style": { "color": "#3b82f6", "opacity": 0.8 }
}

API 参考

核心 API 列表

接口	方法	描述
/api/geocode	GET	地理编码（地名→坐标）
/api/reverse-geocode	GET	逆地理编码（坐标→地名）
/api/plan-path	POST	路径规划
/api/assets	GET/POST	资产查询/创建
/api/assets/:id	GET/PUT/DELETE	资产详情/更新/删除
/api/layers	GET/POST	图层列表/创建
/api/knowledge/search	GET	知识库检索
/api/knowledge/libraries	GET	知识库列表

认证方式

所有 API 请求需要在 HTTP 头部携带 Authorization: Bearer <token>。 Token 通过用户登录获取，支持 OAuth 2.0 标准流程。

请求示例

curl 示例

# 地理编码查询
curl "https://api.agentgis.com/api/geocode?q=北京天安门"   -H "Authorization: Bearer YOUR_TOKEN"

# 路径规划
curl -X POST "https://api.agentgis.com/api/plan-path"   -H "Authorization: Bearer YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{"origin":{"lon":116.4,"lat":39.9},"dest":{"lon":121.5,"lat":31.2},"mode":"road"}'

常见问题

AgentGIS 支持哪些浏览器？

支持 Chrome 90+、Firefox 90+、Edge 90+、Safari 15+。建议使用最新版 Chrome 以获得最佳 3D 性能。

免费版和付费版有什么区别？

免费版提供基础的 3D 地球浏览和 AI 对话功能。付费版解锁资产管理、路径规划、自定义图层、API 访问等高级功能。

如何部署到自己的服务器？

我们提供 Docker 镜像一键部署方案。企业客户请联系我们获取私有化部署安装包和部署文档。

AI 助手支持哪些语言？

AI 助手优先支持中文和英文。中文场景下推荐使用文心一言或 DeepSeek 模型，英文场景推荐 GPT-4o 或 Claude。

数据安全如何保障？

所有数据传输使用 TLS 1.3 加密，存储使用 AES-256 加密。私有化部署场景下，数据完全在企业内部网络流转。

如何获取技术支持？

免费用户可在社区论坛提问。付费用户享有邮件和工单支持，企业客户提供专属技术支持群和 7×24 小时响应。