文档

完整的 AgentGIS 使用文档，帮助你快速上手并掌握所有功能。

安装

克隆本仓库后在项目根目录使用 pnpm 或 npm 安装依赖：

Terminal
# 克隆仓库
git clone <AgentGIS 仓库地址>
cd AgentGIS

# 安装依赖（推荐 pnpm）
pnpm install

# 或使用 npm
npm install

快速入门

启动主应用后可在浏览器使用完整功能，或通过 REST API 集成到自己的应用：

app.tsx
# 启动主应用（在项目根目录）
pnpm dev

# 浏览器访问 http://localhost:3000 即可使用 3D 地球、AI 助手、路径规划等

# 调用 API 示例（地理编码）
curl "http://localhost:3000/api/geocode?q=北京天安门"

# 路径规划
curl -X POST http://localhost:3000/api/plan-path \
  -H "Content-Type: application/json" \
  -d '{"origin":{"lon":116.4,"lat":39.9},"dest":{"lon":121.5,"lat":31.2},"mode":"road"}'

3D 地球

AgentGIS 基于 Cesium 构建，提供高性能的 3D 地球可视化能力。支持多种地图投影、地形数据、3D 模型加载等功能。

  • 支持多种底图：OSM、Bing Maps、天地图、高德地图等
  • 高精度地形数据支持
  • 3D 模型加载（GLTF/GLB、Cesium 3D Tiles）
  • 时间轴动画，支持时序数据展示

AI 助手

AgentGIS 内置 AI 助手，可以理解自然语言指令并执行复杂的地理信息查询和操作。

示例指令：

  • "帮我找到北京周边的加油站"
  • "显示从天安门到机场的路线"
  • "在过去24小时内，这个区域有哪些航班"
  • "给我看看这个区域的历史影像"

路径规划

提供 POST /api/plan-path 统一接口，支持道路（road）、陆地（land）、海岸（coast）模式。当前道路模式基于自建路网 A* 实现，无路网或无法连通时自动回退为起点到终点的直线。

图层管理

灵活的图层系统，支持天气、AIS 船舶、地震（/api/earthquakes）、新闻（/api/news）以及 World Monitor 风格静态图层（伽马辐照、管道、光缆、数据中心、航天场、贸易路线等）。

知识库

内置知识库系统，支持 GET /api/knowledge/search 检索与 GET /api/knowledge/libraries 获取知识库列表，AI 助手对话时会自动结合知识库上下文。