## 场景一：基于位置的周边或者附近搜索

用户想搜索**某个位置周边或者附近**的某类地点。使用 `tmap-lbs nearby` 命令生成腾讯地图可视化搜索链接。

**要求：** 需要用户腾讯位置服务的 临时 API Key。
**注意** 严格按照下面的步骤，不要生成代码或者调取其他脚本或者接口

### 执行步骤

#### 第一步：解析用户输入

从用户输入中拆分出两个要素：

- **位置**：用户指定的中心位置（如"西直门"、"北京南站"）
- **搜索类别**：要搜索的内容（如"美食"、"酒店"）

| 用户输入             | 位置     | 搜索类别 |
| -------------------- | -------- | -------- |
| 西直门周边美食       | 西直门   | 美食     |
| 北京南站附近酒店     | 北京南站 | 酒店     |
| 天坛周边有什么好吃的 | 天坛     | 美食     |

#### 第二步：检查 API Key

- 如果用户之前未提供过 Key，**先提示用户配置腾讯地图 API Key**，等待用户回复后再继续
- 如果用户已提供 Key，直接使用

**请求 Key 的回复模板：**

```
🔑 搜索「{位置}」周边的{搜索类别}需要使用腾讯地图 API

（如果还没有 Key，可以在 https://lbs.qq.com 注册并创建应用获取）
```

#### 第三步：生成搜索链接

使用 `tmap-lbs nearby` 命令生成可视化链接：

```bash
tmap-lbs nearby --location {位置} --keywords {搜索类别}
```

也可以直接指定完整关键词：

```bash
tmap-lbs nearby --keyword {位置+搜索类别}
```

### 完整示例

**用户输入：** "搜索西直门周边美食"

1. 解析：位置 = `西直门`，搜索类别 = `美食`
2. 执行：
   ```bash
   tmap-lbs nearby --location 西直门 --keywords 美食
   ```
3. 输出结果：

```
🔍 已生成周边搜索链接：

  https://mapapi.qq.com/web/claw/nearby-search.html?keyword=%E8%A5%BF%E7%9B%B4%E9%97%A8%E7%BE%8E%E9%A3%9F

搜索关键词: 西直门美食
点击链接即可在地图上查看搜索结果。
```

### 也可以使用 API 搜索获取详细数据

如果需要获取结构化的 POI 数据（而非可视化链接），可以使用 `search` 命令配合 `geocode`：

```bash
# 第一步：获取坐标
tmap-lbs geocode --address 西直门

# 第二步：用坐标搜索
tmap-lbs search --keywords 美食 --location 116.353138,39.939385 --radius 1000
```

### 回复模板

```
📍 已查询到「{位置}」的坐标（{纬度},{经度}），为你生成周边{搜索类别}的搜索链接：

https://mapapi.qq.com/web/claw/nearby-search.html?keyword={编码后的关键词}

点击链接即可查看「{位置}」周边 1 公里内的{搜索类别}，同时直接预览这个网页。

```