Geocodio 是一个面向美国的地理编码与数据增强服务,可用于把地址转换为地理坐标,并为位置数据补充人口统计等上下文信息。官方文档见 https://www.geocod.io/docs/。
用途:地址转坐标(地理编码)、坐标转地址(逆地理编码)、学校学区地理编码、地址查询与行政区划代码(邮政编码、FIPS 代码)查询,以及地址自动补全。
通过 Membrane CLI 交互,Membrane 自动处理认证与凭据刷新。安装:npm install -g @membranehq/cli@latest。登录示例:membrane login --tenant --clientName=<agentType>;无界面环境会输出授权 URL,完成后执行 membrane login complete <code>。
连接:membrane connection ensure "https://geocod.io" --json;若状态为 BUILDING,可轮询 npx @membranehq/cli connection get <id> --wait --json 直到 READY 或需用户操作。
查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。常用动作包括 geocode-address、batch-geocode-addresses、reverse-geocode、batch-reverse-geocode、calculate-distance、calculate-distance-matrix。
运行:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。
当预置动作无法覆盖时,可通过代理直接请求 Geocodio API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制:资料未说明具体收费、免费额度、平台支持范围和准确率;服务为美国定向,其他地区支持情况暂未提供。