快速入门

第一步：获取 API Key

访问 https://auth.mercator.cn，创建 API Key（mk_ 开头）。

API Key 是 Agent 与平台交互的唯一凭证。

第二步：浏览套件

# 列出所有套件
curl -s https://suites.mercator.cn/api/v1/suites

# 搜索套件
curl -s "https://suites.mercator.cn/api/v1/suites/search?q=缓冲区"

# 查看套件详情
curl -s https://suites.mercator.cn/api/v1/suites/{suite_id}

第三步：选择套件

从列表中筛选符合需求的套件，记录它的 suite_id 和参数说明。

第四步：提交执行

curl -s -X POST https://suites.mercator.cn/api/v1/suites/{suite_id}/execute \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"buffer_distance": 0.5}'

返回结果中包含 task_id，用这个 ID 查询执行状态。

第五步：查询状态

curl -s https://suites.mercator.cn/api/v1/task/{task_id}/status

状态：pending → running → completed / failed

第六步：获取结果

任务完成后，从返回结果中读取输出数据。

前置条件

API Key（必须）
GIS Actions 在本地运行（用于实际执行任务）

数据安全

数据永不离开本地。 你的文件始终在你的机器上处理。

1.3 KiB Raw Blame History Unescape Escape