kakao-bar-nearby

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Kakao Bar Nearby

What this skill does

功能说明

유저가 알려준 현재 위치를 기준으로 카카오맵 기준 근처 술집을 찾아준다.

위치는 자동으로 추정하지 않는다.
반드시 먼저 현재 위치를 질문한다.
```
서울역
```
,
```
강남
```
,
```
사당
```
,
```
신논현
```
,
```
논현
```
같은 역명/동네/랜드마크 질의를 그대로 받을 수 있다.
결과에는 현재 영업 상태, 대표 메뉴, 좌석 옵션(단체석/바테이블 등), 전화번호를 포함한다.

根据用户提供的当前位置，查找Kakao Map上的附近酒吧。

不会自动估算位置。
必须首先询问用户当前位置。
支持直接接收
```
首尔站
```
、
```
江南
```
、
```
舍堂
```
、
```
新论岘
```
、
```
论岘
```
这类站名/小区名/地标类查询。
搜索结果包含当前营业状态、招牌菜单、座位选项（团体座/吧台等）、电话号码。

When to use

适用场景

"서울역 근처 술집 찾아줘"
"강남에서 지금 영업중인 와인바 뭐 있어?"
"논현 근처 4명 갈만한 술집 알려줘"
"사당에서 전화번호 있는 이자카야 몇 군데만 보여줘"

"帮我找首尔站附近的酒吧"
"江南现在正在营业的酒吧有哪些？"
"告诉我论岘附近适合4个人去的酒吧"
"给我看几个舍堂有联系电话的居酒屋"

Mandatory first question

强制首问要求

위치 정보 없이 바로 검색하지 말고 반드시 먼저 물어본다.

권장 질문:

현재 위치를 알려주세요. 서울역/강남/사당 같은 역명이나 동네명으로 보내주시면 카카오맵 기준 근처 술집을 찾아볼게요.

위치가 애매하면:

가까운 역명이나 동 이름으로 한 번만 더 알려주세요.

没有位置信息时不要直接搜索，必须首先询问用户。

推荐提问话术：

请告知您的当前位置。如果您提供首尔站/江南/舍堂这类站名或者小区名，我会为您查找Kakao Map上的附近酒吧。

如果位置模糊：

请您再告知一下附近的站名或者小区名哦。

Official Kakao Map surfaces

Kakao Map官方接口

모바일 검색:

https://m.map.kakao.com/actions/searchView?q=<query>

장소 패널 JSON:

https://place-api.map.kakao.com/places/panel3/<confirmId>

장소 상세 페이지:
```
https://place.map.kakao.com/<confirmId>
```

移动端搜索：

https://m.map.kakao.com/actions/searchView?q=<query>

地点面板JSON：

https://place-api.map.kakao.com/places/panel3/<confirmId>

地点详情页：
```
https://place.map.kakao.com/<confirmId>
```

Workflow

工作流程

유저에게 반드시 현재 위치를 묻는다.
받은 위치 문자열을 카카오맵 검색으로 anchor 후보(역/랜드마크)로 해석한다.
같은 위치 문자열에
```
술집
```
키워드를 붙여 nearby 술집 검색 결과를 가져온다.
상위 후보의 panel3 JSON 을 조회해 현재 영업 상태, 메뉴, 좌석 옵션, 전화번호를 정규화한다.
영업 중인 술집을 먼저 보여주고, 필요하면 곧 열 곳도 함께 보여준다.

必须首先询问用户的当前位置。
将接收到的位置字符串通过Kakao Map搜索解析为锚点候选（站点/地标）。
给相同的位置字符串加上
```
酒吧
```
关键词，获取附近酒吧的搜索结果。
调用排名靠前的候选的panel3 JSON接口，整理出当前营业状态、菜单、座位选项、电话号码。
优先展示正在营业的酒吧，如果有需要可以同时展示即将营业的店铺。

Responding

回复要求

보통 3~5개만 짧게 정리한다.

술집명
카테고리
영업 상태 (
```
영업 중
```
,
```
영업 전
```
,
```
휴무일
```
등)
대표 메뉴 2~3개
좌석/인원 수용 힌트 (
```
단체석
```
,
```
바테이블
```
등)
전화번호
거리(가능하면)

通常只需简短整理3~5个结果即可。

酒吧名称
类别
营业状态（
```
营业中
```
、
```
营业前
```
、
```
休息日
```
等）
2~3道招牌菜单
座位/容纳人数提示（
```
团体座
```
、
```
吧台
```
等）
电话号码
距离（如果有）

Node.js example

Node.js示例

const { searchNearbyBarsByLocationQuery } = require("kakao-bar-nearby");

async function main() {
  const result = await searchNearbyBarsByLocationQuery("서울역", {
    limit: 5
  });

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

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

const { searchNearbyBarsByLocationQuery } = require("kakao-bar-nearby");

async function main() {
  const result = await searchNearbyBarsByLocationQuery("서울역", {
    limit: 5
  });

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

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

Done when

完成条件

유저의 현재 위치를 먼저 확인했다.
카카오맵 기준 술집 결과를 최소 1개 이상 찾았거나, 찾지 못한 이유와 다음 질문을 제시했다.
영업 상태/메뉴/좌석 옵션/전화번호가 포함된 요약을 보여줬다.

已首先确认用户的当前位置。
已找到至少1个Kakao Map上的酒吧结果，或者说明了找不到的原因并给出后续询问引导。
已展示包含营业状态/菜单/座位选项/电话号码的摘要信息。

const { searchNearbyBarsByLocationQuery } = require("kakao-bar-nearby"); async function main() { const result = await searchNearbyBarsByLocationQuery("서울역", { limit: 5 }); console.log(result.anchor); console.log(result.items); } main().catch((error) => { console.error(error); process.exitCode = 1; });