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 调用。

水体查询（Water Lookup）

判断某经纬度坐标是否位于水体之上（或陆地之上）。

接口地址： GET https://api.isitwater.com/v1/locations/water

请求头（Headers）：

• Authorization: Bearer $ISITWATER_API_KEY

查询参数（Query Parameters）：

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 个积分（credit）。

账户信息（Account Info）

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

接口地址： GET https://api.isitwater.com/v1/accounts/me

请求头（Headers）：

• Authorization: Bearer $ISITWATER_API_KEY

cURL 示例：

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

响应字段说明：

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

错误处理（Error Handling）

错误响应返回 JSON 格式正文：

{
  "error": "问题的具体描述"
}

使用建议（Tips）

• 每次水体查询消耗 1 个积分。在批量发起请求前，建议先调用 Account Info 接口检查用户当前积分余额。
• 当用户提供的是地点名称而非坐标（例如：“撒哈拉沙漠是水吗？”），需先对该地点进行地理编码（geocode）以获取经纬度，再调用水体查询接口。
• features 数组可能对单个坐标点返回多个重叠的地理特征值**，例如某一点可能同时返回 lake 和 nature_reserve。