近くの公衆トイレ

このスキルが行うこと

ユーザーから教えてもらった現在地に基づいて、近くの公衆トイレ / 開放トイレ を見つける。

• 位置情報は自動推定しない。
• 必ず最初に現在地を質問する。
• トイレデータは公式の 공중화장실정보 標準データを基本として使用する。
• KAKAO_REST_API_KEY または kakaoRestApiKey オプションがあれば、Kakao Local REST APIで 공중화장실、개방화장실、OL7 ガソリンスタンドを追加検索してマージする。
• 位置文字列はKakao Map anchor検索で座標を取得し、可能な場合はその市道データのみに絞って検索する。
• 座標を直接受け取った場合は、すぐにnearby計算に進む。

使用するタイミング

• "근처 화장실 찾아줘"
• "서울역 근처 공중화장실 있어?"
• "광화문 주변 개방화장실 몇 군데만 보여줘"
• "지금 여기서 가까운 화장실 지도 링크 줘"

必須の最初の質問

位置情報なしでそのまま検索せず、必ず最初に尋ねる。

• 推奨質問: 현재 위치를 알려주세요. 동네/역명/랜드마크/위도·경도 중 편한 형식으로 보내주시면 근처 공중화장실을 찾아볼게요.
• 位置が曖昧な場合: 가까운 역명이나 동 이름으로 한 번만 더 알려주세요.

公式ソース

• 공공데이터포털 공중화장실 標準データ案内: 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>

ワークフロー

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. 座標50m以内の重複は同一施設として見なし、CSVの結果を優先的に保持する。
7. 通常3～5個のみを簡潔にまとめ、必要に応じてURLエンコードされた地図リンク（map.kakao.com/link/map/...）を一緒に提供する。

応答

結果は通常、以下のフィールドを含めて簡潔にまとめる。

• トイレ名
• 区分名（公衆トイレ / 開放トイレ）
• 距離
• 住所
• 開放時間/詳細
• 地図リンク

Node.js の例

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;
});

完了条件

• ユーザーの現在地を最初に確認した。
• 公式データに基づいて最低1つ以上のnearby restroomを見つけたか、見つからない理由と次の質問を提示した。
• 最も近い結果を3～5個以内にまとめた。

障害モード

• Kakao REST APIキーがない場合、CSV単一ソースで動作するため、漏れたPOIがある可能性がある。
• Kakao Map anchorが曖昧な場合、位置の基準点がぶれる可能性がある。
• 公開標準データはリアルタイムの占有/ロック状態を提供しないため、開放時間中心でのみ案内する必要がある。
• CSVエンコーディング/カラム構造が変更された場合、正規化ロジックを再確認する必要がある。