駐車場検索

このスキルの機能

ユーザーが教えてくれた現在地を基準に近くの公営駐車場を探す。

• 位置は自動推定しない。
• 必ず先に現在地を質問する。
• デフォルトでは公営駐車場のみを表示する。
• 公式全国駐車場情報標準データ Open APIを使用する。
• 位置文字列はKakao Mapアンカー検索で座標を取得した後、公式駐車場データから距離順に整理する。
• リアルタイムの満車/空き状況/予約可否は公式標準データに含まれていないため、確実なことは述べない。

使用する場合

• "近くの駐車場を探して"
• "光化門周辺の公営駐車場どこ？"
• "ソウル駅近くの無料駐車場ある？"
• "ここから近い公営駐車場の地図リンク頂戴"

必須の最初の質問

位置情報なしでいきなり検索しない。必ず先に聞く。

推奨される質問:

現在地を教えてください。町名/駅名/ランドマーク/緯度経度のいずれか便利な形式で送ってもらえば、近くの公営駐車場を探してみます。

位置が曖昧な場合:

近い駅名または区名でもう一度教えてもらえますか。

公式リソース

• 標準データ案内: https://www.data.go.kr/data/15012896/standard.do
• Open API案内: https://www.data.go.kr/data/15012896/openapi.do
• Open APIエンドポイント: https://api.data.go.kr/openapi/tn_pubr_prkplce_info_api
• k-skill proxy: /v1/parking-lots/search
• 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でアンカー候補を選択し、座標を取得する。
3. アンカーアドレスから都道府県 + 市区郡アドレスヒントを作成する。
4. k-skill-proxy /v1/parking-lots/searchまたはparking-lot-searchパッケージで公式駐車場データを照会する。
5. 通常3～5件のみ短くまとめ、地図リンクを付ける。
6. 料金/営業時間はデータ基準日付とともに案内し、リアルタイム情報ではないことを明示する。

応答方法

結果は通常以下のフィールドを含めて短くまとめる。

• 駐車場名
• 距離
• 公営/民営およびロードサイド/駐車場棟/附属の種別
• 住所
• 営業曜日/営業時間
• 料金情報、基本料金、追加料金
• 駐車区画数
• 電話番号/管理機関
• データ基準日付
• 地図リンク

Node.js例

const { searchNearbyParkingLotsByLocationQuery } = require("parking-lot-search");

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

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

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

Modeui Parking Lot ステータス

Issue #135で모두의주차장連携の可能性が言及されましたが、v1は公式公共データベースをベースに開始します。承認された公式/パートナーAPI契約が確認されるまで、모두의주차장非公式API呼び出しやスクレイピングは行いません。

完了条件

• ユーザーの現在地を先に確認した。
• 公式データベースをもとに最低1件以上の近くの駐車場を探索したか、見つからない理由と次の質問を提示した。
• 最も近い結果を3～5件以内にまとめた。
• リアルタイムの空き状況/予約可能性ではないことを必要に応じて明確にした。