SuperAPI AI 工具集

carto-render-inline-map

智能体与模型

查看项目

更新于 10-15 17:31

技能介绍

用途:在对话中直接呈现临时交互式地图,无需离开聊天界面。技能通过 CARTO MCP 服务器的 view_map 工具实现,由智能体发出 @deck.gl/json 声明式规范,渲染器负责凭证、底图与 tooltip 等细节。

主要能力:支持内联渲染临时地图;渲染后需通过宿主控件表面(如 Claude.ai / Claude Desktop 的 show_widget)输出图例,因为 view_map 不提供自动图例;若宿主无控件工具,可退回纯文本图例(含 emoji 色块与十六进制色值)。HTML 模板、样式规则及 colorBins、colorContinuous、colorCategories、raster 各变体写在 view_map 工具描述中。

使用方式:技能仅限 MCP,view_map 只在 CARTO MCP 服务器上、且只在支持 MCP Apps 的宿主(Claude.ai、Claude Desktop、ChatGPT)内联渲染,无 CLI 等价物;OAuth 与 token 会话均可用。前置需确认 view_map 出现在工具列表中且宿主可渲染。组合规范前先通过 explore_data 探测数据:list_connections 识别连接,search 或 list_resources 查找表,对不熟悉的数值列用 describe(stats 模式)获取分位、最小最大值与类别,再组合 view_map 规范。制图决策(调色板、比例尺、底图、描边、绘制顺序、层级、拾取、反模式与示例配方)需先读 references/cartography.md。

适用场景:需要即时查看临时地图、做对话内空间数据探索时使用。

限制:不适合永久或可分享地图(应走 carto-create-builder-maps);不适合按名称打开已保存地图(应走 carto-preview-builder-map);不适合从零编写 TypeScript/JavaScript 应用(应走 carto-develop-app)。若宿主不支持渲染(如 Gemini CLI、Codex CLI、MCP Inspector、MCPJam 等纯文本环境),需告知用户并建议切换宿主,或在有 shell 时改用 carto-create-builder-maps 加 carto maps screenshot 生成 PNG。若 view_map 不在工具列表中,说明 MCP 服务器未挂载,不要退回到通用可视化控件。view_map 规范不会保存或分享为 URL,仅存在于聊天中。规范组成相关的反模式(瓦片方案不匹配、通用图层、硬编码分箱)见 references/cartography.md §9。创建永久地图后,应通过 mapId 加载已保存地图验证,而非重新渲染临时规范。