public-restroom-nearby

Public Restroom Nearby

What this skill does

根據使用者提供的當前位置，尋找附近的公廁 / 開放式洗手間。

• 不會自動推測位置。
• 務必先詢問當前位置。
• 洗手間資料預設使用官方「공중화장실정보」（公廁資訊）標準資料集。
• 若有提供 KAKAO_REST_API_KEY 或 kakaoRestApiKey 選項，會透過 Kakao Local REST API 額外查詢「공중화장실」（公廁）、「개방화장실」（開放洗手間）與 OL7（加油站）並進行合併。
• 位置字串會經由 Kakao Map anchor 搜尋取得座標；若能推斷出所在的區域（如首爾、京畿、釜山等），會縮小搜尋範圍僅下載該縣市區域的資料。
• 若直接接收到經緯度座標，則直接進行 nearby 距離計算。

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 篩選 anchor 候選地並取得座標。
3. 若能從 anchor 地址推斷出所屬縣市區域（首爾/京畿/釜山等），則縮小範圍下載該區域的 CSV。
4. 下載官方「공중화장실정보」（公廁資訊）CSV；若設定了 Kakao REST API 金鑰，則追加 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 金鑰，系統將僅以單一 CSV 資料源運作，可能會有遺漏的地點（POI）。
• 若 Kakao Map anchor 解析結果不明確，定位基準點可能會發生偏移。
• 公開標準資料不提供即時佔用/鎖門狀態，因此僅能針對開放時間進行說明與引導。
• 若 CSV 的編碼或欄位結構發生變更，需重新確認資料正規化邏輯。