public-restroom-nearby

Public Restroom Nearby

What this skill does

根据用户提供的当前位置，查找附近的公共厕所 / 开放洗手间。

• 不会自动推测位置。
• 必须先询问用户当前的具体位置。
• 默认使用韩国官方 공중화장실정보（公共洗手间信息）标准数据集。
• 若提供了 KAKAO_REST_API_KEY 或 kakaoRestApiKey 选项，则会调用 Kakao Local REST API 补充查询 공중화장실（公共厕所）、개방화장실（开放厕所）及 OL7（加油站）并合并结果。
• 对于位置文本，通过 Kakao Map 锚点搜索获取精确坐标；条件允许时，缩小查询范围至对应特例市/道的数据。
• 若直接接收到坐标，则直接进入附近测算流程。

When to use

• “帮我找找附近的厕所”
• “首尔站附近有公共厕所吗？”
• “光化门周边给我推荐几个开放洗手间”
• “给我发个离我现在最近的洗手间地图链接”

Mandatory first question

绝不要在没有位置信息的情况下直接搜索，必须先进行询问。

• 推荐提问方式：请告诉我您的当前位置。发送您方便的格式即可（如社区/车站名/地标/经纬度），我来为您查找附近的公共洗手间。
• 若位置模糊：请再提供一下附近的地铁站名或行政洞名称。

Official surfaces

• 公共数据门户网站公共洗手间标准数据说明：https://www.data.go.kr/data/15012892/standard.do
• 全国 CSV：https://file.localdata.go.kr/file/download/public_restroom_info/info
• 按地区 CSV：https://file.localdata.go.kr/file/download/public_restroom_info/info?orgCode=<시도코드>
• 文件介绍页面：https://file.localdata.go.kr/file/public_restroom_info/info
• Kakao Map 移动端搜索：https://m.map.kakao.com/actions/searchView?q=<query>
• Kakao Map 场所面板 JSON：https://place-api.map.kakao.com/places/panel3/<confirmId>

Workflow

1. 必须先向用户询问当前位置。
2. 收到位置文本后，通过 Kakao Map 选定锚点候选并获取精确坐标。
3. 若能从锚点地址推导出市/道（如首尔/京畿/釜山等），则缩小范围至相应地区的 CSV 文件。
4. 下载官方 공중화장실정보 CSV 数据；若配置了 Kakao REST API Key，则额外调用并合并 keyword.json?query=공중화장실、keyword.json?query=개방화장실 和 category.json?category_group_code=OL7 的查询结果。
5. 忽略 Kakao 默认返回的 distance 字段，基于经纬度使用 Haversine 公式重新计算实际距离。
6. 坐标在 50 米以内的重复数据视为同一设施，优先保留 CSV 来源的结果。
7. 通常精简整理 3~5 个结果返回，必要时附带经过 URL 编码的地图链接（map.kakao.com/link/map/...）。

Responding

返回结果通常简要包含以下字段：

• 洗手间名称
• 分类名称（公共洗手间 / 开放洗手间）
• 距离
• 地址
• 开放时间/详细说明
• 地图链接

Node.js example

const { searchNearbyPublicRestroomsByLocationQuery } = require("public-restroom-nearby");

async function main() {
  const result = await searchNearbyPublicRestroomsByLocationQuery("광화문", {
    limit: 3
  });

  console.log(result.anchor);
  console.log(result.items);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Done when

• 已首先确认用户的当前位置。
• 基于官方数据找到了至少 1 个附近的洗手间，或在未查找到时给出了原因及下一步提问建议。
• 将最匹配的结果精简归纳在 3~5 个以内。

Failure modes

• 若未配置 Kakao REST API Key，系统仅依靠 CSV 单一数据源运行，可能会遗漏部分兴趣点（POI）。
• 若 Kakao Map 锚点模糊，可能导致定位基准点出现偏差。
• 开放标准数据集不提供实时占用或锁门状态，因此只能依据开放时间提供参考说明。
• 若 CSV 的编码或列结构发生变化，需要重新校验数据规范化逻辑。