地理定位技能

该技能连接到Geomanic MCP API，用于查询旅行统计数据、管理航点以及分析行程。

身份验证

API密钥存储在环境变量GEOMANIC_TOKEN中。所有请求都必须将其作为Bearer令牌包含在内。

如何调用API

通过exec工具使用curl向https://geomanic.com/api/v1/mcp发送JSON-RPC请求：

bash
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H Content-Type: application/json \
-H Authorization: Bearer $GEOMANIC_TOKEN \
-d {jsonrpc:2.0,id:1,method:tools/call,params:{name:TOOL_NAME,arguments:{...}}}

可用工具

get_statistics

必需参数：from（ISO 8601格式）、to（ISO 8601格式）。
可选参数：suppress_flights（布尔值，默认为true）。

示例：
bash
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H Content-Type: application/json \
-H Authorization: Bearer $GEOMANIC_TOKEN \
-d {jsonrpc:2.0,id:1,method:tools/call,params:{name:get_statistics,arguments:{from:2026-02-22T00:00:00Z,to:2026-02-22T23:59:59Z}}}

getdaterange

bash
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H Content-Type: application/json \
-H Authorization: Bearer $GEOMANIC_TOKEN \
-d {jsonrpc:2.0,id:1,method:tools/call,params:{name:getdaterange,arguments:{}}}

list_waypoints

可选参数：from、to（ISO 8601格式）、limit（默认50，最大200）、offset（默认0）、order（asc或desc，默认desc）。

bash
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H Content-Type: application/json \
-H Authorization: Bearer $GEOMANIC_TOKEN \
-d {jsonrpc:2.0,id:1,method:tools/call,params:{name:list_waypoints,arguments:{from:2026-02-22T00:00:00Z,to:2026-02-22T23:59:59Z,limit:10}}}

get_waypoint

必需参数：id（字符串，UUID格式）。

create_waypoint

必需参数：timestamp_utc（ISO 8601格式）、latitude（数字）、longitude（数字）。
可选参数：speedkmh、altitude、headingdeg、device_id。

update_waypoint

必需参数：id（字符串，UUID格式）。
可选参数：latitude、longitude、speedkmh、altitude、headingdeg、countryiso、place、deviceid。

delete_waypoint

必需参数：id（字符串，UUID格式）。

重要说明

• - 所有日期必须采用ISO 8601格式并包含时区（使用带Z后缀的UTC时间）。
• 对于今天查询，使用当前日期，范围为T00:00:00Z到T23:59:59Z。
• 响应格式为JSON-RPC。实际数据位于result.content[0].text中，为JSON字符串。
• 距离单位为公里，速度单位为公里/小时，海拔单位为米。