SuperAPI AI 工具集

carto-geocoding

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:把街道地址或地名转换为地理坐标(点几何),是表格数据只有地址列、缺少空间列时的第一步。

主要能力:提供两条访问路径。单条或临时请求走 CARTO MCP 的 geocode 工具,支持 geocode、reverse、capabilities 操作,可在任意 MCP 主机(含沙箱聊天主机)运行,适合交互式请求。表级或可复用流程走工作流模式,管线为:源表(含地址列)→ Geocode →(过滤成功项)→ 保存。

使用方式:源表用 native.gettablebyname 加载,需含地址文本列;地理编码用 native.geocode,必填 source 与 address,强烈建议填 country 以提高准确度与速度。地址列可为完整地址,也可先用 native.selectexpression 拼接街道、城市、邮编。geocode 组件有两个输出句柄:match(成功,新增 geom 点几何列与 CARTO_GEOCODE_METADATA JSON 质量列)和 unmatch(失败,geom 为 NULL)。可用 metadata 中的 confidence 过滤,失败行另存供人工修正。结果用 native.saveastable 持久化,geom 为 WGS84(EPSG:4326)。随后用 MCP create_workflow / validate_workflow 或 carto workflows create 校验上传。

底层与限制:组件封装 Analytics Toolbox 的 GEOCODE_TABLE,使用 CARTO Location Data Services,每行消耗 LDS 配额,可用 LDS_QUOTA_INFO() 查询配额,其全限定名因数据仓库而异。注意:不要接错 match/unmatch 句柄;地址格式影响结果;Snowflake 未加引号标识符为大写;大表建议分批以免耗尽配额或超时。API-token 的 MCP 会话下临时/编写工具被隐藏,需改用 CLI 或 OAuth 重连。具体教程与模板链接资料中未提供。