isitwater

IsItWater 是一款专为地理信息系统（GIS）开发者和地图应用设计者打造的坐标属性检测技能。该技能通过调用 IsItWater 官方 API，能够精准判断任意经纬度坐标点位于水域还是陆地，并返回详细的地形特征标签（如海洋、湖泊、河流、冰川等）。

核心用法
使用该技能前，用户需在环境变量或配置文件中设置 ISITWATER_API_KEY。技能提供两大核心功能：首先是水域查询功能，通过向 https://api.isitwater.com/v1/locations/water 发送 GET 请求，传入 lat（纬度，-90 至 90）和 lon（经度，-180 至 180）参数，即可获取该坐标点的水域状态布尔值及地理特征数组。其次是账户信息查询，可实时查看剩余 credits 余额及自动充值状态。对于提供地名而非坐标的查询需求，技能建议先进行地理编码（Geocoding）转换后再调用 API。每次水域查询消耗 1 个 credit，账户查询免费。

显著优点
作为纯文档型技能，IsItWater 具有极高的安全性，不包含任何可执行代码或脚本文件，仅通过标准化 Markdown 文档指导 AI 进行 API 调用。该技能采用 MIT 开源协议，来源透明可信。接口设计简洁直观，响应数据结构清晰，包含 request_id 便于追踪。错误处理机制完善，明确定义了 400（参数错误）、401（认证失败）、402（余额不足）等状态码。此外，技能文档详细说明了成本结构（1 credit/次），帮助用户合理规划使用预算。

潜在缺点与局限性
该技能存在几个明显局限：首先，完全依赖 IsItWater 第三方服务的可用性和持续性，无法离线使用；其次，每次查询产生费用，大规模数据处理成本可能较高；第三，技能本身不内置地理编码功能，面对地名查询需要额外集成其他服务；第四，API 返回的 features 数组可能存在重叠值（如同时返回 lake 和 nature_reserve），需要用户自行解析；最后，坐标精度受限于 IsItWater 底层数据库的更新频率和准确性。

适合的目标群体
本技能主要面向 GIS 开发者、地图应用工程师、海洋/环境科学研究人员、物流路径规划开发者以及任何需要判断地理坐标水域属性的应用场景。特别适合集成到需要实时地形判断的自动化工作流中，如无人机飞行路径规划、船舶航线验证、地理数据分析 pipeline 等。

使用风险
使用该技能需注意以下风险：API 调用按次计费，高频查询可能导致 credits 快速耗尽，建议批量操作前检查账户余额；用户坐标数据需传输至 isitwater.com 服务器，虽无敏感信息泄露风险，但对数据主权要求极高的场景需谨慎；网络连接质量直接影响响应速度，不适用于网络不稳定环境；长期依赖单一第三方 API 存在供应商锁定风险，建议制定备用方案。