parking-lot-search

Parking Lot Search

What this skill does

根據使用者提供的目前位置，搜尋附近的公營停車場。

• 不會自動推算位置。
• 務必先詢問使用者目前的所在位置。
• 預設僅顯示「公營」停車場。
• 使用官方「全國停車場資訊標準資料」（전국주차장정보표준데이터）Open API。
• 將位置文字透過 Kakao Map 進行定位點（anchor）搜尋取得座標後，再從官方停車場資料中依距離遠近進行排序整理。
• 官方標準資料不包含即時滿車/剩餘車位/預約狀態，因此切勿給予確定的即時車位答覆。

When to use

• 「幫我找附近的停車場」
• 「光化門附近有哪些公營停車場？」
• 「首爾車站附近有免費停車場嗎？」
• 「請給我現在位置附近的公營停車場地圖連結」

Mandatory first question

在未取得位置資訊前，請勿直接搜尋，務必先詢問使用者。

建議提問語氣：

請提供您目前的所在位置。您可以傳送行政區/車站名/地標/經緯度等方便的格式，我來為您尋找附近的公營停車場。

若位置描述較模糊：

請再提供一次附近的車站名稱或行政區名稱（洞名）。

Official surfaces

• 標準資料說明：https://www.data.go.kr/data/15012896/standard.do
• Open API 說明：https://www.data.go.kr/data/15012896/openapi.do
• Open API endpoint：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>

Workflow

1. 務必先詢問使用者目前的所在位置。
2. 收到位置文字後，利用 Kakao Map 篩選定位點（anchor）候選項並取得座標。
3. 從定位點地址中擷取「特別市/廣域市/道 + 市/郡/區」（시도 + 시군구）作為地址提示（address hint）。
4. 透過 k-skill-proxy /v1/parking-lots/search 或 parking-lot-search 套件查詢官方停車場資料。
5. 通常精簡整理 3～5 個結果即可，並附上地圖連結。
6. 說明費率/營運時間時，請一併附上資料基準日期，並聲明此非即時車位現況。

Responding

回覆結果通常包含以下欄位並簡要整理：

• 停車場名稱
• 距離
• 公營/民營以及路邊/路外/附設等類型
• 地址
• 營運星期/營運時間
• 收費資訊、基本費率、加收費率
• 停車格數量
• 電話號碼/管理機構
• 資料基準日期
• 地圖連結

Node.js example

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

모두의주차장 status

在 Issue #135 中雖然提過串接「모두의주차장」（Modu Parking）的可能性，但 v1 版本仍以官方公共資料為主。在確認取得經授權的官方/合作夥伴 API 合約之前，請勿進行「모두의주차장」的非官方 API 調用或網路爬蟲（scraping）。

Done when

• 已先確認使用者的目前位置。
• 已基於官方資料找到至少 1 個以上的附近停車場（nearby parking lot），或者已說明未找到的原因並提出後續提問。
• 已將最接近的搜尋結果精簡整理在 3～5 個以內。
• 必要時已明確說明該資訊並非即時剩餘車位/預約狀態。