gaode_map

# Gaode Map Skill

This skill allows you to search for places and plan routes using Gaode Map (AMap) API.

## Usage

You can use the `amap_tool.py` script to perform actions. The API Key is expected to be in the `AMAP_API_KEY` environment variable.

### Place Search
Search for POIs (Points of Interest).

**Command:**
```bash
python amap_tool.py search --keywords "<keywords>" [--city "<city>"]
```

**Parameters:**
- `keywords`: The search query (e.g., "restaurants", "gas station").
- `city`: (Optional) The city to search in.

### Route Planning
Plan a route between two locations.

**Command:**
```bash
python amap_tool.py route --origin "<origin>" --destination "<destination>" [--mode "<mode>"] [--city "<city>"]
```

**Parameters:**
- `origin`: Start location (address or coordinates "lon,lat").
- `destination`: End location (address or coordinates "lon,lat").
- `mode`: (Optional) Route mode: `driving` (default), `walking`, `bicycling`, `transit`.
- `city`: (Optional) City name (required for `transit` mode, or to help geocoding).

## Examples

**User:** "Find coffee shops in Shanghai."
**Action:**
```bash
python amap_tool.py search --keywords "coffee shop" --city "Shanghai"
```

**User:** "Show me the driving route from Beijing West Station to the Forbidden City."
**Action:**
```bash
python amap_tool.py route --origin "Beijing West Station" --destination "Forbidden City" --mode "driving" --city "Beijing"
```

# Gaode Map (AMap) Skill for OpenClaw

This is an OpenClaw skill that integrates with the Gaode Map (AMap) API to provide location services.

## Features

- **Place Search**: Search for places/POIs by keywords.
- **Route Planning**: Plan routes for driving, walking, bicycling, and public transit.
- **Geocoding**: Automatically converts addresses to coordinates.

## Installation

1. Clone this repository into your OpenClaw skills directory (e.g., `~/.openclaw/skills/gaode_map`).
2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

## Configuration

You need a Gaode Map API Key. Get one from [AMap Console](https://console.amap.com/).

Set the environment variable `AMAP_API_KEY` in your OpenClaw configuration or environment.

## Usage

This skill exposes a Python script `amap_tool.py` that the agent can use.

### Commands

- **Search**: `python amap_tool.py search --keywords "..." --city "..."`
- **Route**: `python amap_tool.py route --origin "..." --destination "..." --mode "..."`

## Structure

- `SKILL.md`: The skill definition and instructions for OpenClaw.
- `amap_tool.py`: The implementation of the API client.
- `requirements.txt`: Python dependencies.