名称： isitwater
描述： 使用 IsItWater API 检查地理坐标点位于水域还是陆地。
元数据： {"openclaw": {"primaryEnv": "ISITWATER_API_KEY", "emoji": "🌊", "homepage": "https://isitwater.com"}}

IsItWater

使用 IsItWater API 判断给定的经纬度坐标点是否位于水域。

配置

在调用 API 之前，请检查用户是否已配置 API 密钥：

1. 检查环境变量 ISITWATER_API_KEY 是否已设置。
2. 如果未设置：
   • 告知用户："您需要一个 IsItWater API 密钥。您可以在 https://isitwater.com 获取。"
   • 提供帮助：使用浏览器工具导航至 https://isitwater.com，创建账户，并在控制面板中生成 API 密钥。
   • 用户获取密钥后，指导其配置到 ~/.openclaw/openclaw.json 文件中：

{
  "skills": {
    "entries": {
      "isitwater": {
        "apiKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

*   或者，用户也可以直接导出环境变量：`export ISITWATER_API_KEY=YOUR_API_KEY_HERE`

3. 密钥配置完成后，即可继续使用以下 API 调用。

水域查询

检查坐标点位于水域还是陆地。

端点： GET https://api.isitwater.com/v1/locations/water

请求头：

• Authorization: Bearer $ISITWATER_API_KEY

查询参数：

示例 curl 命令：

curl -s "https://api.isitwater.com/v1/locations/water?lat=41.7658&lon=-72.6734" \
  -H "Authorization: Bearer $ISITWATER_API_KEY"

示例响应（陆地）：

{
  "request_id": "abc123",
  "water": false,
  "features": ["earth"],
  "latitude": "41.7658",
  "longitude": "-72.6734"
}

示例响应（水域）：

{
  "request_id": "def456",
  "water": true,
  "features": ["earth", "ocean"],
  "latitude": "36.0",
  "longitude": "-30.0"
}

响应字段：

费用： 每次查询消耗 1 个积分。

账户信息

查询用户的账户详情和剩余积分余额。

端点： GET https://api.isitwater.com/v1/accounts/me

请求头：

• Authorization: Bearer $ISITWATER_API_KEY

示例 curl 命令：

curl -s "https://api.isitwater.com/v1/accounts/me" \
  -H "Authorization: Bearer $ISITWATER_API_KEY"

响应字段：

费用： 免费（不消耗积分）。

错误处理

错误响应会返回 JSON 格式的消息体：

{
  "error": "错误描述信息"
}

使用建议

• 每次水域查询消耗 1 个积分。在进行大量查询前，建议先使用账户信息接口检查余额。
• 当用户提供地点名称而非坐标时（例如："撒哈拉沙漠是水域吗？"），请先对地点进行地理编码以获取经纬度，再调用水域查询接口。
• features 数组对于单个坐标点可能包含多个重叠的特征值——例如，一个点可能同时返回 lake 和 nature_reserve。