baidu-map

# 百度地图 (Baidu Map)

本技能使用百度地图 Web 服务 API 提供丰富的地理位置服务。

**重要：** 使用本技能前，你必须在百度地图开放平台申请一个应用，并获取 Access Key (AK)，然后将其设置为环境变量 `BAIDU_MAP_AK`。

```bash
export BAIDU_MAP_AK="你的百度地图Access Key"
```

Clawdbot 会自动读取这个环境变量来调用 API。

## 何时使用 (触发条件)

当用户提出以下类型的请求时，应优先使用本技能：
- "帮我查一下[城市]的天气"
- "搜索[地点]附近的[东西]"
- "查找[关键词]的位置"
- "从[A]到[B]怎么走？"
- "查询[地址]的经纬度"
- "这个坐标[经度,纬度]是哪里？"
- "百度地图[地点]"

## 核心功能与用法

### 1. 地点搜索 (POI检索)

用于根据关键字在指定区域搜索地点信息。

```bash
# 将 [关键词] 替换为用户提供的内容
# region参数可以是城市名或区域名
curl "https://api.map.baidu.com/place/v2/search?query=[关键词]&region=全国&output=json&ak=$BAIDU_MAP_AK"

# 或者指定具体城市
curl "https://api.map.baidu.com/place/v2/search?query=[关键词]&region=广州&output=json&ak=$BAIDU_MAP_AK"
```

### 2. 城市内地点搜索

用于在特定城市内搜索地点，结果更精确。

```bash
# 将 [关键词] 和 [城市] 替换为实际内容
curl "https://api.map.baidu.com/place/v2/search?query=[关键词]&region=[城市]&output=json&ak=$BAIDU_MAP_AK"
```

### 3. 周边搜索 (圆形区域内搜索)

用于在指定坐标点周围搜索特定类型的地点。

```bash
# 将 [经度,纬度] 替换为实际坐标，radius为搜索半径(米)
curl "https://api.map.baidu.com/place/v2/search?query=花店&location=[纬度],[经度]&radius=1000&output=json&ak=$BAIDU_MAP_AK"
```

### 4. 地理编码 (地址 → 坐标)

将结构化的地址信息转换为经纬度坐标。

```bash
# 将 [地址] 替换为用户提供的地址
curl "https://api.map.baidu.com/geocoding/v3/?address=[地址]&output=json&ak=$BAIDU_MAP_AK"
```

### 5. 逆地理编码 (坐标 → 地址)

将经纬度坐标转换为结构化的地址信息。

```bash
# 将 [经度,纬度] 替换为实际坐标
curl "https://api.map.baidu.com/reverse_geocoding/v3/?coordtype=wgs84ll&location=[纬度],[经度]&output=json&ak=$BAIDU_MAP_AK"
```

### 6. 驾车路线规划

用于规划两个地点之间的驾车路线。

```bash
# 将 [起点] 和 [终点] 替换为实际地址或坐标
#...

# 百度地图技能包

这是一个为 OpenClaw 设计的百度地图集成技能包，提供完整的地理位置服务功能。

## 功能特性

- **地点搜索**: 支持关键词搜索、城市内搜索、周边搜索
- **地理编码**: 地址转坐标、坐标转地址（逆地理编码）
- **路线规划**: 驾车、步行、公交路线规划
- **行政区划**: 边界查询、区域信息获取
- **IP定位**: 基于IP地址的地理位置获取

## 安装要求

- OpenClaw 系统
- `curl` 命令行工具
- 百度地图开放平台 Access Key (AK)

## 配置

1. 在百度地图开放平台注册并创建应用，获取 Access Key (AK)
2. 设置环境变量：

```bash
export BAIDU_MAP_AK="你的百度地图Access Key"
```

## 使用方法

安装后，系统将能够自动使用百度地图API处理地理位置相关的请求。

## API限制

请注意百度地图API有调用次数限制，具体限制取决于你的应用配置。

## 许可证

MIT License