tencent-map

# 腾讯地图API技能

集成腾讯地图Web服务API，提供地点搜索、路线规划、逆地理编码等功能。

## 设置

1. 在[腾讯位置服务控制台](https://lbs.qq.com/dev/console/application/)申请密钥
2. 设置环境变量：
   ```bash
   export TENCENT_MAP_KEY="YOUR_TENCENT_MAP_KEY"
   ```

## 功能

### 1. 地点搜索 (search)
搜索指定关键词的地点信息

```bash
# 基础搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州"

# 带分页搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州" 1 20

# 指定区域搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州天河区"
```

### 2. 逆地理编码 (reverse_geocode)
根据经纬度获取详细地址信息

```bash
bash {baseDir}/scripts/tencent_map.sh reverse_geocode 23.129405 113.264287
```

### 3. 地理编码 (geocode)
根据地址获取经纬度坐标

```bash
bash {baseDir}/scripts/tencent_map.sh geocode "广州市天河区珠江新城"
```

### 4. 路线规划 (route)
计算两点间的路线信息

```bash
bash {baseDir}/scripts/tencent_map.sh route "起点地址" "终点地址" "driving|walking|transit"
```

### 5. 周边搜索 (around)
搜索指定坐标周围的POI

```bash
bash {baseDir}/scripts/tencent_map.sh around 23.129405 113.264287 "花店" 3000
```

## 参数

- **search**: `keyword`, `region`, `page_index`, `page_size`
- **reverse_geocode**: `latitude`, `longitude`
- **geocode**: `address`
- **route**: `from`, `to`, `mode`
- **around**: `latitude`, `longitude`, `keyword`, `radius`

## 返回格式

所有命令均返回标准化的JSON格式，包含状态、结果和错误信息。

## 限制

- 每日调用次数限制根据腾讯地图API套餐而定
- 搜索结果最多返回20条/页
- 需要有效的腾讯地图API密钥

# 腾讯地图API技能

这是一个集成腾讯地图Web服务API的OpenClaw技能，提供地点搜索、逆地理编码、地理编码、路线规划等功能。

## 功能特性

- **地点搜索**: 按关键词搜索地点信息
- **逆地理编码**: 根据经纬度获取地址详情
- **地理编码**: 根据地址获取经纬度坐标
- **周边搜索**: 搜索指定坐标周围的POI
- **标准化输出**: 所有结果统一为结构化JSON格式

## 安装

1. 将此技能文件夹复制到OpenClaw的skills目录
2. 确保系统已安装`curl`和`python3`
3. 从[腾讯位置服务](https://lbs.qq.com/dev/console/application/)获取API密钥

## 配置

设置环境变量：

```bash
export TENCENT_MAP_KEY="YOUR_TENCENT_MAP_KEY"
```

## 使用示例

### 搜索花店
```bash
# 搜索广州地区的花店
bash /path/to/tencent_map.sh search "花店" "广州"

# 搜索天河区的花店，第一页，每页20个结果
bash /path/to/tencent_map.sh search "花店" "广州天河区" 1 20
```

### 逆地理编码
```bash
# 获取指定坐标的地址信息
bash /path/to/tencent_map.sh reverse_geocode 23.129405 113.264287
```

### 地理编码
```bash
# 获取地址的坐标
bash /path/to/tencent_map.sh geocode "广州市天河区珠江新城"
```

### 周边搜索
```bash
# 搜索指定坐标周围3公里内的花店
bash /path/to/tencent_map.sh around 23.129405 113.264287 "花店" 3000
```

## 输出格式

所有命令返回标准化JSON格式：

```json
{
  "status": 0,
  "message": "success",
  "pois": [
    {
      "id": "poi_id",
      "title": "地点名称",
      "address": "详细地址",
      "category": "类别",
      "tel": "电话号码",
      "location": {
        "lat": 23.129405,
        "lng": 113.264287
      },
      "overall_rating": 4.5
    }
  ],
  "count": 10
}
```

## 注意事项

- 需要有效的腾讯地图API密钥
- API调用受腾讯地图服务条款限制
- 请遵守每日调用次数限制