parking-lot-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseParking Lot Search
停车场搜索
What this skill does
该技能的功能
유저가 알려준 현재 위치를 기준으로 근처 공영주차장 을 찾는다.
- 위치는 자동 추정하지 않는다.
- 반드시 먼저 현재 위치를 질문한다.
- 기본값은 주차장만 보여준다.
공영 - 공식 Open API를 사용한다.
전국주차장정보표준데이터 - 위치 문자열은 Kakao Map anchor 검색으로 좌표를 잡은 뒤, 공식 주차장 데이터에서 거리순으로 정리한다.
- 실시간 만차/잔여면/예약 여부는 공식 표준데이터에 없으므로 확정해서 말하지 않는다.
根据用户提供的当前位置查找附近公共停车场。
- 不自动推测位置。
- 必须先询问当前位置。
- 默认仅显示公共停车场。
- 使用官方「全国停车场信息标准数据」Open API。
- 将位置字符串通过Kakao Map锚点搜索获取坐标后，在官方停车场数据中按距离排序整理。
- 官方标准数据中不包含实时满位/剩余车位/可预约情况，因此不得给出确定表述。
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:
http://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>
- 标准数据介绍：
https://www.data.go.kr/data/15012896/standard.do - Open API介绍：
https://www.data.go.kr/data/15012896/openapi.do - Open API端点：
http://api.data.go.kr/openapi/tn_pubr_prkplce_info_api - k-skill代理：
/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
工作流程
- 유저에게 반드시 현재 위치를 묻는다.
- 위치 문자열을 받으면 Kakao Map으로 anchor 후보를 고르고 좌표를 확보한다.
- anchor 주소에서 address hint를 만든다.
시도 + 시군구 - k-skill-proxy 또는
/v1/parking-lots/search패키지로 공식 주차장 데이터를 조회한다.parking-lot-search - 보통 3~5개만 짧게 정리하고, 지도 링크를 같이 준다.
- 요금/운영시간은 데이터 기준일자와 함께 안내하고, 실시간 현황이 아님을 밝힌다.
- 必须先询问用户当前位置。
- 收到位置字符串后，通过Kakao Map选择锚点候选并获取坐标。
- 根据锚点地址生成地址提示。
道/市 + 区/郡 - 通过k-skill-proxy的或
/v1/parking-lots/search包查询官方停车场数据。parking-lot-search - 通常仅整理3~5个结果，并附上地图链接。
- 告知费用/运营时间时需同时说明数据基准日期，并明确告知这并非实时状态。
Responding
回复内容
결과는 보통 아래 필드를 포함해 짧게 정리한다.
- 주차장명
- 거리
- 공영/민영 및 노상/노외/부설 유형
- 주소
- 운영요일/운영시간
- 요금정보, 기본요금, 추가요금
- 주차구획수
- 전화번호/관리기관
- 데이터기준일자
- 지도 링크
结果通常需包含以下字段并简洁整理：
- 停车场名称
- 距离
- 公共/民营及路内/路外/附属类型
- 地址
- 运营周数/运营时间
- 费用信息、基础费用、额外费用
- 停车位数量
- 电话号码/管理机构
- 数据基准日期
- 地图链接
Node.js example
Node.js示例
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;
});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;
});모두의주차장 status
全民停车场状态
Issue #135에서 모두의주차장 연동 가능성을 언급했지만, v1은 공식 공공데이터 기반으로 시작한다. 승인된 공식/파트너 API 계약이 확인되기 전에는 모두의주차장 비공식 API 호출이나 scraping을 하지 않는다.
在Issue #135中提到了与全民停车场联动的可能性，但v1版本将基于官方公共数据启动。在确认获得官方/合作伙伴API授权前，不得调用全民停车场的非官方API或进行数据爬取。
Done when
完成标准
- 유저의 현재 위치를 먼저 확인했다.
- 공식 데이터 기반으로 최소 1개 이상 nearby parking lot을 찾았거나, 못 찾은 이유와 다음 질문을 제시했다.
- 가장 가까운 결과를 3~5개 이내로 정리했다.
- 실시간 잔여면/예약 가능 여부가 아님을 필요한 경우 명확히 했다.
- 已先确认用户的当前位置。
- 基于官方数据找到至少1个附近停车场，或告知未找到的原因并提出后续问题。
- 将最近的结果整理在3~5个以内。
- 必要时明确说明这并非实时剩余车位/可预约状态。